Handleiding voor het instellen en bijhouden van de TikTok Conversions API

Ontdek hoe de TikTok Conversion API werkt, hoe je de Events API instelt met Pixel, dubbele gebeurtenissen voorkomt, matching verbetert en conversietracking test.

Kinnari Ashar

Door

Kinnari Ashar

Leestijd: 15 min.

TikTok Conversie-API (CAPI) configuratie- en trackinghandleiding

Je TikTok-campagne lijkt aan de oppervlakte misschien winstgevend, terwijl enkele van de meest waardevolle conversies nooit in het rapport verschijnen. Een klant kan een product bekijken, toevoegen aan de winkelwagen, afrekenen of een leadformulier invullen, maar het pad achter die actie blijft mogelijk onvolledig.

Die ontbrekende gegevens beïnvloeden meer dan alleen de rapportage. Ze kunnen bepalen welke advertenties TikTok voorrang geeft, waar je budget toewijst en hoe zeker je de campagneprestaties kunt beoordelen.

TikTok Conversion API, officieel bekend als Events API, is ontworpen om dat beeld duidelijker te maken. Het verkrijgen van nuttige data hangt echter af van hoe je deze instelt, koppelt aan de TikTok Pixel en omgaat met overlappende gebeurtenissen.

In de volgende secties worden de belangrijkste onderdelen uitgelegd, zonder het proces te veranderen in een technisch doolhof.

Wat is de TikTok Conversion API?

TikTok Conversion API, officieel TikTok Events API genoemd, is een server-naar-serververbinding die marketing- en conversiegebeurtenissen vanaf je website, e-commerceplatform, app, CRM, server of offline systeem rechtstreeks naar TikTok verzendt.

Afhankelijk van je bedrijf en opzet kun je acties rapporteren zoals:

  • Productweergaven en zoekopdrachten

  • Toevoegingen aan winkelwagen en gestarte checkouts

  • Aankopen en offline verkopen

  • Registraties en formulierinzendingen

  • Abonnementen en gekwalificeerde leads

TikTok kan in aanmerking komende gebeurtenisgegevens gebruiken om conversies te meten, resultaten toe te schrijven aan advertenties, weergave te optimaliseren, doelgroepen te creëren en retargeting te ondersteunen. De kwaliteit van die resultaten hangt af van de nauwkeurigheid, volledigheid, matchinggegevens en toestemmingsstatus van de verstrekte informatie.

Events API heeft een specifiekere functie dan de andere ontwikkelaarsproducten van TikTok. Marketing API beheert advertentiefuncties, TikTok Shop APIs ondersteunt handelsactiviteiten en Research API biedt goedgekeurde onderzoekers toegang tot geselecteerde openbare platformgegevens. Events API richt zich op het verzenden van marketinggebeurtenissen.

Hoe werkt de TikTok Conversion API?

De TikTok Conversion API geeft een geregistreerde klantactie van je bedrijfssystemen door aan TikTok, waar deze kan worden gekoppeld aan een relevante advertentie-interactie en kan worden gebruikt voor metingen.

Het proces verloopt meestal in deze volgorde:

  1. Een klant bekijkt of klikt op je TikTok-advertentie en bezoekt je website of winkel.

  2. Zij voltooien een actie, zoals het bekijken van een product, het toevoegen van een item aan de winkelwagen, het verzenden van een formulier of het plaatsen van een bestelling.

  3. Je website, e-commerceplatform, betaalsysteem of CRM registreert de actie.

  4. Je server of integratie maakt een gebeurtenis aan met details zoals de gebeurtenisnaam, tijd, bestelwaarde, productinformatie en beschikbare matchinggegevens.

  5. De gebeurtenis wordt verzonden naar de TikTok Events API.

  6. TikTok gebruikt identifiers zoals klikgegevens, contactgegevens, browserinformatie of andere geschikte matchingvelden om de actie te koppelen aan een TikTok-gebruiker of advertentie-interactie.

  7. Gematchte gebeurtenissen kunnen bijdragen aan rapportage, attributie, campagneoptimalisatie, retargeting en het opbouwen van doelgroepen.

Voor webtracking kan dezelfde actie TikTok ook bereiken via de Pixel:

TikTok-advertentie → Websitebezoek → Klantactie → Pixel-gebeurtenis en server-gebeurtenis → Deduplicatie → TikTok Ads Manager

De server-gebeurtenis kan nog steeds een bevestigd resultaat rapporteren wanneer het browserverzoek mislukt doordat de Pixel werd geblokkeerd, de bevestigingspagina niet laadde, de checkout elders plaatsvond of de verbinding te snel werd verbroken.

Het ontvangen van de gebeurtenis garandeert echter geen TikTok-attributie. TikTok heeft nog steeds voldoende geldige matching- en attributiegegevens nodig om die conversie te koppelen aan een in aanmerking komende advertentie-interactie.

TikTok Pixel versus TikTok Conversion API

TikTok Pixel en Events API verzamelen conversiegegevens via verschillende routes. De Pixel registreert activiteit in de browser van de klant, terwijl Events API gebeurtenissen verzendt vanaf je server of een ander aangesloten systeem. 

TikTok raadt aan om waar mogelijk beide te gebruiken voor het bijhouden van webconversies.

Functie

TikTok Pixel

TikTok Conversion API

Gegevensbron

Browser van de klant

Server, platform, app, CRM of offline systeem

Trackingmethode

Browsergebaseerd

Server-naar-server

Installatie

Websitecode, Event Builder of tagmanager

Partnerintegratie, Events API Gateway, servercontainer of directe API

Browserbeperkingen

Meer beïnvloed

Minder afhankelijk van browseruitvoering

Het meest geschikt voor

Paginaweergaven en acties op de site

Bevestigde website-, backend-, CRM- en offline resultaten

CRM- en offline gebeurtenissen

Beperkt

Ondersteund

Technische moeilijkheidsgraad

Meestal lager

Varieert van gemiddeld tot geavanceerd

Deduplicatie

Niet vereist bij afzonderlijk gebruik

Vereist wanneer Pixel dezelfde gebeurtenis verzendt

De Pixel is beter geschikt voor direct gedrag op de site, terwijl Events API resultaten kan bevestigen die na de browserinteractie zijn vastgelegd, zoals goedgekeurde betalingen of gekwalificeerde CRM-leads. 

Wanneer beide één conversie rapporteren, vereist TikTok deduplicatie zodat Ads Manager deze slechts één keer telt.

Welke gebeurtenissen en gegevens kun je verzenden via de TikTok Events API?

1. Standaard conversiegebeurtenissen

TikTok biedt standaard gebeurtenisnamen voor veelvoorkomende acties op het gebied van e-commerce en leadgeneratie. Deze vooraf gedefinieerde gebeurtenissen kunnen rapportage, conversieoptimalisatie en doelgroepcreatie ondersteunen.

Veelvoorkomende gebeurtenissen zijn onder meer:

  • ViewContent: Een bezoeker opent een productpagina of een andere belangrijke pagina.

  • Search: Iemand zoekt op je website naar een product, categorie of term.

  • AddToWishlist: Een shopper bewaart een item voor later.

  • AddToCart: Een product is succesvol toegevoegd aan de winkelwagen.

  • InitiateCheckout: De klant start het afrekenproces.

  • AddPaymentInfo: Betalingsgegevens worden ingediend tijdens het afrekenen.

  • Purchase: Een voltooide aankoop wordt geregistreerd.

  • SubmitForm: Een bezoeker verzendt met succes een lead- of aanvraagformulier.

  • CompleteRegistration: Een gebruiker voltooit het aanmaken van een account of registratie.

  • Subscribe: Een klant voltooit een abonnementsactie.

  • StartTrial: Een gebruiker start een proefperiode.

De naam van de gebeurtenis alleen is niet voldoende. Je moet ook exact bepalen wanneer elke gebeurtenis wordt geactiveerd.

Purchase kan bijvoorbeeld verwijzen naar het aanmaken van een bestelling, het autoriseren van de betaling, het incasseren van de betaling of het uitvoeren van de bestelling. Kies één trigger en pas deze consequent toe op je website, backend en rapportagesystemen.

Parameters voegen vervolgens context toe aan de gebeurtenis. Afhankelijk van de actie kunnen dit waarde, valuta, aantal, content-ID's en productinformatie zijn. TikTok markeert sommige parameters als verplicht en beveelt andere aan omdat ze de gebeurteniskwaliteit en campagneprestaties kunnen verbeteren.

Het verzenden van dezelfde gebeurtenis in verschillende fasen kan conversies en omzet overdrijven. Standaardiseer de trigger en parameters vóór de lancering, zodat Ads Manager één consistente versie van elke klantactie ontvangt.

2. Gebeurtenisparameters

Zodra de trigger voor de gebeurtenis duidelijk is, beschrijven parameters wat er is gebeurd en geven ze TikTok de informatie die nodig is om dit correct te interpreteren.

Een gebeurtenis kan het volgende bevatten:

  • Gebeurtenisnaam (Event name): De actie die wordt gerapporteerd, zoals AddToCart of Purchase.

  • Gebeurtenistijd (Event time): Het tijdstip waarop de actie plaatsvond.

  • Gebeurtenis-ID (Event ID): Een unieke identifier die wordt gebruikt om dezelfde gebeurtenis te herkennen in de Pixel en Events API.

  • Gebeurtenisbron-URL (Event source URL): De pagina waar de actie plaatsvond.

  • Valuta (Currency): De valuta die voor de transactie is gebruikt.

  • Conversiewaarde (Conversion value): De totale geldwaarde die aan de gebeurtenis is gekoppeld.

  • Product- of content-ID's: De identifiers voor de betrokken producten.

  • Contenttype: De categorie van de content die wordt gerapporteerd.

  • Aantal (Quantity): Het aantal eenheden dat bij de actie is inbegrepen.

  • Bestelgegevens: Ondersteunde aankoopinformatie, zoals contentgegevens op itemniveau.

Product-identifiers moeten dezelfde indeling hebben als in je gekoppelde TikTok-catalogus. Controleer vóór het toewijzen van gebeurtenissen of de catalogus product-ID's, variant-ID's, SKU's of een andere platformspecifieke identifier opslaat.

Valuta en waarde vereisen ook een consistente opmaak. Ontbrekende, statische of onjuist toegewezen waarden kunnen ertoe leiden dat aankoopgebeurtenissen geen bruikbare omzetgegevens bevatten, wat de rapportage van het rendement op advertentie-uitgaven (ROAS) verzwakt.

3. Klantmatching-informatie

Nadat TikTok een gebeurtenis heeft ontvangen, heeft het voldoende informatie nodig om die actie te koppelen aan een klant of een in aanmerking komende advertentie-interactie.

Veelvoorkomende matching-identifiers zijn onder meer:

  • TikTok-klik-ID: De ttclid-waarde die is gekoppeld aan een klik op een TikTok-advertentie.

  • Gehashte e-mailadres: Een genormaliseerd e-mailadres geconverteerd met behulp van SHA-256.

  • Gehashte telefoonnummer: Een consistent opgemaakt telefoonnummer geconverteerd met behulp van SHA-256.

  • Gehashte externe klant-ID: Je eigen klant-identifier, voorbereid volgens de specificaties van TikTok.

  • IP-adres van de klant: Het IP-adres dat wordt geregistreerd wanneer de website-actie plaatsvindt.

  • User-agent van de browser: Informatie over de browser en het apparaat van de klant.

  • TikTok first-party identifier: De ondersteunde _ttp-cookiewaarde, indien beschikbaar.

Een gebeurtenis kan door de Events API worden geaccepteerd en toch een zwakke matching opleveren als deze velden ontbreken, ongeldig zijn of verkeerd zijn opgemaakt. Een sterkere matching hangt af van het verzenden van identifiers die je rechtmatig mag verzamelen, niet simpelweg van het verzenden van een grotere payload.

E-mailadressen, telefoonnummers en externe ID's moeten exact volgens de eisen van TikTok worden genormaliseerd en gehasht. Klik-ID's, IP-adressen, user-agents en ondersteunde cookie-identifiers volgen hun eigen opmaakregels. 

Je configuratie moet ook rekening houden met toestemmingskeuzes, privacyverklaringen en de vereisten voor gegevensbescherming die in elke markt van toepassing zijn.

Hoe TikTok Event Matching en deduplicatie werken

Event Matching

TikTok gebruikt match keys om een gerapporteerde conversie te koppelen aan een persoon die eerder interactie heeft gehad met een advertentie. Een nuttige sleutel is de TikTok-klik-ID, of ttclid, die na een advertentieklik aan de URL van de bestemmingspagina kan worden toegevoegd.

Je website moet die waarde behouden terwijl de bezoeker het koopproces doorloopt. Het opslaan ervan bij de uiteindelijke bestelling of lead geeft TikTok een grotere kans om het resultaat terug te koppelen aan de oorspronkelijke interactie.

De klik-ID kan verloren gaan wanneer:

  • Een omleiding (redirect) URL-parameters verwijdert

  • Het afrekenen overgaat naar een ander domein

  • Een betalingsprovider een afzonderlijke sessie start

  • Trackingwaarden uit de URL worden gewist

  • De oorspronkelijke sessie verloopt

Contactgegevens en externe klant-ID's kunnen de matching ook ondersteunen, maar ze moeten vóór het hashen worden genormaliseerd. Gebruik ook het daadwerkelijke IP-adres en de browser-user-agent van de klant. 

Het verzenden van placeholder-gegevens, een server-IP of een backend-user-agent geeft TikTok informatie over jouw systeem in plaats van over de koper.

Event Deduplicatie

Wanneer Pixel en Events API beide dezelfde conversie verzenden, moet TikTok kunnen herkennen dat de twee records één klantactie beschrijven. Deduplicatie voorkomt dat een aankoop, lead of registratie dubbel wordt geteld.

Beide exemplaren moeten dezelfde gebeurtenisnaam en dezelfde unieke gebeurtenis-ID gebruiken.

Bijvoorbeeld:

  • Pixel Purchase: order_84739

  • Server Purchase: order_84739

TikTok vergelijkt die velden om overlappende gebeurtenissen te identificeren. De waarde, valuta en productdetails moeten ook overeenkomen, zodat de rapportage consistent blijft.

Een bestel-ID, transactie-ID, checkout-voltooiings-ID of een stabiele, door de server gegenereerde UUID kan goed werken omdat deze elk naar één specifieke conversie verwijzen.

Vermijd product-ID's, klant-ID's, hergebruikte sessie-ID's of afzonderlijke willekeurige ID's die apart door de browser en server zijn gegenereerd.

API-nieuwpogingen (retries) moeten de oorspronkelijke gebeurtenis-ID hergebruiken. Een nieuw ID kan ervoor zorgen dat de herhaling als een nieuwe conversie wordt gezien.

Hoe stel je de TikTok Conversion API in?

Stap 1. Kies een integratiemethode

Je eerste beslissing is hoe de gebeurtenisgegevens van je bedrijfssystemen naar TikTok worden verzonden. De beste route hangt af van je bestaande platform, de beschikbare technische ondersteuning en hoeveel controle je nodig hebt over de toewijzing van gebeurtenissen en gegevenskwaliteit.

Elke methode gaat om met een ander niveau van complexiteit, dus vergelijk de opties met de manier waarop je winkel momenteel conversies registreert.

  • Integratie via e-commerceplatform: Meestal de eenvoudigste route voor ondersteunde Shopify- of WooCommerce-winkels. Het platform beheert een groot deel van de verbinding, de toewijzing van gebeurtenissen en de inrichting van de catalogus.

  • Data- of trackingpartner: Geschikt wanneer je al gebruikmaakt van een customer data platform (CDP), CRM, tagmanager of aanbieder van server-tracking. Bevestig welke gebeurtenissen, identifiers en toestemmingsinstellingen de partner ondersteunt.

  • Directe API-integratie: Beter voor maatwerkwebsites, eigen checkouts, marktplaatsen, abonnementsplatforms of afwijkende conversielogica. Het biedt meer controle, maar vereist ontwikkeling, testen, monitoring en onderhoud.

  • Server-side Google Tag Manager: Een praktische optie voor teams die al een servercontainer beheren en ervaring hebben met tags, triggers, variabelen, GA4 en cloudhosting. TikTok biedt voor deze methode ook een interactief installatieproces.

Beoordeel voordat je begint de vereiste gebeurtenissen, technische middelen, catalogusstructuur, toegang tot event logs, het aantal winkels, de toestemmingsinstellingen en wie de koppeling na de lancering zal onderhouden.

Stap 2. Maak een trackingplan voor gebeurtenissen

Voordat je de integratie configureert, stel je een trackingplan op dat aan elke klantactie één overeengekomen definitie geeft. Dit zorgt ervoor dat ontwikkelaars, marketeers en analyseteams volgens dezelfde regels werken.

Leg voor elke gebeurtenis het volgende vast:

  • TikTok-gebeurtenisnaam

  • Wat de actie betekent voor je bedrijf

  • De exacte voorwaarde die de trigger activeert

  • Of deze afkomstig is van de browser, de server of beide

  • Gegevensvelden die moeten worden meegestuurd

  • Beschikbare matching-informatie

  • Bron van de unieke gebeurtenis-ID

  • Toepasselijke toestemmingsvoorwaarden

Neem Purchase als voorbeeld. Bepaal of deze moet worden geactiveerd wanneer de winkel een bestelling aanmaakt of pas nadat de betaling is geslaagd. Voor de meeste winkels biedt een bevestigde betaling een betrouwbaarder beeld van de voltooide omzet, omdat onbetaalde en mislukte bestellingen buiten beschouwing blijven.

Neem die regel op in het plan en pas deze vervolgens toe op je checkout, backend, Pixel en Events API-configuratie. TikTok ondersteunt standaardgebeurtenissen via beide trackingroutes, dus één gedeelde definitie voorkomt conflicterende rapporten achteraf.

Stap 3. Koppel de juiste TikTok-gegevensbron

Open vervolgens Events Manager vanuit het advertentieaccount dat de campagnes zal uitvoeren.

Ga naar Tools, selecteer Events Manager, kies Connect Data Source en selecteer vervolgens Web. Maak een nieuwe website-gegevensverbinding aan of open de bestaande die aan de juiste site is gekoppeld.

Bevestig vóór het afronden van de configuratie de website-URL, Pixelcode, het advertentieaccount en de gebruikersrechten. Deze controle is vooral belangrijk wanneer meerdere winkels of klantaccounts binnen één Business Center worden beheerd.

Wanneer Pixel en Events API activiteit van dezelfde website rapporteren, verbind ze dan beide met de beoogde website-gegevensverbinding. Het gebruik van de verkeerde bestemming kan geldige gebeurtenissen naar een niet-gerelateerd account sturen, terwijl de daadwerkelijke campagnes zonder de benodigde gegevens komen te zitten.

Stap 4. Genereer en beveilig het toegangstoken

Als je een directe Events API-integratie bouwt, genereer dan het toegangstoken dat wordt gebruikt om verzoeken te verifiëren. Partnerintegraties kunnen authenticatie beheren via hun eigen verbindingsproces.

Bewaar het token in een beveiligde serveromgeving, secrets manager of versleuteld configuratiebestand. Alleen de systemen en personen die verantwoordelijk zijn voor de integratie mogen toegang hebben.

Plaats het token nooit in:

  • Websitebroncode

  • Browserscripts

  • Openbare repositories

  • Gedeelde schermafbeeldingen

  • Onbeveiligde logs

Een token dat in code aan de clientzijde wordt geplaatst, kan via browsertools worden bekeken. Als een token openbaar wordt, vervang het dan onmiddellijk en controleer je gebeurtenisactiviteit op onverwachte verzoeken.

Documenteer hoe het token kan worden geroteerd zonder de verzending van gebeurtenissen te onderbreken.

Stap 5. Gebeurtenisgegevens vastleggen en voorbereiden

Nu de verbinding tot stand is gebracht, bereid je de informatie voor die TikTok bij elke gebeurtenis zal ontvangen.

Behoud de ttclid van de bestemmingspagina en draag deze over via redirects, het afrekenen en de betalingsstappen. Sla deze waar mogelijk op bij de uiteindelijke bestelling of lead.

Verzamel vervolgens alleen de klant-identifiers die volgens je toestemmingsinstellingen zijn toegestaan. Normaliseer e-mailadressen en telefoonnummers voordat je de vereiste hashingmethode toepast, in plaats van inconsistente ruwe waarden te hashen.

De gebeurtenis moet ook het daadwerkelijke IP-adres en de browser-user-agent van de klant bevatten, voor zover toegestaan. Vervang deze niet door gegevens van je hostingserver of backendsysteem.

Genereer ten slotte één stabiele gebeurtenis-ID voor elke actie. Gebruik diezelfde waarde in de Pixel- en de serverkopie, zodat TikTok ze kan herkennen als één conversie.

Stap 6. Pixel- en server-gebeurtenissen verzenden

Zodra de gebeurtenisgegevens zijn voorbereid, verzend je de browser- en serverkopieën met dezelfde TikTok-gebeurtenisnaam en gebeurtenis-ID. Die gedeelde identiteit stelt TikTok in staat overlappende records te herkennen en de actie één keer te tellen.

Gebruik backendgegevens voor de uiteindelijke aankoopwaarde, valuta, bestel-ID en productdetails, omdat je winkel of betaalsysteem het definitieve transactierecord bevat.

De gebeurtenis Purchase mag alleen worden geactiveerd op het punt dat in je trackingplan is gedefinieerd. Verzend deze bijvoorbeeld nadat de betaling is geslaagd of een geldige bestelling is bevestigd, en niet wanneer de koper alleen het afrekenproces start of een tussenliggende betalingspagina bereikt.

Vergelijk vóór de lancering beide kopieën van de gebeurtenis en controleer of de namen, ID's, waarden en bestelinformatie overeenkomen.

Stap 7. Gebeurtenissen testen in TikTok Events Manager

Open vóór het lanceren van campagnes de testtools in Events Manager en voer de acties uit die in je trackingplan staan vermeld.

Voer een productweergave, toevoeging aan winkelwagen, checkout en testaankoop uit. Controleer vervolgens of:

  • Browser- en server-gebeurtenissen de beoogde website-gegevensverbinding bereiken

  • Gebeurtenisnamen en tijdstempels overeenkomen met de uitgevoerde acties

  • Aankoopwaarde en valuta de testbestelling weerspiegelen

  • Product-ID's het format van de gekoppelde catalogus volgen

  • Beschikbare matching-identifiers correct worden weergegeven

  • Overlappende gebeurtenissen dezelfde gebeurtenisnaam en gebeurtenis-ID bevatten

  • Tijdelijke testinstellingen vóór de livegang zijn verwijderd

Controleer ook het gedeelte Diagnostics. Een gebeurtenis kan succesvol binnenkomen terwijl deze nog steeds ontbrekende, ongeldige of onjuist opgemaakte informatie bevat.

Controleer na het testen de deduplicatiedetails voor overeenkomende browser- en serverrecords. De rapportage in Events Manager wordt buiten de live testweergave mogelijk niet direct bijgewerkt; houd dus rekening met verwerkingstijd voordat je een ontbrekende gebeurtenis als een mislukt verzoek beschouwt.

Veelvoorkomende problemen met de TikTok Conversion API en oplossingen

Een ontvangen gebeurtenis kan nog steeds onjuiste waarden, zwakke matchinggegevens of dubbele records bevatten. Gebruik de volgende controles om de oorzaak te achterhalen voordat je de hele integratie omgooit.

Probleem

Waarschijnlijke oorzaak

Wat te controleren

Aankopen verschijnen dubbel

Browser- en server-gebeurtenissen gebruiken verschillende ID's

Vergelijk de gebeurtenisnaam en gebeurtenis-ID in beide kopieën

Server-gebeurtenissen verschijnen niet

Onjuiste gegevensbron, token, advertentieaccount of omgeving

Bevestig de gekoppelde gegevensbron, het toegangstoken, het account en de productieconfiguratie

TikTok matcht weinig gebeurtenissen

Klik-ID of klant-identifiers ontbreken

Controleer welke match keys worden verzameld en verzonden

Alle gebeurtenissen tonen hetzelfde IP-adres

Het IP-adres van de hostingserver wordt doorgestuurd

Geef het oorspronkelijke IP-adres van de bezoeker door waar toegestaan

User-agent ontbreekt

Browserinformatie is niet bewaard

Leg de user-agent van de bezoeker vast tijdens de sessie

Aankoopomzet is nul

Waarde of valuta ontbreekt of is verkeerd geformatteerd

Controleer de parameters voor waarde en valuta

Producten komen niet overeen met de catalogus

Content-ID's gebruiken een andere indeling voor de identifier

Vergelijk gebeurtenis-ID's met de product-, variant- of SKU-indeling in de catalogus

Bestellingen worden vóór betaling verzonden

De Purchase-trigger activeert te vroeg

Controleer de betalings- of bestelstatus die de gebeurtenis activeert

Nieuwe pogingen (retries) creëren extra aankopen

Elke poging krijgt een nieuwe gebeurtenis-ID

Hergebruik de oorspronkelijke gebeurtenis-ID voor elke nieuwe poging

Gebeurtenissen komen laat aan

Een wachtrij, batch of partner vertraagt de levering

Verzend het tijdstip van de oorspronkelijke actie in plaats van het latere verwerkingstijdstip

Een lager aantal aankopen in TikTok wijst niet automatisch op een fout. Je winkel registreert elke bestelling, terwijl Ads Manager alleen aankopen rapporteert die zijn toegeschreven volgens de geselecteerde TikTok-instellingen. 

Vergelijk backend-aankopen, Pixel-gebeurtenissen, server-gebeurtenissen, gededupliceerde records en toegeschreven aankopen om het verschil te achterhalen.

Maak elke TikTok-test beter onderbouwd

De TikTok Conversion API, officieel bekend als TikTok Events API, kan je een duidelijker beeld geven van wat klanten doen nadat ze interactie hebben gehad met je advertenties. Voor websitecampagnes raadt TikTok aan deze naast de Pixel te gebruiken, zodat browser- en server-gebeurtenissen dezelfde meetopzet ondersteunen.

Bruikbare rapportage blijft afhankelijk van de kwaliteit van de gebeurtenissen die je verzendt. Aankooptriggers moeten echte bestellingen weerspiegelen, omzetwaarden moeten nauwkeurig zijn, catalogus-ID's moeten overeenkomen en dubbele browser- en server-gebeurtenissen hebben consistente ID's nodig.

Die controles laten zien hoe je campagnes hebben gepresteerd. WinningHunter helpt bij de beslissingen die vóór de lancering worden genomen. Je kunt actieve TikTok-advertenties, activiteiten van concurrenten, productsignalen, creatieve formats en winkelgegevens bekijken om te bepalen welke ideeën het waard zijn om te testen.

Samen gebruikt helpt onderzoek je om betere tests te kiezen, terwijl nauwkeurige conversiegegevens aantonen welke van die tests echte resultaten hebben opgeleverd.

Veelgestelde vragen

Is de TikTok Conversion API hetzelfde als de Events API?

Ja. Events API is de officiële productnaam van TikTok. Adverteerders en trackingproviders noemen het vaak TikTok Conversion API, Conversions API of TikTok CAPI. Deze onofficiële termen verwijzen over het algemeen naar dezelfde serververbinding die wordt gebruikt om marketinggebeurtenissen van websites, apps, CRM's en offline direct naar TikTok te verzenden.

Heb ik nog steeds de TikTok Pixel nodig als ik de Events API gebruik?

TikTok raadt aan om Pixel en Events API samen te gebruiken voor het bijhouden van webconversies. Pixel verzendt activiteit vanuit de browser, terwijl Events API gegevens verzendt vanaf een server of gekoppeld platform. Wanneer beide verbindingen dezelfde klantactie rapporteren, moeten ze dezelfde gebeurtenisnaam en gebeurtenis-ID delen, zodat TikTok duplicaten kan verwijderen.

Wat is event deduplicatie in TikTok?

Event deduplicatie voorkomt dat één conversie dubbel wordt geteld wanneer zowel de Pixel als de Events API deze rapporteren. TikTok vergelijkt de gebeurtenisnaam en de gebeurtenis-ID in elk exemplaar. Wanneer die velden overeenkomen, kan TikTok herkennen dat beide records dezelfde aankoop, registratie, lead of andere klantactie beschrijven.

Wat moet ik gebruiken als TikTok-gebeurtenis-ID?

Gebruik een identifier die gekoppeld is aan één specifieke conversie, zoals een bestel-ID, transactie-ID, stabiele checkout-voltooiings-ID of een door de server gegenereerde UUID. Pixel en Events API moeten dezelfde waarde ontvangen voor overlappende gebeurtenissen. Elke nieuwe poging van het serververzoek moet ook die oorspronkelijke ID hergebruiken in plaats van een nieuwe aan te maken.

Kan ik de TikTok Events API instellen op Shopify?

Ja. Shopify-verkopers kunnen verbinding maken met TikTok via de ondersteunde commerce-integratie of een andere compatibele trackingprovider. De beschikbaarheid en mogelijkheden kunnen variëren per markt en configuratie. Controleer voordat je op een integratie vertrouwt welke gebeurtenissen, klant-identifiers, toestemmingssignalen, omzetvelden en product-ID's vanuit je winkel naar TikTok worden verzonden.

Waarom rapporteert TikTok minder aankopen dan Shopify?

Shopify registreert bestellingen die via alle acquisitiekanalen zijn geplaatst, terwijl TikTok alleen aankopen rapporteert die zijn toegeschreven aan TikTok-advertenties onder de geselecteerde attributie-instellingen. Verschillen kunnen ook worden veroorzaakt door attributievensters, ontbrekende match keys, toestemmingskeuzes, mislukte gebeurtenisverzendingen, verwerkingsvertragingen of deduplicatie. Vergelijk ontvangen gebeurtenissen voordat je ervan uitgaat dat de verbinding verbroken is.

Omzeilt de TikTok Events API adblockers?

Events API is minder afhankelijk van browserscripts omdat de gebeurtenis wordt verzonden vanaf een server of aangesloten platform. Het moet echter niet worden beschouwd als volledig immuun voor adblockers, browserinstellingen, toestemmingskeuzes of privacybeperkingen. Je moet klantgegevens nog steeds rechtmatig verzamelen en verzenden en de vereisten van TikTok naleven.

Hoe kan ik controleren of de TikTok Events API werkt?

Open TikTok Events Manager en bekijk de ontvangen server-gebeurtenissen, parameters, matchinggegevens, diagnostische gegevens en deduplicatiedetails. Test belangrijke acties zoals aankopen en vergelijk de gerapporteerde waarde, valuta, product-ID's en gebeurtenis-ID's met je winkel- en betalingsadministratie. Houd rekening met verwerkingstijd voordat je een vertraagde gebeurtenis als ontbrekend beschouwt.



Ga naar

Kinnari Ashar

Auteur

Auteur

Kinnari Ashar

Kinnari Ashar

Kinnari Ashar is een contentstrateeg met meer dan tien jaar ervaring in beauty, lifestyle en tech. Ze is gespecialiseerd in het creëren van content die resoneert bij het publiek en zorgt voor echte betrokkenheid. Daarnaast heeft Kinnari praktische ervaring met het opzetten en beheren van dropshippingprojecten, waarbij de focus ligt op advertentiestrategie en creatief onderzoek om succesvolle campagnes te vinden en winstgevend op te schalen.

Kinnari Ashar is een contentstrateeg met meer dan tien jaar ervaring in beauty, lifestyle en tech. Ze is gespecialiseerd in het creëren van content die resoneert bij het publiek en zorgt voor echte betrokkenheid. Daarnaast heeft Kinnari praktische ervaring met het opzetten en beheren van dropshippingprojecten, waarbij de focus ligt op advertentiestrategie en creatief onderzoek om succesvolle campagnes te vinden en winstgevend op te schalen.

Lees vergelijkbare artikelen

Klaar om de volgende winkel te bouwen die $ 100k per dag oplevert?

WinningHunter-startscherm met zoekbalk voor merken om advertenties, winkels en producten van elk merk te onderzoeken

Klaar om de volgende winkel te bouwen die $ 100k per dag oplevert?

WinningHunter-startscherm met zoekbalk voor merken om advertenties, winkels en producten van elk merk te onderzoeken

Klaar om de volgende winkel te bouwen die $ 100k per dag oplevert?

WinningHunter-startscherm met zoekbalk voor merken om advertenties, winkels en producten van elk merk te onderzoeken