TikTok Pixel en Events API Configureren in Magento 2
Op zoek naar Magento 2 TikTok marketing koppeling? Bekijk de volledige Magento 2 TikTok marketing koppeling pagina voor functies, configuratieopties en prijzen.
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 |
| ViewCategory | Categoriepagina wordt bekeken (custom event) |
| CustomizeProduct | Er wordt een optie gekozen op de productpagina (configureerbaar attribuut, custom option, bundel-optie); één keer per paginaweergave |
| AddToCart | Product toegevoegd aan winkelwagen |
| ViewCart | Winkelwagenpagina wordt bekeken (custom event) |
| 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.
ViewCategory en ViewCart zijn geen standaard events van TikTok: TikTok toont ze als custom events, te gebruiken voor custom audiences en custom conversions.
Advanced Matching
Identificeer klanten bij de Pixel met hun gehashte e-mailadres, telefoonnummer en klant-ID (standaard: Ja). Zie Vastgelegde Data.
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 |
| ViewCategory | Categoriepagina wordt bekeken (custom event) |
| CustomizeProduct | Er wordt een optie gekozen op de productpagina; één keer per paginaweergave |
| 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 |
Eventnamen
In mei 2025 heeft TikTok CompletePayment hernoemd naar Purchase en SubmitForm naar Lead. De module verstuurt de nieuwe namen. Oude namen komen nog steeds bij het juiste event uit: een configuratiewaarde of een window.mmTikTokPixel.track()-aanroep vanuit een thema of integratie met CompletePayment of SubmitForm wordt omgezet naar Purchase of Lead. TikTok zet de oude namen zelf ook om, dus bestaande advertentie-optimalisatie blijft werken.
Advanced Matching
Stuur gehashte klantgegevens (e-mail, telefoon, klant-ID, naam, postcode) en plaats, provincie/staat en land mee met Events API-events (standaard: Ja). Zie Vastgelegde Data.
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.
Het Pixel-event en het Events API-event voor dezelfde actie delen één event_id:
| Event | Herkomst van de event_id |
|---|---|
| ViewContent, ViewCategory, Search | Gegenereerd door de Pixel in de browser en naar de winkel gestuurd, die het Events API-event ermee in de wachtrij zet. Werkt ook op pagina's uit de full-page cache. |
| CustomizeProduct | Gegenereerd in de browser bij de eerste gekozen optie, gebruikt voor het Pixel-event en naar de winkel gestuurd voor het Events API-event. |
| AddToCart (productpagina) | Gegenereerd door de Pixel bij de klik op 'In winkelwagen' en meegestuurd met het formulier. |
| InitiateCheckout | Eén keer per winkelwagen gegenereerd en bewaard in de checkout-sessie. |
| Purchase | Afgeleid van het ordernummer, zodat opnieuw versturen met magmodules-tiktok:sync-order dezelfde id gebruikt. |
| AddToWishlist, CompleteRegistration | Gegenereerd bij de actie; het Pixel-event wordt op de volgende pagina met die id verstuurd. |
Controleren: stel een Test Event Code in en kijk in TikTok Events Manager. Een actie hoort één keer te verschijnen, gemarkeerd als gededupliceerd.
Consent
Track alleen bezoekers die toestemming gaven. Stel Consent Source in onder Stores → Configuration → Magmodules → TikTok Marketing → Consent:
| Consent Source | Toestemming is gegeven wanneer |
|---|---|
| Off (always track) | Altijd (standaard, het eerdere gedrag) |
| Magento Cookie Restriction Mode | De bezoeker de melding "Cookies toestaan" accepteerde (cookie user_allowed_save_cookie). Staat Cookie Restriction Mode in Magento uit, dan is er geen melding en wordt altijd getrackt. |
| Cookie name and value | De ingestelde cookie bestaat en de waarde de ingestelde tekst bevat (hoofdletterongevoelig). Voor Cookiebot: cookie CookieConsent, waarde marketing:true. Een lege waarde accepteert elke waarde van de cookie. |
Pixel: start met ttq.holdConsent(). Events worden vastgehouden tot de bezoeker kiest en dan verstuurd met ttq.grantConsent() of verworpen met ttq.revokeConsent(). De keuze wordt opgepikt zodra de consent-banner zijn cookie zet, zonder de pagina te herladen. Het TikTok-script zelf wordt altijd geladen.
Events API: zonder toestemming worden geen events in de wachtrij gezet. ViewContent en Search worden verstuurd zodra op die pagina toestemming wordt gegeven. Voor Purchase wordt toestemming gecontroleerd bij het plaatsen van de bestelling en vastgelegd op de quote, zodat opnieuw versturen met magmodules-tiktok:sync-order de keuze van de klant volgt. Bestellingen zonder bezoeker (bijv. in de admin) worden niet verstuurd zolang toestemming vereist is.
Klantgroepen
Klantgroepen uitsluiten (Stores → Configuration → Magmodules → TikTok Marketing → Customer Groups, veld "Exclude Customer Groups") zet tracking uit voor klanten in de gekozen groepen, bijv. personeel, test- of groothandelsaccounts: de Pixel wordt voor hen niet geladen en er worden geen Events API-events in de wachtrij gezet. Kies NOT LOGGED IN om gasten uit te sluiten.
Voor events die bij een winkelwagen of bestelling horen (AddToCart, InitiateCheckout, AddPaymentInfo, Purchase) telt de groep van de winkelwagen of bestelling; voor CompleteRegistration de groep van het nieuwe account; anders de groep van de bezoeker. De full-page cache bewaart per klantgroep een eigen pagina, dus ook gecachte pagina's volgen de instelling.
Limited Data Use
Limited Data Use (Events API, standaard: Nee) voegt limited_data_use: true toe aan elk Events API-event, zodat TikTok de data verwerkt volgens zijn Limited Data Use-regels, bijv. voor privacywetten van Amerikaanse staten.
Vastgelegde Data
Advanced Matching (Klantgegevens)
Met Advanced Matching ingeschakeld (standaard) worden klantgegevens genormaliseerd meegestuurd, zodat TikTok events aan personen kan koppelen. E-mail, telefoon, klant-ID, namen en postcode worden SHA-256 gehasht voordat ze uw winkel verlaten; plaats, provincie/staat en land worden als platte kleine letters verstuurd, zoals TikTok ze verwacht.
| Data | Pixel (ttq.identify) |
Events API | Bron | Normalisatie |
|---|---|---|---|---|
| ✓ | ✓ | Klantaccount, e-mailveld in checkout, bestelling | kleine letters, getrimd, SHA-256 | |
| Telefoon | ✓ | ✓ | Standaard factuuradres, factuuradres van winkelwagen of bestelling | E.164 (bijv. +31612345678), SHA-256 |
| External ID | ✓ | ✓ | Klant-ID (ingelogde klanten) | SHA-256 |
| Voornaam | ✓ | Adres of klantaccount | kleine letters, getrimd, SHA-256 | |
| Achternaam | ✓ | Adres of klantaccount | kleine letters, getrimd, SHA-256 | |
| Postcode | ✓ | Adres | kleine letters, zonder spaties (VS: 5 cijfers), SHA-256 | |
| Plaats | ✓ | Adres | kleine letters, niet gehasht | |
| Provincie/staat | ✓ | Adres (regiocode) | kleine letters, niet gehasht | |
| Land | ✓ | Adres | ISO-code, kleine letters, niet gehasht |
Het adres is het factuuradres van de bestelling voor Purchase, het checkout-adres voor InitiateCheckout en AddPaymentInfo, en het standaard factuuradres van een ingelogde klant voor de overige events.
De Pixel identificeert ingelogde klanten op elke pagina (apart geladen, zodat full-page caching blijft werken), en gasten in de checkout zodra ze hun e-mailadres invullen en op de bedankpagina.
Advanced Matching heeft een eigen instelling onder Pixel en onder Events API. Uitgeschakeld stuurt de Pixel geen klantgegevens en stuurt de Events API alleen de technische data hieronder. Zorg dat uw privacybeleid het delen van gehashte klantgegevens met TikTok dekt.
Technische Data
| Data | Doel |
|---|---|
| IP-adres | Geo-targeting |
| User Agent | Device targeting |
| _ttp cookie | Cross-device tracking |
| ttclid | TikTok Click ID uit URL |
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
Voor een compleet overzicht van functies en configuratieopties, bekijk Magento 2 TikTok marketing koppeling.