TikTok Pixel Helper
Last updated, August 2023

TikTok Pixel Helper is a Chrome extension that can help you verify and troubleshoot pixel installation by checking for errors and providing implementation recommendations for your website.


With Pixel Helper, you can troubleshoot pixel installation with detailed diagnostics at all levels, including pixel, event, and parameter implementation.


Pixel Helper 2.1.0 is available as of February 9, 2023. Download Pixel Helper here.


https://lf16-cognition-tos.ibytedtos.com/obj/cognition-sg-public/thumbnail_702d5ec29e6c4549b9892a76b6b3f718_jpg.jpg

Detailed Pixel Helper Errors & Suggestions

The following errors and suggestions are available with Pixel Helper.



Setup mode (Event Builder vs Custom Code)

Pixel Helper Suggestion

Error Type

Trigger

Pixel level

Both

The pixel code is not installed in your webpage header. This could prevent your pixel from loading. Please place the pixel code as early as possible in the webpage, ideally between the <head> </head> tags.

Pixel code is not installed in header

Pixel code is not installed in header

Pixel level

Both

The pixel ID is invalid. This could prevent your pixel from receiving data. Please go to Events Manager and find the correct pixel ID.

Invalid Pixel ID

Pixel ID could not be found in our system

Pixel level

Both

Cookie Info- turn on first-party cookies in Events Manager settings

First-Party Cookies Not Found

First Party Cookies are not enabled

Event Level

Custom

The event name for one or more of your events is missing. This could impact your ad performance. Go to your source code and include the event name(s).

Event name/type is empty

If the event name/type is empty

Event Level

Custom

The event name for one or more of your events is invalid. This could impact your ad performance. Go to your source code and update your event(s).

Event name/type is invalid

If the event name/type is not supported

Parameter level

Custom

The email format for one or more of your events does not match the format supported. This could impact Advanced Matching and your ad performance. Go to your source code and update the email parameter(s) for the "{{event}}" event to the supported format.

Email format invalid

Email format does not match the standard format (lower case). The data advertiser sent back will go through formatting and will be hashed if not done previously.

Parameter level

Custom

The phone number format for one or more of your events does not match the E.164 format. This could impact Advanced Matching and your ad performance. Go to your source code and update the phone number parameter(s) for the "{{event}}" event to the supported format.

Phone num format invalid

Phone num format (E164) does not match the standard format.

Parameter level

Custom

The email or phone number parameters for complete payment event are not being received which could impact your ad performance. Check Advanced Matching parameters displayed to see which parameter is missing. Go to your source code and include the missing parameter to improve your coverage.

Missing email or phone number parameter for complete payment event

If advanced matching parameter is set but no email and phone number are received

Parameter level

Custom

The value parameter for one or more of your events is invalid. The 'value' format must be either integer (e.g. 100) or follow the decimal number format (e.g. 12.34), which cannot contain currency signs, special characters, letters or commas. This can impact bids for the highest value customers.

Value parameter format invalid.

The value field must contain a number greater than or equal to zero, and may not include letters, special characters, currency symbols or commas.

Parameter level

Custom

The currency or value parameter for one or more of your events is missing. This could impact your ad performance. Go to your source code and include the currency or value parameter(s) for the "{{event}}" event.

Currency/Value parameter missing

If value parameter is set but not currency, vice versa.

Parameter level

Custom

The currency code for one or more of your events does not match a supported currency code. This could impact the return on ad spend calculation. Go to your source code and update the currency parameter(s) for the "{{event}}" event to a supported currency code.

Currency code invalid/not supported

Currency code does not match a currency code supported

Parameter level

Custom

The content ID received contains no value. Go to your source code and include value for content ID.

Content ID value missing

If content parameter is set but no value is being passed.

Parameter level

Custom

The content ID parameter has not been received. It is recommended to go to your source code and include the "content id" parameter.

Missing content ID parameter

If there is no content id being received

Parameter level

Custom

The content type for one or more of your events is invalid. Content type must be either "product" or "product_group". Go to your source code and update the content type.

Content Type invalid

Must be either product or product_group.


Content