Wat is de Pinterest Conversions API?
Met de Pinterest Conversions API stuur je conversies rechtstreeks naar Pinterest via een server-to-server-koppeling, naast de events die de Pinterest-tag vanuit de browser van de klant stuurt.
Met WeProfit komt een Shopify-aankoop bij Pinterest binnen als checkout, het event van Pinterest voor een voltooide transactie, verstuurd vanaf de servers van WeProfit naar het advertentieaccount dat je koppelt. Het begin van de checkout heeft een eigen event bij Pinterest, initiate_checkout, dus houd die twee uit elkaar als je je rapportages leest.
Pinterest zit in elk abonnement van WeProfit, samen met Meta, Google, TikTok, Snapchat, X Ads, Microsoft (pilot), Reddit, LinkedIn en Taboola.
Pinterest koppelen in WeProfit
Koppel eerst je Shopify-webshop. Voor verzending naar Pinterest heb je twee waarden nodig: de ID van je Pinterest-advertentieaccount en een toegangstoken voor conversies. WeProfit vraagt niet om een tag-ID van Pinterest, en het formulier voor Pinterest heeft geen veld voor een testeventcode.
- Open in Pinterest Ads Manager ‘Conversions’ en daarna ‘Conversions API’, en kies ‘Set up API’. Kies ‘Conversion access token’, kies ‘Generate new token’ en kopieer het token.
- Kopieer de ID van je advertentieaccount: het nummer in de URL van Pinterest Ads Manager. Pinterest toont de ID ook naast een nieuw gegenereerd token.
- Open in WeProfit ‘Advertentienetwerken > Pinterest’ en kies ‘Bestemming toevoegen’. Vul de advertentieaccount-ID en het toegangstoken voor conversies in. Een label is optioneel en handig als je meer dan één advertentieaccount koppelt.
- Laat ‘Voorwaarden’ leeg om elk in aanmerking komend event te versturen, of voeg voorwaarden toe, zoals land, event, bestelwaarde of campagne, om te beperken wat dit advertentieaccount ontvangt. Kies daarna ‘Pinterest koppelen’.
- Kies ‘Test verzenden’. WeProfit verstuurt een testevent met de testvlag van Pinterest en toont of Pinterest het heeft geaccepteerd. Pinterest zet testevents in een sandbox en verwerkt ze niet voor rapportage of optimalisatie; live events hebben de vlag nooit.
Aankopen en checkout-events die naar Pinterest gaan
Vanuit een Shopify-webshop stuurt WeProfit je aankopen naar Pinterest, plus twee checkoutstappen die de webpixel van WeProfit vastlegt: de gestarte checkout en het toevoegen van betaalgegevens. Aankopen komen uit de bestelwebhook van Shopify, en de aankoop van elke bestelling gaat hoogstens één keer naar elk gekoppeld advertentieaccount.
WeProfit stuurt een event alleen naar Pinterest als het een gehasht e-mailadres bevat, of zowel een IP-adres als een user-agent: het minimum dat de API van Pinterest voor een webevent vraagt. Events zonder die gegevens slaat WeProfit over, en een overgeslagen event krijgt geen regel in het verzendlog. Terugbetalingen worden niet naar Pinterest gestuurd, en niets trekt een aankoop in die Pinterest al heeft ontvangen.
Elke aankoop bevat het totaalbedrag van de bestelling zoals Shopify het rapporteert, in de valuta van de bestelling, de producten met hun ID’s, prijzen en aantallen, het aantal artikelen en de bestel-ID van Shopify. Controleer in Pinterest Ads Manager welke events je advertentieaccount ontvangt.
| Event in de webshop | Event bij Pinterest |
|---|---|
| Checkout started | initiate_checkout |
| Payment information added | add_payment_info |
| Purchase | checkout |
Klantgegevens die met elke aankoop meegaan
Om Pinterest te helpen een aankoop aan een Pinterest-gebruiker te koppelen, stuurt WeProfit gegevens uit de Shopify-bestelling mee, gehasht met SHA-256: het e-mailadres en het telefoonnummer van de koper, en de voor- en achternaam, de plaats, de staat of provincie, de postcode en het land uit het verzendadres, of anders uit het factuuradres. Het IP-adres en de user-agent gaan ongehasht mee. Als WeProfit ze heeft, stuurt het ook de klik-ID van Pinterest, epik, en een externe ID mee, een SHA-256-hash van de bezoekers-ID van WeProfit.
Pinterest voegt epik toe aan de URL van een bezoek via je advertentie, en de Pinterest-tag bewaart die in de cookie _epik. WeProfit leest ze allebei uit, maar laadt de Pinterest-tag niet, dus de cookie bestaat alleen als je webshop die tag draait.
Pinterest-tag en Conversions API: voorkom dat je dubbel telt
Pinterest verwijdert een duplicaat als de eventID van het browser-event, verstuurd door de Pinterest-tag, gelijk is aan de event_id van het server-event. Pinterest houdt het eerste event dat binnenkomt en verwijdert duplicaten binnen 48 uur.
WeProfit laadt de Pinterest-tag niet. Het stuurt de events voor Pinterest alleen vanaf zijn server, elk met een eigen event-ID. Een aankoop wordt verstuurd als pur_ gevolgd door een webshopcode en de bestel-ID van Shopify, zoals pur_a1b2c3d4-6012345678901, één keer per bestelling en advertentieaccount, en een nieuwe poging gebruikt die ID opnieuw.
Rapporteert de Pinterest-tag ook aankopen voor hetzelfde advertentieaccount, of een app hem nu heeft toegevoegd of hij in je themacode staat, dan gebruikt hij eigen event-ID’s. Die zijn niet gelijk aan die van WeProfit, dus Pinterest kan de twee kopieën niet koppelen en kan de bestelling dubbel tellen. Houd per advertentieaccount één verzender van aankopen en vergelijk daarna een testaankoop in Pinterest Ads Manager met het verzendlog van WeProfit.
Controleer de verzending in het CAPI-verzendlog
Open in WeProfit ‘Advertentienetwerken > Pinterest’ en scrol naar het CAPI-verzendlog. Daarin staat elk server-side event dat naar Pinterest is gestuurd, met de kolommen ‘Aangemaakt’, ‘Event’, ‘Bestemming’, ‘Event-ID’, ‘Status’, ‘Pogingen’ en ‘Fout’, en je kunt filteren op bestemming, event en status. Het filter voor Purchase vindt ook de checkout-events van Pinterest.
Het log toont de eigen event-ID van WeProfit, zoals pur_6012345678901; Pinterest ontvangt die met de webshopcode, zoals pur_a1b2c3d4-6012345678901. Het log heeft geen kolom voor de waarde, dus controleer de waarde van een aankoop op de pagina ‘Events’ in WeProfit. De pagina ‘Bestellingen’ toont in de kolom ‘Netwerken’ de verzending van elke bestelling per gekoppeld netwerk.
De status ‘verzonden’ betekent dat Pinterest het event heeft geaccepteerd, niet dat Pinterest de bestelling aan een advertentie heeft toegeschreven. Weigert Pinterest het toegangstoken, dan pauzeert WeProfit de koppeling en toont het een banner; een nieuw token of een geslaagde ‘Test verzenden’ zet de koppeling weer aan.
| Status | Wat het betekent |
|---|---|
| openstaand | In de wachtrij en nog niet verzonden. |
| verzonden | Pinterest heeft het event geaccepteerd. |
| mislukt | Een tijdelijk probleem. WeProfit doet een paar uur lang automatisch nieuwe pogingen, met dezelfde event-ID. |
| definitief mislukt | WeProfit is gestopt: Pinterest heeft het event geweigerd, met de melding in de kolom ‘Fout’, of de pogingen zijn op. |
| overgeslagen (uitgeschakeld) | De bestemming was uitgeschakeld of gepauzeerd toen het event aan de beurt was. Events die worden overgeslagen terwijl de bestemming uitstaat, worden later niet alsnog verstuurd. |
| overgeslagen (vóór installatie) | De aankoop van een bestelling die is geplaatst voordat WeProfit werd geïnstalleerd. Die wordt nooit verstuurd. |
Campagnedetails uit je Pinterest-advertenties
WeProfit rekent een bezoek tot Pinterest Ads als het de klik-ID epik van Pinterest bevat, of utm_source=pinterest met een betaald medium. Met de automatische URL-parameters van Pinterest leest WeProfit ook de ID’s van de campagne en de advertentiegroep.
Voor de advertentie-ID en leesbare namen voeg je de Pinterest-URL-template van WeProfit één keer toe voor het hele advertentieaccount: open in Business Manager ‘Ad accounts’, kies je account, open het tabblad ‘Settings’, bewerk ‘Parameter settings’ zodat daar de parameters van de template van WeProfit staan, en kies ‘Save and apply’. Zolang ‘Apply URL parameters automatically to all current and future campaigns’ is aangevinkt, voegt Pinterest ze toe aan de bestemmings-URL’s van je advertenties; UTM-tags die al in een URL staan, overschrijft Pinterest niet. Templates gelden alleen voor nieuwe klikken.
In de eigen attributie van WeProfit telt een advertentieklik 30 dagen mee en wint de meest recente klik, wat werkt als laatste klik met een terugkijkperiode van 30 dagen voor advertentieklikken. Pinterest schrijft conversies toe volgens zijn eigen attributie-instellingen, dus de cijfers van Pinterest en die van WeProfit kunnen voor dezelfde bestellingen verschillen.
utm_source=pinterest&utm_medium=paid&utm_campaign={campaignname}&utm_term={adgroupname}&utm_content={adid}&wpcid={campaignid}&wpasid={adgroupid}&wpadid={adid}