DocumentatieExperience PlatformTags

Pinterest extensie voor doorsturen van gebeurtenissen

Last update: Tue Oct 31 2023 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar

Pinterest is een visuele zoekmachine om ideeën zoals recepten, thuisdecor, stijlinspiratie en nog veel meer te vinden. Er zijn miljarden spelden op Pinterest, die ook met anderen kunnen worden gedeeld over Pinterest. U kunt de gebeurtenissen van de gebruikersinteractie en hefboomwerking sorteren Pinterest Analytics om gebruikersgedrag te begrijpen en gerichte reclame in werking te stellen.

De Pinterest Conversies API gebeurtenis doorsturen kunt u gegevens die zijn vastgelegd in het Adobe Experience Platform Edge Network gebruiken en verzenden naar Pinterest. Dit document behandelt de gebruiksgevallen van de extensie, de manier waarop de extensie moet worden geïnstalleerd en de manier waarop de mogelijkheden van de extensie moeten worden geïntegreerd in het doorsturen van de gebeurtenis regels.

De tokens van de toegang van omzettingen zijn de authentificatiemethode die door wordt gebruikt Pinterest bij interactie met de Pinterest API.

Gebruiksscenario’s

Deze extensie moet worden gebruikt als u gegevens van het Edge-netwerk wilt gebruiken in Pinterest om gebruik te maken van de mogelijkheden voor klantanalyse.

Neem bijvoorbeeld een marketingteam in een organisatie. Het team legt gebruikersinteractiegebeurtenisgegevens van zijn website vast en laadt deze in Pinterest gebruiken van deze gebeurtenis die uitbreiding door:sturen.

De marketing- en analyseteams kunnen vervolgens gebruikmaken van Pinterest Analysemogelijkheden om belangrijke gebruikersinteractie en gedrag te begrijpen, die u toestaan om gebruikers beter te begrijpen en hen voor gerichte advertentiecampagnes te richten.

Voor meer informatie over gebruiksgevallen die specifiek zijn voor Pinterest, verwijst u naar de Pinterest use cases documentatie.

Pinterest voorwaarden prerequisites

U moet een geldige Pinterest zakelijke account om deze extensie te gebruiken. Ga naar de Pinterest registratiepagina als u nog geen account hebt, kunt u zich registreren en een account maken.

U hebt ook een Pinterest ontwikkelaarsaccount, dat moet worden gekoppeld aan uw Pinterest zakelijke account. Als u uw ontwikkelaarsaccount wilt koppelen aan uw zakelijke account, raadpleegt u de Pinterest ​ ontwikkelingsaccount.

Verzamel vereiste configuratiedetails configuration-details

Als u het Experience Platform wilt verbinden met Pinterest, zijn de volgende invoeren vereist:

Credentials
Beschrijving
Voorbeeld
Adds-account-id
Uw Pinterest Account-ID toevoegen. Zie de Pinterest documentatie ter begeleiding.
123456789012
Token voor toegang tot conversie
Uw Pinterest Token voor conversietoegang. Zie de Pinterest Conversies-API document ter begeleiding.
U hoeft dit slechts één keer te doen, aangezien deze token niet verloopt.

Installeer en configureer de Pinterest extension install

Als u de extensie wilt installeren, een eigenschap voor het doorsturen van gebeurtenissen maken of kies een bestaande eigenschap die u wilt bewerken.

Selecteer in de linkernavigatie de optie Extensions. Selecteren Install op de kaart voor de Pinterest in de Catalog tab.

Catalogus met de Pinterest extensie Install gemarkeerd.

Vorm Pinterest extension

IMPORTANT
Afhankelijk van uw implementatiebehoeften, kunt u een schema, gegevenselementen, en een dataset moeten tot stand brengen alvorens de uitbreiding te vormen. Controleer alle configuratiestappen voordat u begint om te bepalen welke entiteiten u moet instellen voor uw geval van gebruik.

Selecteer in de linkernavigatie de optie Extensions. Selecteren Configure op de kaart voor de Pinterest in de Installed** tab.

Pinterest extensie die wordt weergegeven in het dialoogvenster Install tab met Configure gemarkeerd.

Voer in het volgende scherm de Ads Account Id en Conversion Access Token die u eerder in configuratiedetails sectie. Als u klaar bent, selecteert u Save.

De Pinterest Configure scherm markeren Ads Account Id en Conversion Access Token invoervelden.

Vorm een gebeurtenis door:sturen regel config-rule

Zodra al uw gegevenselementen opstelling zijn, kunt u gebeurtenis beginnen tot stand te brengen door:sturen regels die bepalen wanneer en hoe uw gebeurtenissen zullen worden verzonden naar Pinterest.

Een nieuwe regel in uw gebeurtenis die bezit door:sturen. Onder Actions voegt u een nieuwe handeling toe en stelt u de extensie in op Pinterest. Edge Network-gebeurtenissen verzenden naar Pinterest, stelt u de Action Type tot Send Event.

De Pinterest Send Event regel maken.

Na selectie, schijnen de extra controles om de gebeurtenis verder te vormen. U moet de Pinterest gebeurteniseigenschappen voor de gegevenselementen die u eerder hebt gemaakt.

Event Data

De volgende gebeurtenisgegevens worden vereist om de nieuwe regel te maken:

Veldnaam
Beschrijving
Voorbeeld
Event Name
Het type van de gebruikersgebeurtenis. Dit kan echter elk gebeurtenistype zijn, zodat u de Pinterest Analytics aanbevolen wordt Pinterest gebeurteniscodes
* uitchecken
* add_to_cart
* pagina_bezoek
* inschrijving
* [Door gebruiker gedefinieerde gebeurtenis]
Action Source
De bron die aangeeft waar de conversiegebeurtenis heeft plaatsgevonden.
* app_android
* app_ios
* web
* offline
Event Time
Dit verwijst naar de tijd van de gebeurtenis. De standaardtijdnotatie die wordt gebruikt, is UNIX, in de notatie <seconds>.<miliseconds> afhankelijk van uw lokale tijdzone. Raadpleeg voor meer informatie de Pinterest API.
1433188255.500 geeft 1433188255 seconden en 500 milliseconden na het tijdperk aan, of maandag 1 juni 2015, 7 juni:50:17:00 GMT.
Event ID
Een unieke id-tekenreeks die deze gebeurtenis identificeert en kan worden gebruikt voor het verwijderen tussen gebeurtenissen die via de API voor conversie en Pinterest-tracking worden opgenomen. Zonder dit zullen de gegevens van de gebeurtenis waarschijnlijk dubbel worden geteld en zal de inflatie in metrische termen worden gerapporteerd.
ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad
Event Properties
Een JSON-object dat aangepaste eigenschappen van de gebeurtenis bevat. Maak een keuze uit het opgeven van onbewerkte JSON of uit het gebruik van een vereenvoudigde set toetsinvoer.
{ "event_source_url": "http://site.com" }

De Pinterest Event Data gemarkeerd in de regelactie.

De volgende gebeurteniseigenschappen kunnen worden geconfigureerd:

Veldnaam
Beschrijving
URL van gebeurtenisbron
URL van de webconversiegebeurtenis.
Toepassingsarchief-id
De toepassings-id van de App Store.
Toepassingsnaam
De naam van de toepassing.
Toepassingsversie
De versie van de toepassing.
Merk apparaat
Merk apparaat dat door de gebruiker wordt gebruikt.
Apparaatdrager
De mobiele provider van de gebruiker voor het apparaat.
Apparaatmodel
Model van het apparaat van de gebruiker
Apparaattype
Type apparaat dat door de gebruiker wordt gebruikt.
Versie besturingssysteem
Versie van het besturingssysteem van het apparaat.
Taal van gebruiker
ISO-639-1-taalcode van twee tekens die de taal van de gebruiker aangeeft.

User Data

De volgende gebruikersgegevens kunnen worden ingevoerd door zijn geen vereiste velden:

Veldnaam
Beschrijving
Voorbeeld
Email
E-mailadres van gebruiker of een SHA256-hash van het e-mailadres van de gebruiker.
ebd543592.f2b7e1
Mobile Adverstising IDs
Sha256 hashes of "Google Advertising IDs" (GAIDs) of "Apple Identifier for Advertisers" (IDFAs) van gebruikers
ebd543592.f2b7e1
Client IP Address
Het IP-adres van de gebruiker. Dit kan de IPv4- of IPv6-indeling hebben. Wordt gebruikt voor overeenkomsten.
192.168.0.1
Client User Agent
De userAgent-tekenreeks van de webbrowser van de gebruiker.
Mozilla/5.0 (platform; rv:geckoversion) Gecko/geckotrail Firefox/firefoxversion
Customer information data
Een JSON-object dat andere klantgegevens bevat. Maak een keuze uit het opgeven van onbewerkte JSON of uit het gebruik van een vereenvoudigde set toetsinvoer.
{ "ph": "122333445" }

De Pinterest User Data gemarkeerd in de regelactie.

De eigenschappen van de klanteninformatie die kunnen worden gevormd zijn:

Veldnaam
Beschrijving
Telefoon
Contactnummer gebruiker. Alleen cijfers worden geaccepteerd en moeten worden ingevoerd met de landcode, de gebiedscode en het nummer.
Geslacht
Geslacht kan worden ingevoerd als "f" voor vrouwelijk, "m" voor mannelijk en "n" voor niet-binair.
Geboortedatum
Geboortedatum, ingevoerd als jaar, maand, en dag.
Achternaam
Achternaam van de gebruiker.
Voornaam
Voornaam van gebruiker.
Plaats
De woonplaats van de gebruiker. Dit wordt meestal gebruikt voor factureringsdoeleinden.
Staat
De staat van de gebruiker, die als twee-lettercode in kleine letters wordt verstrekt.
Postcode
De postcode van de gebruiker, die hoofdzakelijk voor factureringsdoeleinden wordt gebruikt.
Land
ISO-3166-landcode van twee tekens die het land van de gebruiker aangeeft.
Externe id
Unieke id van de adverteerder die een gebruiker in zijn ruimte identificeert. Bijvoorbeeld gebruikers-id, loyaliteit-id enzovoort.
Klik op ID
De unieke id die is opgeslagen in _epik cookie op uw domein of de query-parameter &epik= in de URL.
IMPORTANT
Voordat u de gegevens naar de Pinterest API eindpunt, zal de uitbreiding de waarden van de volgende gebieden hakken en normaliseren: E-mail, Telefoonaantal, Voornaam, Achternaam, Geslacht, Geboortedatum, Stad, Staat, Postcode, Land, en Externe identiteitskaart De extensie verbergt de waarde van deze velden niet als er al een SHA256-tekenreeks aanwezig is.

Custom Data

De volgende aangepaste gegevens kunnen voor de regel worden ingevoerd:

Veldnaam
Beschrijving
Valuta
De ISO-4217-valutacode. Indien dit niet wordt vermeld, Pinterest wordt standaard ingesteld op de valuta van de adverteerder die is ingesteld tijdens het maken van de account.
Waarde
Totale waarde van de gebeurtenis. Wordt geaccepteerd als een tekenreeks in de aanvraag. Dit wordt in een dubbel cijfer geparseerd.
Zoektekenreeks
De zoektekenreeks die betrekking heeft op de conversiegebeurtenis van de gebruiker.
Order-id
De bestellings-id. Verzenden order_id helpt Pinterest dedupliceer gebeurtenissen indien nodig.
Aantal producten
Het totale aantal producten van de gebeurtenis. Bijvoorbeeld het totale aantal objecten dat is aangeschaft tijdens een uitcheckgebeurtenis.
Inhoud-id's
Lijst (array) met product-id's.
Inhoud
Een lijst (array) met objecten die informatie over producten bevatten, zoals prijs en hoeveelheid.

De Pinterest Custom Data gemarkeerd in de regelactie.

Gegevens valideren binnen Pinterest

Zodra de gebeurtenis door:sturen regel is gecreeerd en uitgevoerd, bevestig of de gebeurtenis die werd verzonden naar Pinterest API wordt weergegeven zoals wordt verwacht in het dialoogvenster Pinterest UI.

Als de gebeurtenisinzameling en Experience Platform de integratie is voltooid, u ziet de gebeurtenissen in het Pinterest UI.

De Pinterest gebeurtenismanager

U kunt de Pinterest distributie van gebeurtenisgegevens.

De Pinterest gegevensdistributie

Volgende stappen

In deze handleiding wordt beschreven hoe u de Pinterest gebeurtenis die uitbreiding in UI door:sturen. Raadpleeg de officiële documentatie voor meer informatie:

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743