Met de Pinterest-API voor conversies kunnen adverteerders conversies rechtstreeks naar Pinterest sturen via een server-naar-server-verbinding. Conversies die met de Pinterest-API worden geregistreerd, kunnen vervolgens worden gebruikt voor retargeting in campagnes en kunnen worden beoordeeld in conversierapportages voor verbeterde zichtbaarheid van conversies.
Via de Pinterest-API voor conversies kunnen adverteerders het volgende versturen:
Gebeurtenissen kunnen in realtime of binnen een uur na het plaatsvinden en registreren van de gebeurtenis worden ontvangen. Gebeurtenissen die buiten deze periode of als onderdeel van een vertraagde batchgebeurtenis worden ontvangen, worden geteld als offline-conversies.
Door de Pinterest-API voor conversies samen met de Pinterest-tag te gebruiken, maximaliseer je je inzicht in geregistreerde conversies. We raden aan beide oplossingen te gebruiken voor de registratie van conversies. Zo krijg je een volledig overzicht van de prestaties van je conversiecampagne.
De Pinterest-API voor conversies is een van de producten die deel uitmaken van ons Pinterest-API-ecosysteem. Iedereen met een Pinterest Business-account kan de Pinterest-API voor conversies gebruiken, maar krijgt daarmee niet automatisch toegang tot de gehele Pinterest-API.
Het
Iedereen met een Pinterest Business-account heeft toegang tot de Pinterest-API voor conversies.
Om te beginnen moet je eerst een toegangstoken genereren. Een toegangstoken is een tekenreeks die de aangemaakte verzoeken verifieert en terugstuurt naar het juiste gebruikersaccount.
Een toegangstoken genereren:
Als je toegang wilt krijgen tot een account waar je niet de eigenaar van bent, moet je eerst zakelijke toegang instellen.
Conversiegebeurtenissen: alle gebeurtenistypen die op de Pinterest-tag kunnen worden geregistreerd, zijn ook beschikbaar via de Pinterest-API voor conversies. In onze
Voor het instellen van een server-naar-server-
We raden je ten zeerste aan de Pinterest-API voor conversies te gebruiken naast de Pinterest-tag, om ervoor te zorgen dat je conversies worden gemaximaliseerd.
Als je de Pinterest-tag al eerder hebt ingesteld, moet je ervoor zorgen dat de conversies niet twee keer worden geteld (één keer via de Pinterest-tag en nog een keer via de API).
Hiervoor moet je ervoor zorgen dat de parameter event_id wordt teruggestuurd met conversies die worden geregistreerd door zowel de Pinterest-tag als de Pinterest-API voor conversies.
Ons systeem herkent dan dat de event_ids dezelfde zijn en behoudt alleen de eerste geregistreerde conversie. Om ervoor te zorgen dat deze ontdubbeling goed verloopt, geldt voor event_ids het volgende:
Op basis van die gebeurtenis-ID en de event_name verwijdert Pinterest alle dubbele gebeurtenissen uit het bestand, mits (a) de gebeurtenis niet offline heeft plaatsgevonden (de action_source is niet offline) en (b) Pinterest de dubbele gebeurtenissen binnen 48 uur na elkaar ontvangt.
Zodra je de API hebt ingesteld, kun je verifiëren of conversiegebeurtenissen worden ontvangen door het volgende te controleren:
- Log in op je
zakelijke Pinterest-account - Klik in het menu bovenaan op 'Advertenties' en kies 'Conversies'
- Selecteer 'Ontdubbelen' in het menu aan de linkerkant.
Veerkracht is de status van een API voor conversies waarmee het hoogste niveau van signaalmatching en attributie mogelijk is. Met deze aanvullende gegevens kunnen we nauwkeurigere rapportages bieden naarmate het beleid van de advertentiemarkt verandert en evolueert.
Er zijn twee categorieën binnen de veerkrachtstatus: Goed en Slecht. Je veerkrachtstatus is zichtbaar in het gedeelte 'Conversiestatus' in Advertentiebeheer.
Goede veerkracht
Optie 1: Dekking van specifieke ID's
- 90% of meer van de gebeurtenissen zouden een IP/UA moeten hebben
- 10% of meer van de lagere trechtergebeurtenissen hebben een gehasht e-mailadres of MAID
- 10% of meer van de gebeurtenissen hebben een externe ID.
- 90%* of meer van de taggebeurtenissen moeten via CAPI worden ontvangen
Of:
Optie 2: Basismatchpercentage bereikt
Slechte veerkracht
Alle instellingen die niet Goed zijn.
Stuur de volgende signalen om de status van veerkrachtige adverteerder te bereiken.
| API-ID's/signalen | Gewichten/rang |
|---|---|
| client_ip_address + client_user_agent | Hoog |
| em | Hoog |
| external_id | Hoog |
| hashed_maid | Hoog |
| click_id | Hoog |
| fn + ln | Laag |
| ph | Laag |
| ge, bd, ct, st, zp, country | Laag |
*Gewichten/rang op basis van de waarschijnlijkheid dat het matchpercentage wordt verhoogd
Pinterest heeft verschillende integraties van derden om het installatieproces van je API te ondersteunen.
Google Tag Manager - server
Door je Google Tag Manager-account aan Pinterest-API voor conversies te koppelen, krijg je inzicht in de mate waarin Pinterest van invloed is op het webverkeer naar je winkel en de verkoop van je producten.
Voor deze integratie moet je een servercontainer implementeren via je gebruikelijke cloudprovider en moet je weten hoe je met tags werkt op de server.Bezoek de
Shopify
Deze API voor conversie-integratie is een aanvulling op de Pinterest-tag die een goede gegevensdekking en hoge kwaliteit garandeert. Wanneer de Shopify-app is geïnstalleerd, hoef je verder niets te doen om van deze verbetering gebruik te maken. De wijzigingen worden automatisch toegepast op de winkel van de verkoper.
Tealium
Adverteerders die geïnteresseerd zijn in Tealium kunnen de API voor conversies rechtstreeks bij de externe partij instellen. Tealium maakt de sjabloon en helpt de integratie bij de adverteerder te vergemakkelijken.
Het installatieproces is beschreven in
Heb je interesse in aanvullende integraties van derden? Neem dan contact op met je verkoopvertegenwoordiger voor meer informatie.
Vanaf 1 januari 2023 kunnen adverteerders gebruikmaken van een markering voor 'Beperkte gegevensverwerking', zodat ze kunnen voldoen aan de California Consumer Privacy Act, zoals gewijzigd door de California Privacy Rights Act (samen: CCPA). Pinterest gebruikt deze markering om het gebruik van bepaalde gegevens te beperken, zodat adverteerders rekening kunnen houden met de privacyinstellingen van gebruikers. Een adverteerder kan bijvoorbeeld de markering 'Beperkte gegevensverwerking' toepassen voor gebruikers in Californië die zich hebben afgemeld voor de verkoop of het delen van hun gegevens in het kader van de CCPA. Wanneer de markering 'Beperkte gegevensverwerking' wordt gebruikt, fungeert Pinterest in het kader van de CCPA als dienstverlener met betrekking tot gemarkeerde gegevens van gebruikers in Californië.
Adverteerders moeten gevolg geven aan de uitschrijvingen van gebruikers en nagaan wat de woonplaats van de gebruiker is bij de implementatie van het 'Limited Data Processing'-vlaggetje.