Wanneer je zowel Pinterest data client side als server-side meet, loop je het risico dat sommige events/gebeurtenissen dubbel worden gemeten. Pinterest houdt daarom rekening met de Event ID waarmee ze onderscheid kunnen maken tussen gebeurtenissen afkomstig van de Pinterest-tag en de Pinterest Conversie-API.
Indien er via de-tag en de API het identieke event wordt gestuurd, zal Pinterest het event slechts eenmaal accepteren. Hierdoor krijg je geen dubbele events waardoor campagnes mogelijk beter uit de verf komen dan ze daadwerkelijk zijn.
In deze uitleg leggen we uit hoe een “Event ID” werkt en hoe je deze inzet om Event Deduplication toe te passen bij de Pinterest tags. Dit vereist het instellen van de Event Deduplication voor zowel client side als server-side tracking en gaat er dan ook vanuit dat je deze twee manieren van dataverzameling voor Pinterest tegelijk inzet.
Snel naar
Vooraf aan deze uitleg
- Zorg ervoor dat je de Pinterest-tag geïnstalleerd hebt in de web container van Google Tag Manager.
- Zorg er ook voor dat je de Pinterest conversie-API hebt toegevoegd aan de server container van Google Tag Manager.
Pinterest Event Deduplication instellen met Google Tag Manager in 4 stappen
Voor het gemak kun je het beste je web container (client side) en je de server container (server-side) naast elkaar open zetten, je gaat ze namelijk beide nodig hebben.
Stap 1: Client side deduplication (web container) pas de Pinterest gebeurtenissen aan
We starten met de webcontainer van GTM. We gaan ervan uit dat je de-tag tag hier al geïnstalleerd hebt. Is dat niet zo, volg dan deze uitleg.
- Maak een nieuwe variabele aan. Ga binnen je client side/web GTM container naar variabelen.
- Klik onder “Door de gebruiker gedefinieerde variabelen” op Nieuw om een nieuwe variabele toe te voegen.
- Klik op variabele configuratie en ga naar Variabele typen uit de templategallerij.
- Type in het zoekveld Unique event ID in. Voeg de variabele (van Stape) toe aan de werkruimte. Je hoeft verder niks in te stellen in de variabele voor nu, dat zit al in het template. Het kan zijn dat je deze template al had, je hoeft/kan hem dan niet nog een keer toevoegen.
- Geef de variabele een logische naam, zoals “Unique Event ID”.
- Klik op Opslaan.
- Ga vervolgens binnen de web GTM container naar Tags.
- Zoek de Pinterest-tag en open deze. We gaan er in deze uitleg vanuit dat je de Pinterest tag template hebt gebruikt uit de community bibliotheek van Google Tag Manager. Heb je meer dan één tag (omdat je bijvoorbeeld meerdere events meet)? Pas ze dan allemaal aan met de volgende stappen:
- Bewerk de tag configuratie, ga binnen de tag naar Custom Parameters en klik op Rij toevoegen.
Let op: Bij de base code van de Pinterest-tag hoef je geen unique event ID mee te geven. Je kan die hier dan ook niet toevoegen. - Voeg bij Name “event_id” toe.
- Voeg onder Value het unique event ID toe door op het veld te klikken en een variabele te kiezen. Kies voor Unique event ID (of hoe je deze variabele dan ook eerder hebt genoemd).
- Klik op Opslaan. Herhaal deze stap indien je meerdere Pinterest template tags gebruikt hebt.
- Bewerk de tag configuratie, ga binnen de tag naar Custom Parameters en klik op Rij toevoegen.
Je hebt nu bij al je Pinterest-tags in de webcontainer de event_id toegevoegd.
Stap 2: Zorg dat de unique event ID meegeschoten wordt van de web container naar de server container
We moeten er ook zorg voor dragen dat de Unique Event ID netjes naar de server container geschoten gaat worden via de GA4 client:
- Ga binnen je web container naar Tags en vervolgens naar de Google Tag.
- Voeg onder het kopje Configuration parameter de parameter “event_id” toe.
- Voeg als waarde de variabele “{{Unique Event ID}}” toe, zodat de Event ID ook via de Google Tag naar de server container gestuurd gaat worden.
- Druk op Opslaan.
Stap 3: Server-side deduplication door unique ID bij de CAPI events toe te voegen
Nu de web container (client side) is ingesteld, kunnen we verder met de server container (server-side). Zorg ervoor dat je dus de juiste sGTM container hebt openstaan.
- Maak een nieuwe variabele aan. Ga binnen je server-side GTM container naar variabelen.
- Klik onder “Door de gebruiker gedefinieerde variabelen” op Nieuw om een nieuwe variabele toe te voegen.
- Klik op variabele configuratie en kies Gebeurtenisgegevens (in engels “Event Data”) als variabele type.
- Voeg als Sleutelpad het volgende in: event_id. Dit staat gelijk aan de definitie die je in de web container bij de GA4 configuratie hebt ingesteld.
- Geef de variabele een logische naam, zoals “event_id”.
- Klik op Opslaan.
- Ga vervolgens binnen je (nog steeds server) GTM container naar Tags.
- Zoek de Pinterest conversie-API tag(s) en open deze. Je kan er meerdere hebben, afhankelijk van hoeveel gebeurtenissen (events) je hebt ingesteld. Herhaal de volgende stappen voor iedere Pinterest (event) tag.
- Bewerk de tag configuratie en ga naar het kopje Override client data. Ga naar de sectie Event Data. Klik op Add parameter. Er zal zich nu een rij openen/toevoegen.
- Kies voor de Parameter Name Event ID.
- Kies bij de waarde voor je variabele event_id door op het plusje in het veld te drukken.
- Klik op Opslaan. Herhaal bij andere tags indien je meerdere Pinterest event tags hebt (zie stap 8).
De event_id variabele is nu gekoppeld aan de tag en kunnen we door naar het valideren van de setup.
Stap 4: Test of het werkt
Nu is het tijd om te controleren of alles goed werkt. We gaan kijken of de event_id variabele netjes gevuld terugkomen in beide containers.
- Zet zowel je web container als server container naast elkaar open.
- Open de preview van beide containers, zodat je in de debugmodus komt van de Tag Assistant.
- Trigger het/een Pinterest event in het geopende venster waarin je website staat.
- Controleer eerst in de preview van je web container of je Pinterest-tag voor je event is afgevuurd. Is dit niet het geval? Dan is er waarschijnlijk iets aan de hand met je trigger. Los dit eerst op.
- Klik op de afgevuurde tag en kijk onder Tag details of je de parameter event_id (of hoe je deze dan ook eerder hebt benoemd) ziet terugkomen met een waarde. Is dit het geval? Dan kun je door naar de volgende stap.
- Ga naar de preview van je server container en controleer of hetzelfde event ook is afgevuurd. Is dat niet gebeurd? Dan is er waarschijnlijk iets aan de hand met je custom event trigger. Controleer of deze goed staat.
- Klik op de afgevuurde tag en kijk onder Tag details bij eventData of je daar netjes de event_id met een waarde ziet terugkomen.
- Voor zowel de web container als de server container dient de getoonde waarde van het event_id identiek te zijn. Op deze manier kan Pinterest het ontdubbelen.
Super, je deduplication voor Pinterest gebeurtenissen werkt. Vergeet niet de wijzigingen in beide GTM containers te publiceren na het testen.
FAQ
- Binnen welk tijdvenster ontdubbelt Pinterest de gebeurtenissen?
Pinterest zal een dubbele gebeurtenis binnen 48 uur dat de andere gebeurtenis is tegengekomen ontdubbelen. Ligt de tijdstempel verder uit elkaar dan 48 uur? Dan kan Pinterest het niet ontdubbelen.
Bronnen
- Pinterest ontwikkelaarsplatform documentatie over Event deduplicatie:
Handling duplicate events