About Web Diagnostics
Last updated, August 2023

Events Manager has a number of tools to help you verify your integration and web events setup. The diagnostics tab in Events Manager helps you troubleshoot common issues and improve pixel performance by fixing errors and implementing the recommended solutions. While change log allows you to verify and evaluate any previous changes made to your setup.


How to access Web Diagnostics

In TikTok Ads Manager, navigate to “Events Manager” by clicking the Assets tab, Event and then Manage Web Events. Select your Pixel or Events API connection to reach the details page which you will see four tabs:

  • Overview

  • Test Events

  • Diagnostics

  • Change Log

This article walks through the diagnostics tab. Learn more about Overview, Test Events and Change Log tabs here.

access Web Diagnostics jpg

Diagnostics will display active issues with your current setup. There are two options when evaluating issues:

  1. Resolve the issue: Pixel issues are detected from the previous 24hr period. If you see any active issues, you can read the description to understand and troubleshoot them on your own or email the issues to your team to fix them before your campaign performance is impacted.

  2. Dismiss the issue: Dismiss any active issues by clicking the 'dismiss' button if no online campaigns are being affected.


Diagnostics Error Messages and Suggestions

Error messages displayed for events setup using TikTok Pixel: Custom Code, Events API or TikTok's Event Builder tool:

Event Builder vs Custom code vs Events API

Title

Error message

Suggestion

Event Builder, TikTok Pixel: Custom code

Missing Event Name

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 Builder, TikTok Pixel: Custom code

Invalid Event Type for Custom Event

Event names were rejected for not following TikTok format requirements. You can get a full list of these event types by email.

Go to your source code and update these event types according to TikTok format requirements.

Event Builder, TikTok Pixel: Custom code

Invalid Event Type foe Standard Event

Event names were rejected for not following TikTok format requirements. You can get a full list of these event types by email.

Go to your source code and update these event types according to TikTok format requirements.

Event Builder, TikTok Pixel: Custom code

Long Event Type Name

{{num}} event types exceed the 50 character limit. You can get the full list of these event types by email.

Go to your source code and make these event names 50 characters or less.

Event Builder, TikTok Pixel: Custom code

Illegal Event Type Name

{{num}} event types were rejected due to content that violates TikTok policies. This data won't be saved by TikTok. You can get the full list of these event types by email.

Update your event types according to our TikTok policies.

TikTok Pixel: Custom Code

Invalid value parameter

Invalid "{{event}}" value parameter

The 'value' parameter for one or more of your events is invalid. It must be an integer or in the decimal format. Also, it can't contain currency symbols, special characters, letters, or commas (ex: 9.99). This can impact bids for the highest value customers.

Go to your source code and update the value parameter(s) for the "{{event}}" event to only contain numbers greater than or equal to zero.

TikTok Pixel: Custom Code

Invalid currency code

Invalid "{{event}}" currency code

The currency code for one or more of your events does not match a currency code supported. This can affect the accuracy of reporting for your return on ad spend.

Go to your source code and update the currency parameter(s) to the supported currency code for the following event(s): {{event}}

Go to your source code and update the currency parameter(s) for the "{{event}}" event to a supported currency code.

TikTok Pixel: Custom Code

Missing 'value' parameter

Events shared are missing a "value" parameter. This can impact bids for the highest value customers.

Go to your source code and include the "value" parameter.

TikTok Pixel: Custom Code

Missing 'currency' parameter

Events shared are missing a "currency" parameter. This impacts our ability to receive the value amount correctly, which can affect the accuracy of reporting for your return on ad spend.

Go to your source code and include the "currency" parameter. You can check supported currency codes. {{learn_more}}

TikTok Pixel: Custom Code

Invalid "{{event}}" content type

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.

TikTok Pixel: Custom Code

Invalid "{{event}}" email format

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.

TikTok Pixel: Custom Code

Invalid "{{event}}" phone number format

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 parameters for the "{{event}}" event to the supported format.

TikTok Pixel: Custom Code

Invalid "{{event}}" currency code

The currency code for one or more of your events does not match the currency codes supported. This could impact the calculation of return on ad spend.

Go to your source code and update the currency parameter(s) for the "{{event}}" event to a supported currency code.

TikTok Pixel: Custom Code

Missing email or phone number parameter

The advanced matching parameter (email or phone number) for one or more of your events is missing. This could impact your ad performance.

Check the advanced matching parameters displayed to see which parameter is missing. Go to your source code and include the missing parameter.

TikTok Pixel: Custom Code, Events API

Invalid URL parameter

The page URL parameter is invalid. URL must begin with http:// or https://

Go to your source code and adjust your page URL parameter.

Events API

Invalid click ID

The click ID in the payload is invalid.

Go to your source code and check the implementation of your click ID for your event (s): {{event}}

Events API

Missing IP address and user agent combination

IP address and user agent must both be sent.

Go to your source code and include both the IP address and user agent in your payload.


Learn More About


Content