Pinterest Conversions API via je servercontainer

De Conversions API van Pinterest ontvangt dezelfde events als de Pinterest-tag, vanaf je server, en matcht ze op gehasht e-mailadres, de click-ID-cookie _epik , IP-adres en user agent. De setup vanuit Measurebase kost één tag aan elke kant.

Wat je nodig hebt

• Tag-ID: Pinterest Ads Manager → Conversions → Pinterest tag.
• Adverteerder-ID: in de URL van Ads Manager, of onder Business access.
• Conversion access token: Ads Manager → Conversions → Conversions API → Generate token.

Stap 1 · Voeg het toe aan je meetopzet

Open het domein in je dashboard, ga naar de pagina Settings en zoek Measurement setup. Vink de kaart van de bestemming aan en vul de ID's hieronder in. Tokens en API-sleutels worden versleuteld opgeslagen, buiten de setup zelf. De setup verstuurt zelf niets: het is de referentie waar de tracking audit en de templatebouwer van uitgaan, dus wat je hier invult is wat de audit in je containers verwacht te vinden.

Stap 2 · Genereer en importeer de containers

Ga naar Resources → GTM templates in het dashboard. Vink onder Destinations het platform aan (Google Analytics 4 en de e-commerce-events staan standaard aan; kies de Shopify-, WordPress- of Shopware-datalayer als je site een van onze plugins draait). Vul in de volgende stap dezelfde ID's in, kies Web + server onder Containers en download de twee JSON-bestanden.

Open in Google Tag Manager elke container, ga naar Admin → Import Container, kies het bijbehorende bestand, kies een nieuwe workspace en Merge. De import voegt alleen toe: nieuwe tags, triggers en variabelen met eigen namen, plus de galerijtemplates die ze nodig hebben. Controleer het resultaat in Preview en publiceer dan.

Stap 3 · Wat de import bevat

Webcontainer: de template Pinterest Tag uit de galerij met Pinterest - Page Visit en Pinterest - Purchase, een constante met je tag-ID en de variabele Unique Event ID.

Servercontainer: de template Pinterest Conversion API (Stape, uit de galerij) als één tag die naar elk GA4-event luistert en de eventnamen zelf koppelt: page visit, view item, add to cart, checkout en de rest, met waarde, valuta, gehasht e-mailadres, IP-adres en user agent.

Stap 4 · Eén event-ID voor browser en server

Een platform dat hetzelfde event van een browserpixel én van een servertag ontvangt, telt het dubbel, tenzij beide hetzelfde event-ID dragen. De import regelt dat: de variabele Unique Event ID maakt één ID per event in de webcontainer, de GA4-eventinstellingen sturen het naar je servercontainer als event_id, en zowel de pixeltag als de servertag sturen diezelfde waarde mee in hun ontdubbelingsveld. Het platform houdt één kopie en gooit de andere weg.

Met de Shopify-app, de WordPress-plugin of de Shopware-plugin draagt een aankoop die ook server-side wordt doorgestuurd het ordernummer mee als mb_event_id, zodat ook de twee aankoopkopieën aan elkaar gekoppeld kunnen worden.

Pinterest ontdubbelt op eventnaam plus event_id.

Stap 5 · Toestemming

De geïmporteerde tags dragen de toestemmingsinstellingen van de referentiecontainers waaruit ze gekopieerd zijn. Controleer ze tegen je eigen toestemmingsopzet voordat je publiceert: een browserpixel hoort ad_storage te vereisen onder Aanvullende toestemmingscontroles of af te gaan op het event van je toestemmingstool, en de servertags horen alleen te sturen als de hit advertentietoestemming draagt. De toestemmingscontroles van de audit en de gids over tags die afgaan vóór toestemming laten zien hoe je allebei controleert.

Stap 6 · Testen

Ads Manager → Conversions → Test events toont browser- en serverevents zodra ze binnenkomen, met hun match- en ontdubbelingsstatus; de servertag heeft een testveld voor die weergave.

Open aan de Measurebase-kant de pagina Requestlogs: als je door je site klikt, zie je GA4-events met een groene 200 bij je servercontainer binnenkomen. Open de previewmodus van de servercontainer om de servertag op die events te zien afgaan, met het event-ID en de gebruikersgegevens die hij oppikte.

Click-ID's en cookies

Safari stript epik uit landings-URL's. De schakelaar Pinterest in Click ID Restorer vangt hem op in een first-party cookie zodra de bezoeker landt en herstelt hem op latere requests. Cookie Keeper houdt de cookie _epik voorbij de 7-dagenlimiet van Safari.

Wat de tracking audit controleert

Elke nacht vergelijkt de tracking-audit je meetopzet met je live containers en je site. Voor elke bestemming controleert hij dat de tags bestaan in de container die je opzet verwacht, dat het ID in de container overeenkomt met dat in je opzet, dat een browserpixel en zijn servertag een event-ID delen, en welke cookies van het platform nog gezet worden nadat een bezoeker weigert. Bevindingen openen een melding de eerste keer dat ze verschijnen; wat de audit kan herstellen, stelt hij voor als wijziging in een aparte Measurebase-workspace in je container.

Veelgestelde vragen

Maar twee browserevents, en wel elk serverevent?

Dat volgt de referentiecontainer: de browsertag dekt paginabezoeken en aankopen, de servertag rapporteert de hele funnel. Voeg browserevents toe door de aankooptag te kopiëren als je ze als paren ontdubbeld wilt hebben.