TikTok Events API via je servercontainer

TikTok koppelt conversies aan advertenties met de click-ID ttclid , de cookie _ttp en gehashte klantgegevens. Events ook vanuit je servercontainer sturen, naast de pixel, bewaart die signalen als de browserkopie geblokkeerd wordt, en het is wat TikTok elke adverteerder aanraadt. Deze gids zet beide kanten op vanuit Measurebase.

Wat je nodig hebt

• Pixelcode: Events Manager → Web events → je pixel. Het is de code die met een C begint.
• Events API access token: open de pixel → Settings → Generate access token.
• Je Measurebase-domein met het Enhanced script geïnstalleerd en GA4-events die binnenkomen.

Stap 1 · Voeg het toe aan je meetopzet

Open het domein in je dashboard, ga naar de pagina Settings en zoek Measurement setup. Vink de kaart van de bestemming aan en vul de ID's hieronder in. Tokens en API-sleutels worden versleuteld opgeslagen, buiten de setup zelf. De setup verstuurt zelf niets: het is de referentie waar de tracking audit en de templatebouwer van uitgaan, dus wat je hier invult is wat de audit in je containers verwacht te vinden.

Stap 2 · Genereer en importeer de containers

Ga naar Resources → GTM templates in het dashboard. Vink onder Destinations het platform aan (Google Analytics 4 en de e-commerce-events staan standaard aan; kies de Shopify-, WordPress- of Shopware-datalayer als je site een van onze plugins draait). Vul in de volgende stap dezelfde ID's in, kies Web + server onder Containers en download de twee JSON-bestanden.

Open in Google Tag Manager elke container, ga naar Admin → Import Container, kies het bijbehorende bestand, kies een nieuwe workspace en Merge. De import voegt alleen toe: nieuwe tags, triggers en variabelen met eigen namen, plus de galerijtemplates die ze nodig hebben. Controleer het resultaat in Preview en publiceer dan.

Stap 3 · Wat de import bevat

Webcontainer: de template TikTok Pixel uit de galerij met de basiscode van de pixel en de events ViewContent, AddToCart, InitiateCheckout en CompletePayment, een constante met je pixelcode en de variabele Unique Event ID.

Servercontainer: de template TikTok Events API uit de galerij met Page View, View Content, Add to Cart, Initiate Checkout en Complete Payment als servertags op de GA4-events. Ze sturen waarde, valuta en contents, hashen e-mailadres en telefoonnummer, en sturen het IP-adres, de user agent, ttclid en _ttp.

Stap 4 · Eén event-ID voor browser en server

Een platform dat hetzelfde event van een browserpixel én van een servertag ontvangt, telt het dubbel, tenzij beide hetzelfde event-ID dragen. De import regelt dat: de variabele Unique Event ID maakt één ID per event in de webcontainer, de GA4-eventinstellingen sturen het naar je servercontainer als event_id, en zowel de pixeltag als de servertag sturen diezelfde waarde mee in hun ontdubbelingsveld. Het platform houdt één kopie en gooit de andere weg.

Met de Shopify-app, de WordPress-plugin of de Shopware-plugin draagt een aankoop die ook server-side wordt doorgestuurd het ordernummer mee als mb_event_id, zodat ook de twee aankoopkopieën aan elkaar gekoppeld kunnen worden.

TikTok ontdubbelt op eventnaam plus event_id binnen 48 uur.

Stap 5 · Toestemming

De geïmporteerde tags dragen de toestemmingsinstellingen van de referentiecontainers waaruit ze gekopieerd zijn. Controleer ze tegen je eigen toestemmingsopzet voordat je publiceert: een browserpixel hoort ad_storage te vereisen onder Aanvullende toestemmingscontroles of af te gaan op het event van je toestemmingstool, en de servertags horen alleen te sturen als de hit advertentietoestemming draagt. De toestemmingscontroles van de audit en de gids over tags die afgaan vóór toestemming laten zien hoe je allebei controleert.

Stap 6 · Testen

Open in Events Manager Test events en plak de testcode in de servertag zolang je test; klik door je site en controleer dat elk event één keer vanuit de browser en één keer vanaf de server verschijnt met hetzelfde ID, en dat TikTok ze als ontdubbeld markeert.

Open aan de Measurebase-kant de pagina Requestlogs: als je door je site klikt, zie je GA4-events met een groene 200 bij je servercontainer binnenkomen. Open de previewmodus van de servercontainer om de servertag op die events te zien afgaan, met het event-ID en de gebruikersgegevens die hij oppikte.

Click-ID's en cookies

Safari stript ttclid uit landings-URL's. De schakelaar TikTok in Click ID Restorer vangt hem op in een first-party cookie zodra de bezoeker landt en herstelt hem op latere requests, zodat de serverevents hem houden. Cookie Keeper houdt de cookie _ttp in leven voorbij de 7-dagenlimiet van Safari.

Wat de tracking audit controleert

Elke nacht vergelijkt de tracking-audit je meetopzet met je live containers en je site. Voor elke bestemming controleert hij dat de tags bestaan in de container die je opzet verwacht, dat het ID in de container overeenkomt met dat in je opzet, dat een browserpixel en zijn servertag een event-ID delen, en welke cookies van het platform nog gezet worden nadat een bezoeker weigert. Bevindingen openen een melding de eerste keer dat ze verschijnen; wat de audit kan herstellen, stelt hij voor als wijziging in een aparte Measurebase-workspace in je container.

Veelgestelde vragen

Waar komt de paginaweergave aan de webkant vandaan?

De basiscode van de pixel stuurt hem bij het laden; de servertag stuurt de bijbehorende Page View op de GA4-paginaweergave, met hetzelfde event-ID.

Kan ik de Events API zonder de pixel draaien?

Dat kan, maar de matchpercentages zakken zonder _ttp en de browsercontext. Draai allebei, ontdubbeld.