TikTok Events API

What Is TikTok Events API

TikTok Events API is TikTok's server-side tracking solution. It lets you send conversion events from your server directly to TikTok Ads Manager, bypassing browser-based limitations like ad blockers, cookie restrictions, and intelligent tracking prevention.

PixelsCleared forwards scrubbed, consent-verified events to TikTok Events API so your TikTok ad campaigns receive accurate conversion data without exposing visitor data to third-party scripts in the browser.

Credentials You Need

TikTok Events API requires two pieces of information:

• TikTok Pixel ID -- The identifier for your TikTok pixel (format: a long numeric string, for example, CKABCDEFGH1234567890).
• Access Token -- A server-side token that authorizes API requests (format: a long alphanumeric string).

Get Your Credentials from TikTok Ads Manager

1. Open TikTok Ads Manager and sign in.
2. Go to Assets > Events > Manage Web Events.
3. Select your pixel from the list (or create a new one).
4. Copy the Pixel ID -- it is displayed next to the pixel name.
5. Click Settings on the pixel detail page.
6. Under Events API, click Generate Access Token.
7. Copy the token and store it securely. TikTok may not display it again after generation.

Add TikTok in PixelsCleared

1. Open the PixelsCleared dashboard.
2. Go to Gateway > Destinations.
3. Click Add Destination and select TikTok Events API.
4. Paste your Pixel ID and Access Token into the corresponding fields.
5. Choose which event types to forward (for example, PageView, ClickButton, SubmitForm, CompletePayment, Contact).
6. Click Save.

PixelsCleared validates the credentials by sending a test request to TikTok's API. If the connection succeeds, you will see a green confirmation. If it fails, verify that the Pixel ID and Access Token have no extra whitespace or missing characters.

Event Matching Parameters

TikTok uses event matching to attribute server-side events to TikTok users who saw or clicked your ads. PixelsCleared includes available match parameters in every request:

• IP address -- hashed with SHA-256 before sending
• User agent -- included when consent is granted
• External ID -- a hashed identifier derived from your site's visitor session

As with all PixelsCleared destinations, email addresses, phone numbers, and other personally identifiable information are stripped by the scrubbing engine before the event reaches TikTok. This is by design for privacy compliance.

Higher match quality leads to better ad optimization. If you need improved match rates, contact PixelsCleared support to discuss approved additional matching signals.

Consent and Data Processing

PixelsCleared respects consent signals when forwarding to TikTok:

• Consent granted -- events are forwarded with full available parameters.
• Consent denied or not detected -- events are sent with minimal parameters (IP is still hashed and included for basic attribution, but user agent and other signals are withheld).

TikTok's terms of service require that you have a lawful basis to send user data. PixelsCleared handles the consent check on your behalf, but you are responsible for ensuring your privacy policy discloses TikTok as a data recipient.

Verifying Events in TikTok Ads Manager

1. Open TikTok Ads Manager and go to Assets > Events.
2. Select your pixel and click Diagnostics or Event Testing.
3. Visit your website, accept the consent banner, and trigger a tracked action.
4. Return to TikTok Ads Manager. Events should appear within a few minutes.

TikTok's diagnostics panel may show a slight delay compared to the PixelsCleared Events log. If PixelsCleared reports successful forwarding but TikTok diagnostics show no events, wait a few minutes and refresh.