TikTok Pixel installeren via Google Tag Manager

De TikTok Pixel installeer je via Google Tag Manager met het officiële template van TikTok uit de Community Template Gallery. Je maakt één tag voor de basiscode met je pixel-ID en extra tags voor de standaardevents, zoals CompletePayment of SubmitForm. Die laat je afgaan op events uit je dataLayer.

Het template regelt geen toestemming. Laat de tags dus pas afgaan nadat de bezoeker marketingcookies heeft geaccepteerd.

Een pixel aanmaken in TikTok Events Manager

1. Ga in TikTok Ads Manager naar Events Manager en maak een nieuwe webdatabron (pixel) aan.
2. Kies voor handmatige installatie of installatie via een partner. Voor GTM kun je beide gebruiken: de partnerroute zet de tag voor je in de container, handmatig houd je zelf de controle.
3. Noteer het pixel-ID. Dat heb je in GTM nodig.

Het TikTok Pixel-template in Google Tag Manager configureren

1. Ga naar Templates → Tagtemplates → Galerij doorzoeken en zoek het template van TikTok. De broncode staat ook openbaar op GitHub (tiktok/gtm-template-pixel).
2. Maak een tag met dit template, vul het pixel-ID in en kies als event de paginaweergave.
3. Koppel een trigger voor alle pagina's, met een consentvoorwaarde (zie hieronder).

Let op: staat de TikTok-code ook al via een plugin of thema-integratie op je site, verwijder die dan. Twee keer de basiscode betekent dubbele events.

Standaardevents koppelen aan dataLayer-events

Voor elk standaardevent maak je een extra tag met hetzelfde template, met het event en de parameters die TikTok verwacht. De trigger is een aangepast event uit je dataLayer.

dataLayer-event     TikTok-event        Parameters
add_to_cart         AddToCart           value, currency, content_id
begin_checkout      InitiateCheckout    value, currency
purchase            CompletePayment     value, currency, content_id
generate_lead       SubmitForm          -

Lees de parameters uit met dataLayer-variabelen, bijvoorbeeld ecommerce.value en ecommerce.currency. Gebruik voor de valuta de ISO-code, zoals EUR.

Koppeling van dataLayer-events aan TikTok-standaardevents via tags in Google Tag Manager.

Consent en Limited Data Use

Het officiële template documenteert geen eigen consentfunctionaliteit. Blokkeer de tags daarom in GTM tot er toestemming is. Met consent mode zet je in elke TikTok-tag onder Consentinstellingen de aanvullende toestemming ad_storage. Zonder consent mode laat je de tags afgaan op het event dat je cookiebanner na akkoord in de dataLayer zet.

TikTok heeft daarnaast Limited Data Use (LDU). Die functie is bedoeld voor privacywetgeving in een aantal Amerikaanse staten. Gebruik LDU niet als vervanging van toestemming onder de AVG of de Telecommunicatiewet.

Testen met Pixel Helper en Test events

1. Installeer de browserextensie TikTok Pixel Helper en open je site. De extensie toont welke pixel en welke events afgaan.
2. Gebruik in Events Manager het onderdeel Test events om binnenkomende events live te zien.
3. Controleer in de GTM Preview-modus dat de tags vóór toestemming niet afgaan en erna wel.

Komt een event wel in de Pixel Helper maar niet in Test events, controleer dan of je in Events Manager naar de juiste pixel kijkt.

Veelvoorkomende fouten

• Waarde als tekst: stuur value als getal, zonder valutateken of duizendtalscheiding;
• event op de verkeerde trigger: een CompletePayment op een paginaweergave van de bedankpagina telt ook bij herladen;
• basiscode ontbreekt: een eventtag zonder basistag op dezelfde pagina stuurt niets door.