TIKTOK

TikTok Events API Integration

Send server-side events to TikTok for improved ad measurement and campaign optimization.

Overview

TikTok Events API enables server-to-server event transmission for TikTok Ads attribution. Scout sends conversion events directly to TikTok, improving measurement accuracy beyond browser-based pixel tracking.

Scout captures events and TikTok click identifiers (ttclid), hashes user data, and sends events to TikTok Events API. Events are deduplicated using event_id matching with the TikTok Pixel.

Requirements

1
TikTok Pixel ID
2
Events API Access Token (TikTok Business Center > Assets > Events)
3
A store with Scout active

Event Mapping

Scout events are transformed to TikTok standard events:

Scout Event
TikTok Event
Purchase
CompletePayment
AddToCart
AddToCart
ViewContent
ViewContent
InitiateCheckout
InitiateCheckout
Search
Search
Signup
CompleteRegistration

Click ID Tracking

Scout automatically captures ttclid from landing page URLs and stores it in the user session. This enables click-to-conversion attribution for TikTok Ads campaigns.

Data Processing

Scout hashes email and phone using SHA-256 before sending to TikTok. IP address and user agent are forwarded for advanced matching.

Troubleshooting

Events not appearing in TikTok Events Manager

Check access token permissions. Use TikTok Test Events tool to verify. Events may take a few minutes to appear.

Low match rate

Include email or phone with events for higher match rates. ttclid provides the best attribution accuracy.