DokumentationExperience PlatformTaggar

Pinterest-tillägg för händelsevidarebefordring

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Utvecklare

Pinterest är en visuell identifieringsmotor för att hitta idéer som recept, heminredning, stilinspiration med mera. Det finns miljarder punkter på Pinterest, som också kan delas med andra på Pinterest. Du kan sortera användarinteraktionshändelserna och dra nytta av Pinterest Analytics för att förstå användarbeteendet och köra riktade annonser.

Med tillägget Pinterest Konverteringar API för vidarebefordran av händelser kan du utnyttja data som har samlats in i Adobe Experience Platform Edge Network och skicka dem till Pinterest. Det här dokumentet beskriver tilläggets användningsfall, hur det installeras och hur du integrerar dess funktioner i regler för vidarebefordran av händelser.

Åtkomsttoken för konvertering är den autentiseringsmetod som används av Pinterest vid interaktion med API:t Pinterest.

Användningsfall

Det här tillägget bör användas om du vill använda data från Edge Network i Pinterest för att utnyttja dess funktioner för kundanalys.

Ta till exempel ett marknadsföringsteam i en organisation. Teamet hämtar händelsedata för användarinteraktion från sin webbplats och läser in dem till Pinterest med det här tillägget för händelsevidarebefordran.

Marknadsförings- och analysteam kan sedan utnyttja Pinterest analysfunktioner för att förstå viktiga användarinteraktioner och beteenden, så att ni bättre kan förstå användare och inrikta er på dem för riktade annonskampanjer.

Mer information om användningsfall som är specifika för Pinterest finns i dokumentationen för Pinterest användningsfall.

Krav för Pinterest prerequisites

Du måste ha ett giltigt Pinterest företagskonto för att kunna använda det här tillägget. Gå till registreringssidan Pinterest för att registrera dig och skapa ett konto om du inte redan har ett.

Du behöver också ett Pinterest-utvecklarkonto, som måste kopplas till ditt Pinterest-företagskonto. Mer information om hur du associerar ditt utvecklarkonto med ditt företagskonto finns i Pinterest ​ utvecklarkontot.

Samla nödvändig konfigurationsinformation configuration-details

Följande indata krävs för att ansluta Experience Platform till Pinterest:

Autentiseringsuppgifter
Beskrivning
Exempel
ID för annonskonto
Ditt Pinterest Ads-konto-ID. Mer information finns i Pinterest dokumentationen.
123456789012
Åtkomsttoken för konvertering
Åtkomsttoken för konvertering av Pinterest. Mer information finns i Pinterest Konverterings-API -dokumentet.
Du behöver bara göra detta en gång eftersom denna token inte upphör att gälla.

Installera och konfigurera tillägget Pinterest install

Om du vill installera tillägget skapar du en egenskap för vidarebefordring av händelser eller väljer en befintlig egenskap att redigera i stället.

Välj Extensions i den vänstra navigeringen. Välj Install på kortet för tillägget Pinterest på fliken Catalog.

Katalog som visar tillägget Pinterest med Install markerat.

Konfigurera tillägget Pinterest

IMPORTANT
Beroende på implementeringsbehoven kan du behöva skapa ett schema, dataelement och en datauppsättning innan du konfigurerar tillägget. Granska alla konfigurationssteg innan du startar för att avgöra vilka enheter du måste konfigurera för ditt användningsfall.

Välj Extensions i den vänstra navigeringen. Välj Configure på kortet för tillägget Pinterest på fliken Installed**.

Tillägget Pinterest visas på fliken Install med Configure markerat.

På nästa skärm anger du de Ads Account Id och Conversion Access Token som du tidigare samlade in i avsnittet konfigurationsinformation. När du är klar väljer du Save.

Skärmen Pinterest Configure som markerar indatafälten Ads Account Id och Conversion Access Token.

Konfigurera en regel för vidarebefordran av händelser config-rule

När alla dataelement har konfigurerats kan du börja skapa regler för vidarebefordran av händelser som avgör när och hur händelser skickas till Pinterest.

Skapa en ny regel i egenskapen för vidarebefordran av händelser. Under Actions lägger du till en ny åtgärd och anger tillägget till Pinterest. Om du vill skicka Edge Network-händelser till Pinterest anger du Action Type till Send Event.

Skapandet av Pinterest Send Event-regeln.

Efter markeringen visas ytterligare kontroller för att ytterligare konfigurera händelsen. Du måste mappa händelseegenskaperna Pinterest till dataelementen som du tidigare har skapat.

Event Data

Följande händelsedata krävs för att skapa den nya regeln:

Fältnamn
Beskrivning
Exempel
Event Name
Typ av användarhändelse. Det här kan vara vilken händelsetyp som helst, men om du vill utnyttja Pinterest Analytics rekommenderar vi att du använder Pinterest händelsekoder
* utcheckning
* add_to_cart
* page_visit
* registrering
* [användardefinierad händelse]
Action Source
Källan som anger var konverteringshändelsen inträffade.
* app_android
* app_ios
* web
* offline
Event Time
Detta avser händelsetiden. Standardtidsformatet som används är UNIX, i formatet <seconds>.<miliseconds> beroende på din lokala tidszon. Mer information finns i Pinterest API.
1433188255.500 anger 1433188255 sekunder och 500 millisekunder efter epok, eller måndag, 1 juni 2015, kl. 7:50:55 PM GMT.
Event ID
En unik id-sträng som identifierar den här händelsen och kan användas för att ta bort händelser som importerats via både konverterings-API:t och Pinterest-spårning. Utan detta räknas händelsens data sannolikt två gånger och kommer att rapportera måttlig uppblåsning.
ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad
Event Properties
Ett JSON-objekt som innehåller anpassade egenskaper för händelsen. Välj mellan att tillhandahålla rå JSON eller att använda en förenklad uppsättning indata för nyckelvärden.
{ "event_source_url": "http://site.com" }

Det Pinterest Event Data som markeras i regelåtgärden.

Följande händelseegenskaper kan konfigureras:

Fältnamn
Beskrivning
Händelse-Source-URL
URL för webbkonverteringshändelsen.
Programarkiv-ID
App-ID:t för appbutiken.
Programnamn
Programmets namn.
Programversion
Versionen av programmet.
Enhetsmärke
Varumärke för den enhet som används av användaren.
Enhetsbärare
Användarens mobiloperatör för sin enhet.
Enhetsmodell
Modell för användarens enhet.
Enhetstyp
Typ av enhet som används av användaren.
OS-version
Version av enhetens operativsystem.
Användarspråk
ISO-639-1-språkkod med två tecken som anger användarens språk.

User Data

Följande användardata kan anges av obligatoriska fält:

Fältnamn
Beskrivning
Exempel
Email
Användarens e-postadress eller en SHA256-hash av användarens e-postadress.
ebd543592…f2b7e1
Mobile Adverstising IDs
Sha256 hash of user's "Google Advertising IDs" (GAID) or "Apple Identifier for Advertisers" (IDFAs)
ebd543592…f2b7e1
Client IP Address
Användarens IP-adress, som kan vara antingen i IPv4- eller IPv6-format. Används för matchning.
192.168.0.1
Client User Agent
Användaragentsträngen för användarens webbläsare.
Mozilla/5.0 (plattform; rv:geckoversion) Gecko/geckotrail Firefox/firefoxversion
Customer information data
Ett JSON-objekt som innehåller annan kundinformation. Välj mellan att tillhandahålla rå JSON eller att använda en förenklad uppsättning indata för nyckelvärden.
{ "ph": "122333445" }

Det Pinterest User Data som markeras i regelåtgärden.

De egenskaper för kundinformation som kan konfigureras är:

Fältnamn
Beskrivning
Telefon
Användarens kontaktnummer. Endast siffror accepteras och ska anges med landskod, riktnummer och nummer.
Kön
Kön kan anges som antingen"f" för hona,"m" för hane eller"n" för icke-binära.
Födelsedatum
Födelsedatum, angivet som år, månad och dag.
Efternamn
Användarens efternamn.
Förnamn
Användarens förnamn.
Ort
Användarens bosättningsort. Detta används mest för faktureringsändamål.
Läge
Användarens tillstånd, som anges med två bokstäver i gemener.
Postnummer
Användarens postnummer, som främst används för fakturering.
Land
ISO-3166-landskod med två tecken som anger användarens land.
Externt ID
Unikt ID från annonsören som identifierar en användare i sitt space. Till exempel användar-ID, lojalitets-ID.
Klicka på ID
Den unika identifieraren som lagras i _epik cookie på din domän eller i &epik= query-parametern i URL:en.
IMPORTANT
Innan data skickas till API-slutpunkten Pinterest kommer tillägget att hash-koda och normalisera värdena för följande fält: E-post, Telefonnummer, Förnamn, Efternamn, Kön, Födelsedatum, Ort, Delstat, Postnummer, Land och Externt ID. Tillägget kommer inte att hash-koda värdet för dessa fält om det redan finns en SHA256-sträng.

Custom Data

Följande anpassade data kan anges för regeln:

Fältnamn
Beskrivning
Valuta
ISO-4217-valutakoden. Om detta inte anges kommer Pinterest att ange annonsöerns valuta som angavs när kontot skapades som standard.
Värde
Händelsens totala värde. Accepteras som en sträng i begäran. Detta tolkas som en dubbelsiffra.
Söksträng
Söksträngen som är relaterad till användarkonverteringshändelsen.
Order-ID
Beställnings-ID. Om du skickar order_id kan Pinterest deduplicera händelser vid behov.
Antal produkter
Totalt antal produkter för händelsen. Det totala antalet objekt som köpts i en utcheckningshändelse.
Innehålls-ID
Lista (matris) med produkt-ID:n.
Innehåll
En lista (array) med objekt som innehåller information om produkter, till exempel pris och kvantitet.

Det Pinterest Custom Data som markeras i regelåtgärden.

Validera data i Pinterest

När regeln för vidarebefordran av händelser har skapats och körts kontrollerar du om händelsen som skickades till Pinterest-API:t visas som förväntat i Pinterest-gränssnittet.

Om händelsesamlingen och integreringen av Experience Platform lyckades, kommer du att se händelser i användargränssnittet för Pinterest.

Händelsehanteraren Pinterest

Du kan gå igenom och visa distributionen av händelsedata för Pinterest ytterligare.

Datadistributionen Pinterest

Nästa steg

I den här guiden beskrivs hur du installerar och konfigurerar tillägget Pinterest för vidarebefordran av händelser i användargränssnittet. Mer information finns i den officiella dokumentationen:

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