TikTok Pixel & Events API Configuratie

Volledige referentie voor TikTok Pixel en Events API instellingen. Gebruik beide voor optimale tracking nauwkeurigheid.

Locatie: Stores → Configuration → Magmodules → TikTok - Pixel & CAPI

Overzicht

De module ondersteunt twee tracking methoden:

Methode	Type	Beschrijving
TikTok Pixel	Client-side (browser)	JavaScript-gebaseerde tracking op je website
Events API	Server-side	Directe server-naar-TikTok communicatie

Aanbeveling: Schakel beide in voor maximale nauwkeurigheid. Events API vangt events op die Pixel mogelijk mist door ad blockers of browser restricties.

Pixel Configuratie

Enable

Schakel TikTok Pixel tracking in op je winkel.

Pixel ID

Je unieke TikTok Pixel identifier.

Waar te vinden:

Ga naar TikTok Ads Manager
Ga naar Assets → Events
Selecteer je Pixel
Kopieer de Pixel ID uit Settings

Events

Selecteer welke events te tracken via Pixel:

Event	Triggers wanneer
PageView	Elke pagina wordt bekeken
ViewContent	Productpagina wordt bekeken
AddToCart	Product toegevoegd aan winkelwagen
ViewCart	Winkelwagenpagina wordt bekeken
InitiateCheckout	Checkout wordt gestart
AddToWishlist	Product toegevoegd aan verlanglijst
Search	Zoekopdracht wordt uitgevoerd
CompleteRegistration	Klantaccount wordt aangemaakt
Purchase	Bestelling wordt voltooid

Aanbeveling: Schakel alle events in voor complete funnel tracking.

Events API Configuratie

Enable

Schakel server-side event tracking in via Events API.

Access Token

Je TikTok Events API access token (versleuteld opgeslagen).

Waar te vinden:

Ga naar TikTok Events Manager
Selecteer je Pixel
Ga naar Settings → Events API
Klik "Generate Access Token"

Events

Selecteer welke events te tracken via Events API:

Event	Triggers wanneer
ViewContent	Productpagina wordt bekeken
AddToCart	Product toegevoegd aan winkelwagen
AddToWishlist	Product toegevoegd aan verlanglijst
Search	Zoekopdracht wordt uitgevoerd
InitiateCheckout	Checkout wordt gestart
AddPaymentInfo	Betaalmethode wordt geselecteerd
CompleteRegistration	Klantaccount wordt aangemaakt
Subscribe	Nieuwsbrief inschrijving
Lead	Contactformulier inzending
Purchase	Bestelling wordt voltooid

Test Event Code

Optioneel veld voor het testen van je Events API integratie.

Gebruik:

Ga naar TikTok Events Manager → Data Sources → Je Pixel → Test Events
Kopieer de Test Event Code
Voer deze in dit veld in
Voer acties uit in je winkel
Bekijk real-time events in TikTok's Test Events tab

Belangrijk: Verwijder de Test Event Code na het testen!

Hoe Events Worden Getrackt

Pixel Events (Client-Side)

Events vuren via JavaScript wanneer de actie plaatsvindt in de browser:

Klantactie → Browser JavaScript → TikTok Pixel → TikTok

Voordelen: Real-time, vangt client data Nadelen: Geblokkeerd door ad blockers, beïnvloed door browser privacy instellingen

Events API (Server-Side)

Events worden in een queue geplaatst en vanaf je server verstuurd:

Klantactie → Magento Observer → Processing Queue → Cron → TikTok API

Voordelen: Niet beïnvloed door ad blockers, betrouwbaarder Nadelen: Lichte vertraging (queue verwerkt elke 5 minuten)

Event Deduplicatie

Wanneer zowel Pixel als Events API zijn ingeschakeld, gebruikt TikTok event_id om events te dedupliceren, zodat elke actie slechts één keer wordt geteld.

Vastgelegde Data

User Data (Gehasht)

De volgende user data wordt vastgelegd en SHA-256 gehasht voor verzending:

Data	Bron
Email	Klantaccount of checkout
Telefoon	Factuuradres
Voornaam	Klantaccount of factuuradres
Achternaam	Klantaccount of factuuradres
Stad	Factuuradres
Provincie	Factuuradres
Postcode	Factuuradres
Land	Factuuradres

Technische Data

Data	Doel
IP Adres	Geo-targeting
User Agent	Device targeting
_ttp cookie	Cross-device tracking
ttclid	TikTok Click ID van URL
External ID	Customer ID matching

Processing Queue

Events API events worden verwerkt via een queue voor betrouwbaarheid:

Event vindt plaats → Toegevoegd aan queue (status: pending)
Cron draait elke 5 minuten → Verwerkt pending events
Succes → Status bijgewerkt naar "success"
Fout → Tot 3 keer opnieuw geprobeerd, daarna "failed"

Monitor de queue via: Marketing → Magmodules TikTok → Processing Queue

Best Practices

Schakel Beide Pixel en Events API In

Voor maximale event capture rate:

Pixel vangt directe interacties
Events API biedt backup voor geblokkeerde/gemiste events
TikTok dedupliceert automatisch

Selecteer Dezelfde Events voor Beide

Schakel dezelfde events in voor zowel Pixel als Events API instellingen voor complete dekking.

Monitor de Processing Queue

Controleer regelmatig de queue voor gefaalde events:

Ga naar Marketing → Magmodules TikTok → Processing Queue
Filter op Status = Failed
Controleer foutmeldingen
Los configuratieproblemen op indien nodig

Verifieer in Events Manager

Na setup, verifieer events in TikTok:

Ga naar Events Manager
Selecteer je Pixel
Controleer "Overview" voor recente events
Gebruik "Test Events" voor real-time debugging

Meer Hulp Nodig?

Documentatie:

Alle Help Artikelen - Compleet documentatie overzicht

Support:

Contact Opnemen - Hulp van ons team

TikTok Marketing Suite

TikTok Pixel & Events API Configuratie

Overzicht

Pixel Configuratie

Enable

Pixel ID

Events

Events API Configuratie

Enable

Access Token

Events

Test Event Code

Hoe Events Worden Getrackt

Pixel Events (Client-Side)

Events API (Server-Side)

Event Deduplicatie

Vastgelegde Data

User Data (Gehasht)

Technische Data

Processing Queue

Best Practices

Schakel Beide Pixel en Events API In

Selecteer Dezelfde Events voor Beide

Monitor de Processing Queue

Verifieer in Events Manager

Meer Hulp Nodig?

Je vertrouwde Magento en Shopware
plugin partner

Snelle Links

Populaire Plugins

Pagina's

Review Plugins

Magento Boekhoudkoppelingen

Marktplaats Plugins

Ons Bedrijf

Ondersteuning

Kantoor uren

GitHub