Met de Pinterest Conversie-API kunnen gebeurtenissen vanaf jouw server naar de Pinterest-server worden verzonden. Je kan hiermee de event tracking, attributie en gegevensverzameling voor Pinterest verbeteren.
Hoewel de Pinterest Conversie-API hetzelfde doel heeft als een Pinterest-tag, maken ze beide gebruik van andere technologieën. Dankzij het beleid en de beperkingen is de Pinterest Conversie-API beter afgestemd en toekomstbestendiger voor de behoeften van de toekomstige meetwereld. Bij de API is de browser van de gebruiker niet betrokken bij het verzenden van de trackingsinformatie: alles verloopt via een cloudserver (SST).
De Pinterest Conversie-API stelt je in staat om:
- Gebruikers te tracken die AdBlockers hebben geïnstalleerd en/of bijvoorbeeld een browser met slimme tracking preventie algoritmen gebruiken, zoals Safari. Dit is mogelijk omdat de verzoeken via de API vanaf een server worden verzonden, niet vanaf de browser van de gebruiker (client side), waardoor cookies van derden niet worden geblokkeerd. Zo houd Pinterest veel meer data over.
- Een langere levensduur van cookies te bereiken, tot wel 6 maanden, in vergelijking met 1-7 dagen wanneer je de API niet gebruikt en bijvoorbeeld een browser zoals Safari de levensduur van cookies beperkt.
- Meer controle over je gegevens en een dieper inzicht in je Pinterest advertenties te krijgen. Je kan de Pinterest Conversie-API namelijk ook gebruiken om gebeurtenissen te volgen die niet op je site plaatsvinden, zoals chats die via een externe tool gemeten worden of offline verkopen.
In deze uitleg ontdek je hoe je de Pinterest Conversie-API zelf kan installeren. We gaan ervan uit dat de Pinterest-tag al is geïnstalleerd. Mocht dit niet het geval zijn, dan hebben we daar deze uitleg voor.
Snel naar
Voordat we aan de slag gaan
We zullen de server Google Tag Manager container gebruiken om Pinterest Conversie-API in te stellen. Je hebt het volgende nodig om de Pinterest CAPI in te stellen:
- Geconfigureerde Google Tag Manager webcontainer (GTM).
- Geconfigureerde Google Tag Manager servercontainer (sGTM).
- Google Analytics 4 server-side tracking of een alternatief (hierover later meer).
- Een ingestelde Pinterest-tag in je Pinterest ad account. Heb je die nog niet? Bekijk dan deze uitleg om dit in orde te maken.
De Pinterest Conversie-API installeren met server-side Google Tag Manager (sGTM) in 3 stappen
Stap 1: Pinterest Conversie-API toegangstoken aanmaken
- Ga naar de Pinterest Ads Manager.
- Kies je juiste ad account, ga onder het kopje Bedrijf beheren naar Conversies.
- Ga in het menu naar Conversies-API en kies vervolgens de Nieuw token generen
- Klik op Generate Access Token.
- Kopieer het toegangstoken naar je klembord en/of sla het even ergens los op zodat je dit in de vervolgstap gemakkelijk bij de hand hebt.
Stap 2: Maak de Pinterest Conversie-API tag aan in sGTM
- Ga naar je server container in GTM. Deze herken je omdat een server container een ander menu heeft aan de linkerkant, waar onder andere Clienten en Transformaties in terug te vinden zijn. Een web container heeft dat niet.
- Ga via het menu naar Tags. Klik op Nieuw om een tag toe te voegen.
- Klik op tag configuratie en ga bij Kies tag type naar de Community Template Gallery.
- Zoek op Pinterest API for Conversions Tag.. Voeg de template toe aan je werkruimte.
- Geef de tag een logische naam, zoals “Pinterest CAPI – Alle events”.
- Voeg de Advertiser ID toe. Sla deze op in een constant variabele voor eenvoudig hergebruik. Klik op het plusje in het veld van Advertiser ID. Kies bij “Kies een variabele” voor het plusje rechtsboven om een nieuwe variabele toe te voegen.
- Geef de variabele een logische naam, zoals “Pinterest – Advertiser ID”.
- Kies onder variabeleconfiguratie voor het type constant.
- Vul in het veld “waarde” de advertiser ID in. De advertiser ID kun je terugvinden in je webcontainer in Google Tag Manager. Deze heb je als het goed is al in de Pinterest-tag uitleg daar toegevoegd, anders kun je dat daar nog teruglezen. Klik op opslaan.
- Voer het toegangstoken dat je in stap 1 bij Pinterest hebt aangemaakt in bij het API Access token veld. Ook voor de access token kun je een constant variabele aanmaken waarmee je de token eenvoudig kan hergebruiken binnen je sGTM container.
- Voeg een trigger toe. Voor deze instructie gebruiken we de al bestaande trigger van GA4 (waarschijnlijk heeft deze de naam in de trant van “GA4 Client events”).Hiermee sturen we alle GA4 events door naar Pinterest.
- De instelling Event name kun je op Inherit from client laten staan. Je kan er ook voor kiezen om niet alle GA4 events naar Pinterest te sturen. In dat geval kies je voor de optie Override client. Daar selecteer je dan een specifiek event, zoals purchase. Je dient dat ook de trigger aan te passen zodat deze tag alleen afvuurt bij een purchase event. Voor meeste implementaties zal inherit from client volstaan, maar mocht je twijfels hebben dan kun je altijd even contact opnemen.
- Druk op Opslaan.
Stap 3: Controleer of de Pinterest CAPI werkt
Nu is het tijd om te controleren of alles goed werkt.
- Open de voorbeeldmodus in de server Google Tag Manager.
- Voer je website-URL in (of deze staat er al in).
- Klik op verbinden/connect. Je website wordt nu geopend, samen met de voorbeeldmodus van Google Tag Manager. Werkt de voorbeeldmodus niet? Zorg dat je ook de voorbeeldmodus van je webcontainer hebt draaien, waarna je de voorbeeldmodus van je server container openzet.
- Controleer in de voorbeeldmodus van de server of de Pinterest Conversie-API tag wordt geactiveerd/afgevuurd.
- Wordt deze tag goed afgevuurd? Vergeet dan niet op verzenden/publiceren te klikken in je server Google Tag Manager container.
- Controleer in Pinterest onder conversies of je daar ook de events ziet doorkomen. Let op: Het kan even duren voordat dit doorkomt.
De Pinterest events worden nu server-side gemeten via de Events API en client side via de tag.
Vervolgstappen
- Ga aan de slag met het Pinterest Event Deduplication om ervoor te zorgen dat Pinterest events niet dubbel meet.
FAQ
- Wat is het verschil tussen de _epik en _derived_epik cookies van Pinterest?
Het verschil tussen de cookies _epik en _derived_epik van Pinterest ligt in hoe en wanneer ze worden geplaatst en welke informatie ze bevatten. _epik: Deze cookie wordt geplaatst wanneer iemand op een Pinterest-advertentie klikt en vervolgens op je website terecht komt. De Pinterest-tag haalt informatie uit de URL (zoals trackingparameters) en slaat deze op in de _epik-cookie om de gebruiker te identificeren en conversies te meten. _derived_epik: Deze cookie wordt geplaatst wanneer Pinterest een gebruiker kan identificeren zonder gebruik te maken van cookies, bijvoorbeeld via Enhanced Match (zoals e-mailadres of andere identifiers). Deze cookie helpt bij het herkennen van gebruikers op toekomstige pagina’s, zelfs als er geen cookies aanwezig zijn. - Moet ik de _derived_epik cookie meesturen voor server-side tagging?
Nee, het is een client-side cookie, die niet nodig is voor server-side tagging. - Wat is Enhanced Match van Pinterest?
Aanbevolen voor betere gebruikersidentificatie zonder cookies.
Bronnen
- Pinterest officiële documentatie: Starten met de Events API
https://help.pinterest.com/nl/business/article/the-pinterest-api-for-conversions