Stape
Contact met salesProbeer gratis

Hoe TikTok Events API instellen

Ira Holubovska

Ira Holubovska

Author
Bijgewerkt
25 jul. 2025
Gepubliceerd
28 aug. 2021
Ook beschikbaar in

TikTok is de populairste social media-app met meer dan 1 miljard maandelijkse actieve gebruikers.Daarom besluiten de meeste marketeers om het in hun advertentiestrategieën op te nemen.

Mensen gebruiken TikTok meer dan waar dan ook op hun mobiele telefoons. Een tijdje geleden sprak alleen Facebook over de recente privacy-updates van Apple. Maar deze keer zullen de nieuwe iOS-trackingbeperkingen ook van toepassing zijn op TikTok-advertenties. Vanwege de iOS-beperking omvatten TikTok aangepaste doelgroepen en evenementen geen mensen die zich in iOS 14 hebben afgemeld voor tracking.

Hoe kun je de TikTok-tracking nauwkeuriger maken? Het antwoord is server-side tracking. Dit artikel beschrijft hoe je de TikTok Events API kunt instellen met Google Tag Manager.

Wat is de TikTok Events API?

De TikTok Events API is een server-side integratie waarmee je website- of app-evenementen rechtstreeks van je server naar de TikTok-server kunt sturen. Het werkt vergelijkbaar met de TikTok-pixel. Je kunt de TikTok Events API gebruiken om conversie-evenementen te verzenden, aangepaste doelgroepen te verzamelen, dynamische productadvertenties te creëren en campagnes te optimaliseren.

Wat zijn de belangrijkste voordelen van de TikTok Events API?

De TikTok API-evenementen hebben dezelfde voordelen en lijken sterk op server-side trackingoplossingen van andere platforms. Bekijk onze eerdere berichten over de FB Conversions API en server-side GA4 voor meer informatie.

Hier zijn de belangrijkste voordelen van het gebruik van de TikTok Events API:

1. Nauwkeurige eventtracking. Met server-side tracking kun je meer evenementen verzamelen.De TikTok Events API is bestand tegen adblockers, ITP's (Intelligent Tracking Prevention) en andere trackingbeperkingen. Op deze manier kun je de nauwkeurigheid van de conversietracking van je campagnes vergroten. Dit geeft je een beter inzicht in welke campagnes converteren en meer verkopen opleveren.

2. Betere kwaliteit van aangepaste doelgroepen. Aangezien tracking niet wordt geblokkeerd, zullen je aangepaste doelgroepen alle gebruikers omvatten.

3. Gegevensbeveiliging. Met server-side tracking blijven de persoonlijke gegevens van je klanten veilig.

4. Privacycontroles. Houd je marketinginspanningen intact met snel evoluerende privacyvereisten die je in staat stellen om aan te passen welke gegevens je deelt en wanneer je ze deelt.

5. Verrijkte gegevens. Je kunt aanvullende gegevens naar TikTok sturen, bijvoorbeeld vanuit je CRM. Gebruik deze gegevens om een beter inzicht te krijgen in campagneprestaties of om aangepaste doelgroepen op te bouwen.

Wat zijn de belangrijkste nadelen van de TikTok Events API?

Hoewel server-side tracking een fantastische nieuwe technologie is, kent het ook zijn nadelen.

1. Ingewikkeldere integratie. SST werkt op een iets andere manier dan browser-tracking. Daarom kan het behoorlijk wat tijd kosten om het met je site te integreren. De beste manier om de TikTok Events API of ss tracking voor elk ander platform in te stellen, is via de Google Tag Manager servercontainer. Trouwens, wij kunnen helpen.

2. Het vereist een cloudserver en extra kosten. Om SST in te stellen, moet je een cloudserver configureren die je zult gebruiken om verzoeken naar verschillende datapunten te verzenden. 

3. Het is nog nieuw. De TikTok Events API is een nieuwe technologie, wat betekent dat we meer updates kunnen verwachten. Daarom moet je op de hoogte blijven van alle komende wijzigingen.

Hoe werkt de TikTok Events API?

De TikTok Events API werkt vergelijkbaar met de Facebook Conversions API. TikTok gebruikt Click ID en gebruikersgegevens om evenementen te matchen met TikTok-gebruikers. Hoe meer gebruikersgegevens je naar TikTok stuurt, hoe groter de kans om de evenementen aan hun gebruikers toe te schrijven. De TikTok Events API heeft dezelfde functies als browserevenementen. Het kan worden gebruikt om doelgroepen te creëren, conversies te meten en TikTok-algoritmes te optimaliseren.

Vanaf 28 februari 2022 ondersteunt TikTok evenement-deduplicatie. Nu kun je zowel pixel als Events API gebruiken, vergelijkbaar met Facebook CAPI. Als je evenementen zowel vanuit de browser als vanaf de server wilt verzenden, zorg er dan voor dat je event_id toevoegt.

Elke keer dat iemand op een TikTok-advertentie klikt, wordt er een Click ID (ttclid) aan de URL toegevoegd. Dit is een unieke identificatie die 30 dagen geldig is. Je kunt de TikTok click ID (ttclid) opslaan en deze terugsturen naar de TikTok Events API, wat zal helpen bij het toewijzen van evenementen aan je campagnes.

Om de matchkwaliteitsscore van TikTok API-evenementen te verhogen, kun je gebruikersgegevens verzenden, zoals e-mail, telefoonnummer, gebruikers-ID, gebruikers-IP en user-agent. Alle gebruikersinformatie moet worden omgezet naar kleine letters en worden gehasht met SHA256 aan de client-side.

Naast gebruikersgegevens kun je ook eigenschappen, objecten en evenementparameters verzenden.

Manieren om de TikTok Events API in te stellen

Er zijn twee manieren om de TikTok Events API in te stellen: via de Events API Gateway en via de server GTM.In de onderstaande sectie behandelen we beide methoden in detail.

TikTok Events API Gateway

Stape's TikTok Events API Gateway is de nieuwste en eenvoudigste oplossing voor het implementeren van de TikTok Events API. Het stelt je in staat om de complexiteit van het configureren van eventdeduplicatie over te slaan en buitensporige tijd aan tagging te voorkomen. Het stelt je in staat om gebruikersparameters en events rechtstreeks vanaf de server te verzenden, terwijl het ook meerdere Pixels in één instantie ondersteunt, zelfs over verschillende Business Manager-accounts heen.

TikTok Events API Gateway
TikTok Events API Gateway

Het werkt binnen enkele minuten — stel de TikTok Events API in zonder de noodzaak van handmatige server-side tagging implementatie. Met de TikTok eAPI Gateway kun je de nauwkeurigheid van conversietracking en attributie onmiddellijk verbeteren.

TikTok Events API via sGTM

Stape's TikTok Events API-tag stelt je in staat om website- of app-events van je server rechtstreeks naar de TikTok-server te verzenden. Je kunt aangepaste doelgroepen verzamelen, dynamische productadvertenties maken en campagnes optimaliseren.

Het vereist technische kennis voor de installatie en configuratie, inclusief het beheer van infrastructuur zoals serverhosting en permissies.

TikTok Events API Gateway
TikTok Events API Gateway

Belangrijkste kenmerken van de TikTok Events API tag setup:

  • Volledige flexibiliteit om meerdere server-side tags aan te passen en te integreren (niet alleen TikTok).
  • Maakt geavanceerde configuraties mogelijk, zoals het combineren van gegevens uit verschillende bronnen en het verrijken van eventgegevens voordat deze naar TikTok worden verzonden.
  • Nuttig voor bedrijven die al server-side Google Tag Manager gebruiken voor andere platforms zoals Meta of Google Ads.
  • Vereist doorlopend onderhoud en monitoring.

Belangrijkste kenmerken van de TikTok Events API Gateway setup:

  • Volledig gehost en beheerd door Stape.
  • Regelt automatisch server-side conversietracking en eventlevering aan TikTok.
  • Biedt betrouwbaarheid en schaalbaarheid zonder een afzonderlijke GTM-servercontainer in te stellen.
  • Minder flexibiliteit vergeleken met GTM voor aangepaste implementaties of het toevoegen van meerdere tags naast TikTok.

Vergelijkingstabel

TikTok eAPI tagTikTok eAPI Gateway
Setup complexiteitComplexere configuratie, je hebt web- en server GTM-containers nodig.Eenvoudiger in te stellen.
Mogelijkheid om server-side tracking in te stellen voor andere platformsFlexibeler, maakt instelling voor diverse platforms mogelijk.Instelling is alleen mogelijk voor TikTok.
PrijsAfhankelijk van het aantal verzoeken, bekijk de calculator voor de prijs voor je website.10$/maand per Pixel of 100$/maand voor 100 Pixels.

Welke trackingmethode moet je kiezen?

De TikTok Events API tag is het meest geschikt voor:

  • Bedrijven met interne technische expertise of toegewijde ondersteuningsteams.
  • Gevorderde gebruikers die volledige controle over hun tracking-setup willen.

De TikTok Events API Gateway is het meest geschikt voor:

  • Kleine tot middelgrote bedrijven of adverteerders die TikTok-advertenties draaien en op zoek zijn naar een snelle en efficiënte manier om server-side tracking in te schakelen.
  • Gebruikers die een kant-en-klare oplossing willen zonder diepgaande technische betrokkenheid.

Hoe de TikTok Events API Gateway instellen

Voordat je begint, zorg ervoor dat TikTok webtracking al op je site is geconfigureerd, of dit nu is geïmplementeerd via een GTM-container, rechtstreeks in de websitecode is ingebed, of is geïntegreerd via een plugin.Deze setup stelt je in staat om bestaande web-events te gebruiken.

1. Maak een TikTok Events API Gateway aan op Stape.

1.1. Maak een account aan of log in op Stape. Klik op "Create Gateway" in de TikTok-sectie.

TikTok Events API Gateway
TikTok Events API Gateway

1.2. Vul de velden in:

  • Gatewaynaam. Je kunt een willekeurige naam maken.  
  • Admin-e-mail. Deze e-mail wordt gebruikt om je TikTok Events API Gateway te beheren en kan afwijken van je Stape-account e-mail. Deze moet uniek zijn voor elke Gateway.
  • Serverlocatie. Selecteer een locatie dichter bij je websitebezoekers.

Klik op "Create TikTok Events API Gateway".

TikTok Events API Gateway
TikTok Events API Gateway

1.3. Kies een abonnement. Stape biedt:

  • 7-daagse gratis proefperiode.
  • Pay as you go-abonnement - 10$/maand per Pixel.
  • Ultimate abonnement - 100$/maand voor 100 Pixels.
TikTok Events API Gateway
TikTok Events API Gateway

1.4. Wacht tot de status van je gateway "Running" (Actief) is.

TikTok Events API Gateway
TikTok Events API Gateway

2. Verbind je Pixel.

2.1. Klik op "Finish TikTok Gateway setup". Je wordt doorgestuurd naar de login-interface van TikTok Gateway.

TikTok Events API Gateway
TikTok Events API Gateway
TikTok Events API Gateway
TikTok Events API Gateway

2.2. Klik in de Events API Gateway hub op "View details" en vervolgens op "Connect Data Source".

Bekijk details in TikTok Events API Gateway hub Huurderslijst
Bekijk details in TikTok Events API Gateway hub Huurderslijst
TikTok Events API Gateway
TikTok Events API Gateway

2.3. Kies het account en de Pixels die je wilt verbinden en bevestig je keuzes.

TikTok Events API Gateway
TikTok Events API Gateway

2.4. Je ziet de toegevoegde pixel in je dashboard.

TikTok Events API Gateway
TikTok Events API Gateway

3. [Aanbevolen] Voeg een aangepast domein toe.

Het gebruik van een aangepast domein in je TikTok Events API Gateway kan de meetprestaties verbeteren. Hiermee kun je het subdomein kiezen voor de communicatie van de Pixel met de Events API Gateway. Dit aangepaste domein moet overeenkomen met het subdomein dat wordt gebruikt voor het activeren van de TikTok Pixel.

3.1. Klik op "Settings" (Instellingen) in het menu. Klik op de knop "Set up domain" (Domein instellen).

TikTok Events API Gateway
TikTok Events API Gateway

3.2. Kies een domein en ontvang DNS-records om te configureren.

TikTok Events API Gateway
TikTok Events API Gateway
TikTok Events API Gateway
TikTok Events API Gateway

3.3. Log in bij je DNS-provider en stel records in (als je Cloudflare gebruikt, moeten de instellingen eruitzien zoals op de schermafbeelding).

TikTok Events API Gateway
TikTok Events API Gateway

3.4. En dat is alles! Je hebt je subdomein succesvol ingesteld.

4. [Aanbevolen] Laad TikTok js vanaf je subdomein.

Dit helpt je om de bescherming van je evenementen tegen adblockers te vergroten.

Nadat je je "Data routing domain" hebt gevalideerd, zie je een link die je kunt gebruiken om TikTok js op je site te downloaden. Klik op "View base code" (Basiscodex bekijken) en kopieer de snippet.

Klik op “Bekijk basiscode” om TikTok js-fragment te downloaden
Klik op “Bekijk basiscode” om TikTok js-fragment te downloaden
TikTok Events API Gateway
TikTok Events API Gateway

5. [Optioneel] Voeg nieuwe Pixels toe.

Je kunt één enkele TikTok Events API Gateway gebruiken om meerdere TikTok Pixels in te stellen. Bovendien kunnen Pixels van verschillende TikTok Business Accounts worden verbonden met dezelfde Events API Gateway, mits je beheerdersrechten hebt voor alle Pixels.

Het proces is eenvoudig: configureer je TikTok Events API Gateway en voeg vervolgens nieuwe Pixels toe via de hub-interface. Klik gewoon op "Connect data source" (Gegevensbron verbinden).

TikTok Events API Gateway
TikTok Events API Gateway

6. Test je setup

Zoals eerder vermeld, gebruikt de TikTok Events Gateway web-events om deze via de server te routeren.

6.1. Binnen 30 minuten na het verbinden van je pixel met de TikTok eAPI Gateway hub, zou je moeten merken dat het aantal evenementen niet langer nul is en je zou ook de namen moeten zien van de evenementen die zijn ontvangen.

TikTok Events API Gateway
TikTok Events API Gateway

6.2. Je kunt ook controleren of evenementen correct naar de TikTok Events API G hub worden verzonden door de console van de website te controleren:

  1. Open het netwerktabblad van de ontwikkelaarstool van je browser op je site.
  2. Controleer of evenementen naar de URL van je Events API Gateway zijn verzonden (zie de schermafbeelding hieronder).
TikTok Events API Gateway
TikTok Events API Gateway

Hoe stel je de TikTok Events API in via server GTM?

!

Vanaf 28 februari 2022 ondersteunt TikTok event deduplicatie

Je kunt web- en servertracking voor TikTok combineren. Als je dat doet, zorg er dan voor dat je event_id toevoegt aan web- en servertags. Onze TikTok-events-API ondersteunt ontdubbeling en de event_id-variabele ondersteunt de TikTok-standaard van event_id. Onderstaande gids beschrijft het instellen van alleen TikTok-events API, zonder pixel-events of deduplicatie.

2. Verzend de vereiste gegevens naar de servercontainer. We hebben blogposts die twee methoden beschrijven: gegevens verzenden met behulp van de server-side GA4-configuratie of met behulp van Data Tag.

3. Voeg de TikTok Events API-tag toe vanuit de GTM-templatesgalerij. 

TikTok Events API Gateway
TikTok Events API Gateway

4. Genereer een Access Token. Klik hiervoor op Assets -> Web Events -> Open pixel -> Klik op Settings -> Klik op "Generate Access Token".

TikTok Events API Gateway
TikTok Events API Gateway

5. Maak een TikTok-tag aan in de servercontainer. Kies event -> Voeg TikTok API Access Token toe -> Voeg TikTok Pixel ID toe (je kunt slechts één Pixel ID per tag toevoegen).

6. Je kunt eventparameters toevoegen onder Server Event Data Override. Deze parameters omvatten event-ID, referrer, timestamp en URL. Onze tag voegt eventparameters automatisch toe, maar je kunt ervoor kiezen om handmatig te overschrijven en te verzenden.

7. Om gebruikersgegevens te verzenden, open je de sectie voor gebruikersgegevens. Hier kun je het IP-adres, de user-agent, e-mail, externe ID en ttclid toevoegen. IP-adres, user-agent en ttclid worden automatisch toegevoegd

8. Gebruik de sectie 'properties' om productgegevens te verzenden. Je kunt content, valuta, beschrijving, query en waarde verzenden.

9. Voeg trigger toe.

TikTok trigger add
TikTok trigger add
TikTok HTTP request details
TikTok HTTP request details
TikTok ads manager
TikTok ads manager

Conclusie

De TikTok Events API maakt het mogelijk om gegevens van je server naar de TikTok-app te verzenden. Je kunt het gebruiken om de nauwkeurigheid van eventtracking te verbeteren en de omvang van je aangepaste doelgroepen te vergroten. De Events API heeft dezelfde mogelijkheden als browsertracking. Toch profiteer je van betere privacy en prestaties dankzij de mogelijkheid om client-side beperkingen te omzeilen en nauwkeurigere informatie over gebruikersgedrag te verkrijgen.

Wil je aan de serverkant beginnen?Registreer nu!

author

Ira Holubovska

Author

Ira heeft 10+ jaar ervaring in digital marketing, waarvan 5 jaar met server-side tracking. Ze weet wanneer en hoe het werkt in diverse marketingscenario’s.

Opmerkingen

Probeer Stape voor alles serverkantnu meteen!