Wat is de TikTok Events API?
Met de TikTok Events API stuurt een server events van je website rechtstreeks naar TikTok, naast de events die de TikTok-pixel vanuit de browser van de klant stuurt. Voor koppelingen met een website raadt TikTok aan de Events API samen met de pixel te gebruiken. Je komt hem ook tegen als TikTok Conversions API.
Met WeProfit komt een Shopify-aankoop bij TikTok binnen als CompletePayment, verstuurd vanaf de servers van WeProfit naar de pixel die je koppelt. Andere events uit je webshop volgen dezelfde route, zoals ViewContent, AddToCart en InitiateCheckout; de tabel verderop op deze pagina zet ze op een rij.
TikTok heeft CompletePayment in mei 2025 hernoemd tot Purchase. TikTok accepteert CompletePayment nog steeds, zet het aan zijn kant om en toont het als Purchase in rapportages, bij het maken van doelgroepen en bij optimalisatie. TikTok zit in elk abonnement van WeProfit, samen met Meta, Google, Pinterest, Snapchat, X Ads, Microsoft (pilot), Reddit, LinkedIn en Taboola.
TikTok koppelen in WeProfit
Koppel eerst je Shopify-webshop en zet de app-embed van WeProfit aan, zodat events uit je webshop bij WeProfit binnenkomen. Voor verzending naar TikTok heb je twee waarden uit TikTok nodig: de pixel-ID, die TikTok ook de pixelcode noemt, en een toegangstoken voor de Events API. Een TikTok-advertentieaccount is voor de verzending niet nodig; dat heb je alleen nodig om advertentie-uitgaven te importeren.
- Beweeg in TikTok Ads Manager de muis over ‘Tools’, open ‘Events Manager’ en kies je websitepixel. Kopieer de pixel-ID.
- Open het tabblad ‘Settings’ van de pixel, scrol omlaag naar ‘Events API’ en klik op ‘Generate Access Token’. Kopieer het token.
- Open in WeProfit ‘Advertentienetwerken > TikTok’ en kies ‘Bestemming toevoegen’. Vul de pixel-ID (pixelcode) en het toegangstoken voor de Events API in. Een label is optioneel en handig als je meer dan één pixel koppelt.
- Laat ‘Voorwaarden’ leeg om elk in aanmerking komend event te versturen, of voeg voorwaarden toe, zoals land, event, bestelwaarde, product, pagina-URL of campagne, om te beperken wat deze pixel ontvangt. Kies daarna ‘TikTok koppelen’.
- Wil je eerst testen, open dan in TikTok Events Manager ‘Test Events’ voor de pixel, kopieer de testeventcode naar het veld ‘Testeventcode’ van de bestemming, sla op en kies ‘Test verzenden’. WeProfit toont of TikTok de test heeft geaccepteerd.
- Zolang er een testeventcode is ingesteld, gaat elk live event van die pixel naar de testtool van TikTok en telt het mogelijk niet mee voor je advertenties. WeProfit toont ‘Testmodus aan’ en zet de code 24 uur na het instellen uit; wis de code als je klaar bent met testen, dan gaan de events weer live.
Welke events uit je webshop bereiken TikTok?
Bij Shopify legt de app-embed van WeProfit paginaweergaven, productweergaven en toevoegingen aan de winkelwagen in je webshop vast, en de webpixel van WeProfit legt de stappen van de checkout vast. WeProfit stuurt ze vanaf zijn server naar TikTok zodra het ze verwerkt. Aankopen komen uit de bestelwebhook van Shopify, en de aankoop van elke bestelling gaat hoogstens één keer naar elke gekoppelde pixel.
Events uit je webshop komen via de app-proxy van Shopify op het eigen domein van je webshop bij WeProfit binnen, dus blokkeerlijsten die zich op trackingdomeinen richten, houden ze meestal niet tegen. Dat betekent niet dat elk bezoek wordt vastgelegd.
Zoekopdrachten, leads, aanmeldingen en aangepaste events bereiken TikTok alleen als je site ze met de track-aanroep van WeProfit verstuurt; bij Shopify worden ze niet automatisch vastgelegd. Een aangepast event gaat onder zijn eigen naam, ingekort tot 64 tekens. Leads gaan als SubmitForm, dat TikTok in mei 2025 heeft hernoemd tot Lead en op dezelfde manier omzet als CompletePayment. Terugbetalingen, verwijderingen uit de winkelwagen en events van de verzendstap worden niet naar TikTok gestuurd, en niets trekt een aankoop in die TikTok al heeft ontvangen.
Elke aankoop bevat het totaalbedrag van de bestelling zoals Shopify het rapporteert, in de valuta van de bestelling, de producten als bestelregels met hun ID, aantal, stuksprijs en titel, en de bestel-ID van Shopify. Controleer in TikTok Events Manager welke van deze events je pixel ontvangt.
| Event in de webshop | Event bij TikTok |
|---|---|
| Page view | Pageview |
| Product or content view | ViewContent |
| Search | Search |
| Add to cart | AddToCart |
| Checkout started | InitiateCheckout |
| Payment information added | AddPaymentInfo |
| Purchase | CompletePayment |
| Lead | SubmitForm |
| Sign up | CompleteRegistration |
Klantgegevens die met elk event meegaan
Om TikTok te helpen een event aan een TikTok-gebruiker te koppelen, stuurt WeProfit de gegevens mee die het event heeft. Bij een Shopify-aankoop zijn dat het e-mailadres en het telefoonnummer van de koper uit de bestelling, gehasht met SHA-256, en het IP-adres en de user-agent. Als WeProfit ze heeft, stuurt het ook de klik-ID van TikTok (ttclid), de cookie _ttp en een externe ID mee, een SHA-256-hash van de bezoekers-ID van WeProfit. TikTok krijgt van WeProfit geen namen of adressen.
Browser-events bevatten geen e-mailadres of telefoonnummer, tenzij je site de klant identificeert met de identify-aanroep van WeProfit, en de Shopify-webpixel van WeProfit stuurt geen klantgegevens. Het IP-adres en de user-agent gaan ongehasht mee, zoals de Events API verwacht.
TikTok voegt de klik-ID ttclid aan de URL van je landingspagina toe als iemand op je advertentie klikt, en WeProfit leest hem daar uit. De cookie _ttp komt van de eigen pixel van TikTok: WeProfit laadt die pixel niet, dus de cookie bestaat alleen als je webshop de pixel zelf draait.
TikTok-pixel en Events API: voorkom dat je dubbel telt
TikTok telt een browserkopie en een serverkopie van hetzelfde event één keer als beide dezelfde pixel bereiken met dezelfde eventnaam en dezelfde event-ID. TikTok houdt de eerste kopie die binnenkomt en voegt latere kopieën die binnen 48 uur binnenkomen samen of laat ze vallen.
WeProfit laadt de pixel van TikTok niet. Het stuurt de events voor TikTok alleen vanaf zijn server, elk met een eigen event-ID. Een aankoop wordt verstuurd als pur_ gevolgd door een webshopcode en de bestel-ID van Shopify, zoals pur_a1b2c3d4-6012345678901, één keer per bestelling en pixel, en een nieuwe poging gebruikt die ID opnieuw.
Een andere tool die naar dezelfde pixel stuurt, zoals de eigen app van TikTok voor Shopify of pixelcode in je thema, rapporteert eigen event-ID’s. Die zijn niet gelijk aan die van WeProfit, dus TikTok kan de twee kopieën niet op event-ID koppelen en kan het event dubbel tellen. De TikTok-app voor Shopify deelt de events van je webshop bijvoorbeeld met je pixel op het niveau voor gegevens delen dat je kiest: Standard gebruikt de TikTok-pixel, en Enhanced en Maximum voegen de Events API toe.
Zet elke tool die events naar een pixel stuurt op een rij voordat je die pixel koppelt, en bepaal welke tool elk event verstuurt. Houd per pixel één verzender van aankopen en vergelijk daarna een testaankoop in TikTok Events Manager met het verzendlog van WeProfit.
Controleer de verzending in het CAPI-verzendlog
Open in WeProfit ‘Advertentienetwerken > TikTok’ en scrol naar het CAPI-verzendlog. Daarin staat elk server-side event dat naar TikTok is gestuurd, met de kolommen ‘Aangemaakt’, ‘Event’, ‘Bestemming’, ‘Event-ID’, ‘Status’, ‘Pogingen’ en ‘Fout’, en je kunt filteren op bestemming, event en status. Het filter voor Purchase vindt ook CompletePayment.
Het log toont de eigen event-ID van WeProfit, zoals pur_6012345678901; TikTok ontvangt die met de webshopcode, zoals pur_a1b2c3d4-6012345678901. Het log heeft geen kolom voor de waarde, dus controleer de waarde van een aankoop op de pagina ‘Events’ in WeProfit. De pagina ‘Bestellingen’ toont in de kolom ‘Netwerken’ de verzending van elke bestelling per gekoppeld netwerk, en de widget ‘Trackingstatus’ telt de server-side verzendingen van de afgelopen 24 uur als ‘Verzonden’, ‘Onderweg / nieuwe poging’ en ‘Mislukt’.
De status ‘verzonden’ betekent dat TikTok het event heeft geaccepteerd. Dat bewijst niet dat TikTok het aan een gebruiker heeft gekoppeld of de bestelling aan een advertentie heeft toegeschreven. Weigert TikTok het toegangstoken, dan pauzeert WeProfit de koppeling en toont het een banner; een nieuw token of een geslaagde ‘Test verzenden’ zet de koppeling weer aan.
| Status | Wat het betekent |
|---|---|
| openstaand | In de wachtrij en nog niet verzonden. |
| verzonden | TikTok heeft het event geaccepteerd. |
| mislukt | Een tijdelijk probleem. WeProfit doet een paar uur lang automatisch nieuwe pogingen, met dezelfde event-ID. |
| definitief mislukt | WeProfit is gestopt: TikTok heeft het event geweigerd, met de melding in de kolom ‘Fout’, of de pogingen zijn op. |
| overgeslagen (uitgeschakeld) | De bestemming was uitgeschakeld of gepauzeerd toen het event aan de beurt was. Events die worden overgeslagen terwijl de bestemming uitstaat, worden later niet alsnog verstuurd. |
| overgeslagen (vóór installatie) | De aankoop van een bestelling die is geplaatst voordat WeProfit werd geïnstalleerd. Die wordt nooit verstuurd. |
TikTok-advertentie-uitgaven naast je bestellingen
Conversieverzending en advertentie-uitgaven zijn aparte koppelingen. Wil je de uitgaven van TikTok in je winstrapportages, open dan in WeProfit ‘Winst > Advertentie-uitgaven > Advertentieaccounts’, kies ‘Advertentieaccount koppelen’ en kies TikTok Ads. ‘Koppelen met TikTok’ vraagt om toegang met alleen leesrechten; kies daarna de adverteerdersaccounts en of alle campagnes of alleen geselecteerde campagnes meetellen voor deze webshop.
WeProfit importeert de dagelijkse uitgaven van TikTok per campagne, met campagnenamen: 30 dagen bij het koppelen, en daarna leest het elk uur de afgelopen 3 dagen opnieuw in, omdat TikTok die nog kan bijwerken. Uitgaven in een andere valuta worden tegen de referentiekoers van die dag omgerekend naar je webshopvaluta.
Uitgaven worden per campagne en dag opgeslagen, dus ROAS, POAS en winst na advertenties gaan tot op campagneniveau, niet tot op advertentiegroepen of advertenties. Bij ‘Attributie’ koppelt de campagnewinst gesynchroniseerde TikTok-uitgaven op campagne-ID of campagnenaam aan toegeschreven bestellingen. Voer je voor dezelfde dagen ook handmatig TikTok-uitgaven in, dan waarschuwt WeProfit dat die dubbel kunnen tellen.
Campagnedetails uit je TikTok-advertenties
WeProfit rekent een bezoek tot TikTok Ads als het de klik-ID ttclid van TikTok bevat, of utm_source=tiktok met een betaald medium. Staat URL Auto-attach van TikTok aan, dan leest WeProfit ook de campagne-ID en de campagnenaam. Voor details per advertentiegroep en advertentie voeg je de TikTok-URL-template van WeProfit toe aan de bestemmings-URL van elke advertentie, na het vraagteken. Gebruik voor Smart+-advertenties wpadid=__ADID_V2__ in plaats van wpadid=__CID__.
Templates gelden alleen voor nieuwe klikken. In de eigen attributie van WeProfit telt een advertentieklik 30 dagen mee en wint de meest recente klik, wat werkt als laatste klik met een terugkijkperiode van 30 dagen voor advertentieklikken. TikTok schrijft conversies toe volgens zijn eigen attributie-instellingen, dus de cijfers van TikTok en die van WeProfit kunnen voor dezelfde bestellingen verschillen.
utm_source=tiktok&utm_medium=paid&utm_campaign=__CAMPAIGN_NAME__&utm_term=__AID_NAME__&utm_content=__CID_NAME__&wpcid=__CAMPAIGN_ID__&wpasid=__AID__&wpadid=__CID__&wpplc=__PLACEMENT__