TikTok Events API - Troubleshooting Guide

De TikTok Events API Check analyseert of je events correct worden doorgestuurd naar TikTok via de server-side Events API. Dit is essentieel voor:

• Accurate conversie tracking ondanks iOS/browser privacy beperkingen

• Betere ad optimalisatie door TikTok's algoritme

• Verbeterde ROAS berekening met betrouwbare data

Dit is de #1 TikTok error! (~90% van alle TikTok errors)

HTTP Status: 401 Unauthorized

Oorzaken:

1. Token is verlopen

   • TikTok Access Tokens verlopen na 1 jaar

   • Anders dan Meta System User tokens (die niet verlopen)

2. Token is ingetrokken

   • Handmatig ingetrokken in TikTok Events Manager

   • Account/app permissions gewijzigd

3. Verkeerde token gebruikt

   • Token van een andere Pixel

   • Test token i.p.v. productie token

Oplossing:

1. Ga naar TikTok Events Manager

2. Selecteer je Pixel (Dataset)

3. Klik op Settings → Access Tokens

4. Genereer een nieuwe Access Token

5. Update de token in TryTagging:

   • Tags → TikTok Events API

   • Plak de nieuwe Access Token

⚠️ Pro Tip: Zet een reminder voor 11 maanden om de token te vernieuwen!

HTTP Status: 400 Bad Request

Oorzaak: De Access Token is niet geconfigureerd of niet correct doorgegeven.

Oplossing:

1. Controleer TryTagging configuratie:

   • Tags → TikTok Events API

   • Verifieer dat het Access Token veld is ingevuld

2. Check voor lege variabele:

   • Als je een variabele gebruikt: {{tiktok_token}}

   • Controleer of deze variabele een waarde heeft

3. Test de configuratie:

   • Voer een test event uit

   • Check in TikTok Events Manager of het binnenkomt

Oorzaak: De Pixel Code (ook wel "Pixel ID" genoemd) is incorrect.

Hoe vind je je Pixel Code?

1. Ga naar TikTok Events Manager

2. Klik op Assets → Events

3. Selecteer je Pixel/Dataset

4. De Pixel Code staat rechtsboven (bijv. XXXXXXXXXXXXXXXX)

Oplossing in TryTagging:

1. Tags → TikTok Events API

2. Update het Pixel Code veld

3. Kopieer exact de code uit TikTok Events Manager

HTTP Status: 502 Bad Gateway / 503 Service Unavailable

Oorzaak: Tijdelijke issues aan TikTok's kant.

Kenmerken:

• Sporadisch voorkomend

• Meestal < 0.1% van requests

• Lost zichzelf op

Actie nodig?

• < 1%: Geen actie nodig

• > 1%: Neem contact op met TikTok support

TikTok verwacht specifieke event namen. Mapping:

De _ttp cookie verbetert matching significant.

• First-party cookie gezet door TikTok Pixel

• Bevat een unieke browser identifier

• Verbindt server-side events met client-side

1. TikTok Pixel base code moet op de site staan

2. Cookie wordt automatisch gezet bij eerste bezoek

3. TryTagging pikt _ttp automatisch op

In browser DevTools:

Application → Cookies → je-domein.nl → _ttp

De ttclid parameter is essentieel voor ad attributie.

• URL parameter toegevoegd door TikTok Ads

• Koppelt click aan conversie

• Formaat: ttclid=XXXXXXXXXXXXXX

https://jouw-site.nl/product?ttclid=EJqrq7uSh4oDFA...

1. Behoud ttclid in URL - strip hem niet

2. Pass naar server - zorg dat backend hem ontvangt

3. Stuur mee in Events API - als ttclid parameter

1. Noteer de vervaldatum bij genereren

2. Zet een reminder voor 11 maanden

3. Test na vernieuwing met een test event

4. Documenteer welke token waar gebruikt wordt

1. TikTok Events Manager → je Pixel

2. Settings → Access Tokens

3. Klik op Generate Access Token

4. Kopieer nieuwe token

5. Update in TryTagging

6. Test met een event

1. Ga naar Events Manager → je Pixel

2. Klik op Test Events tab

3. Selecteer Server API Testing

4. Voer een test event uit op je site

5. Controleer of het event binnenkomt

1. Container → Monitoring

2. Filter: platform = Tiktok

3. Bekijk request/response details

4. Check error messages en codes

• [ ] Pixel Code correct (uit Events Manager)

• [ ] Access Token gegenereerd (verloopt over 1 jaar)

• [ ] Event namen correct gemapped

• [ ] event_id wordt meegestuurd

• [ ] Email gehashed (SHA-256)

• [ ] _ttp cookie wordt uitgelezen

• [ ] ttclid parameter wordt doorgegeven

• [ ] IP adres (niet gehashed!)

• [ ] User Agent

• [ ] Currency bij purchase events

• [ ] Value als number

• [ ] Content IDs correct

• [ ] Token vervaldatum genoteerd

• [ ] Reminder gezet voor vernieuwing

• [ ] Test events werkend

1 jaar. Plan een reminder om de token te vernieuwen.

Ja. TikTok verwacht SHA-256 gehashte email (lowercase, geen spaties).

• Pixel Code: Identificeert je pixel (publiek, in URLs zichtbaar)

• Access Token: Authenticatie (geheim, niet delen!)

1. Check of Pixel Code correct is

2. Verifieer Access Token (niet verlopen?)

3. Controleer event namen (TikTok format)

4. Bekijk error responses in TryTagging Monitoring