Hoe TikTok Events API instellen

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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.

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

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".

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.

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

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

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

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

2.4. Je ziet de toegevoegde pixel in je dashboard.

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).

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

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

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

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.

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).

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.

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. 1.
   Open het netwerktabblad van de ontwikkelaarstool van je browser op je site.
2. 2.
   Controleer of evenementen naar de URL van je Events API Gateway zijn verzonden (zie de schermafbeelding hieronder).

1. Maak en configureer een Google Tag Manager servercontainer.

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. 

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

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.

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.