TikTok Marketing Suite

Versie v1.2.0
Platform Magento 2
Module uitgebracht 3 November 2026

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:

  1. Ga naar TikTok Ads Manager
  2. Ga naar Assets → Events
  3. Selecteer je Pixel
  4. 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:

  1. Ga naar TikTok Events Manager
  2. Selecteer je Pixel
  3. Ga naar Settings → Events API
  4. 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:

  1. Ga naar TikTok Events Manager → Data Sources → Je Pixel → Test Events
  2. Kopieer de Test Event Code
  3. Voer deze in dit veld in
  4. Voer acties uit in je winkel
  5. 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.

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
E-mail ✓ ✓ 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:

  1. Event vindt plaats → Toegevoegd aan queue (status: pending)
  2. Cron draait elke 5 minuten → Verwerkt pending events
  3. Succes → Status bijgewerkt naar "success"
  4. 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:

  1. Ga naar Marketing → Magmodules TikTok → Processing Queue
  2. Filter op Status = Failed
  3. Controleer foutmeldingen
  4. Los configuratieproblemen op indien nodig

Verifieer in Events Manager

Na setup, verifieer events in TikTok:

  1. Ga naar Events Manager
  2. Selecteer je Pixel
  3. Controleer "Overview" voor recente events
  4. Gebruik "Test Events" voor real-time debugging

Meer Hulp Nodig?

Documentatie:

Support:

Voor een compleet overzicht van functies en configuratieopties, bekijk Magento 2 TikTok marketing koppeling.

Artikel bijgewerkt:
Download PDF
star star star star star
star star star star star
Gaaf - digital agency
We have tried the integration with SnelStart through several different providers, and this is the only solution that simply works. We needed support on two occasions, and it was provided quickly and professionally. We do recommend this company!
Google 12 May 2026
star star star star star
star star star star star
Andrew Velikiy
Great vendor with handy modules and quick support!
Google 13 Apr 2026
star star star star star
star star star star star
Alexandru-Manuel Carabus
Magmodules sets the bar for Magento module quality and support—we check their catalog first for client feature requests, and they’re our first choice for licenses.
Google 11 Nov 2025
star star star star star
star star star star star
Matt Austin
Possibly the fastest support response times of any Magento Extension vendor. Great extensions too!
Google 09 Sep 2025
star star star star star
star star star star star
Jan Privé
Dankzij de heldere uitleg en snelle reactie van Magmodules kon mijn vraag, en dus mijn Magento-probleem, binnen enkele uren worden beantwoord. Doeltreffend, zonder moeilijke termen, gewoon zo als het zou moeten zijn.... Bedankt!
Google 05 Sep 2025
star star star star star
star star star star star
Denis Metzler
To evaluate a provider, it is not enough to consider only the product offered, but also its after-sales service, such as support and troubleshooting. Magmodules has been extremely satisfactory at all levels on multiple occasions and sets the bar at the top when comparing the competition.
Google 02 Sep 2025
star star star star star
star star star star star
Bleijenberg winkelinrichting en materialen
Goed bereikbaar, reageren snel en denken oplossingsgericht. Een aanrader.
Google 30 Jul 2025
star star star star star
star star star star star
Patrick Verduijn
Magmodules biedt plugins aan die van hoge kwaliteit zijn tegen een goede prijs, waar dit bedrijf in uitblinkt is de bereidheid om de zeldzame feedback & problemen met de plugins te willen onderzoeken, mee te willen denken in het debuggen van problemen en goede oplossingen toe te passen. In mijn decennium ervaring met Magento & 3th parties is Magmodules absoluut een uniqum binnen de markt.
Google 25 Jul 2025
star star star star star
star star star star star
Erik de Groot
Magemodules heeft hele sterke Magento extensies en een proactieve support. Al jaren heel erg tevreden over jullie service en producten!
Google 18 Jul 2025
star star star star star
star star star star star
René Zeuner
We are using the Mollie Magento extension from Magmodules. It works excellently without flaws. Very fast, competent and friendly support. Thanks!
Google 30 Jun 2025