Google Tag Manager, Server Side Tracking, Tiktok

How to Set Up TikTok Events API with Server GTM

TikTok ads are often the channel clients trust least. “TikTok shows sales, but I can’t see them anywhere.” Part of the reason is weak tracking: the TikTok Pixel gets blocked a lot, and many stores never add the Events API. The good news is that if you already run Meta CAPI on a server container, TikTok is about 30 minutes of extra work.

What you need

  • A server container with GA4 (or Data Tag) data flowing in
  • Your TikTok Pixel ID from TikTok Ads Manager → Assets → Events
  • A TikTok Events API access token, generated in the same Events settings page

Step by step

  1. Install the TikTok tag template. In the server container, go to Templates → Search Gallery → search “TikTok”. Stape maintains a TikTok Events API tag. Add it.
  2. Create the tag. Paste your Pixel ID and access token.
  3. Map the event names. TikTok uses its own names: ViewContent, AddToCart, InitiateCheckout, CompletePayment (purchase), SubmitForm (lead). Most templates can map GA4 names for you. Double-check purchase → CompletePayment.
  4. Send user data. Email, phone and external ID (hashed) improve matching. Pass the ttclid and the _ttp cookie so TikTok can connect the event to the ad click.
  5. Set up deduplication. Just like Meta, add the same event_id to the browser Pixel event and the server event.
  6. Trigger it. Custom trigger on the events you want, from the GA4 or Data client.
  7. Test. Use TikTok Events Manager → Test Events with your test code. Look for server events arriving and matched.

Mistakes to avoid

  • Wrong purchase event name. Sending Purchase instead of CompletePayment means TikTok will not optimise for sales.
  • No ttclid capture. If the landing page loses the URL parameter on redirect, attribution suffers. Test with a real ad click URL.
  • Token in the wrong place. Generate the token for the same Pixel you put in the tag. Mixing pixels is common in accounts with many brands.
  • Forgetting value and currency. Without them, ROAS in TikTok is empty.

From the field

A pattern I see regularly with fashion and beauty brands: TikTok budget is growing, but the Pixel alone reports far fewer purchases than the store records. Adding Events API with proper user data and deduplication typically gives the TikTok algorithm a much clearer signal, and the media buyer finally stops guessing.

Bottom line

If you have a server container, there is no reason to run TikTok on the Pixel alone. Reuse the data you already send for Meta, map the event names correctly, and test with a real click.

Source reading: Stape — TikTok Events API tag on GitHub, Try Stape

Leave a Reply

Your email address will not be published. Required fields are marked *