Översikt

Med Pinterests API för konversioner blir det möjligt för annonsörer att skicka konversioner direkt till Pinterest via en server-till-server-metod. Konversioner som registrerats med Pinterests API kan sedan användas för återriktning i kampanjer och kan granskas i konversionsrapporter för förbättrad konversionssynlighet.

Annonsörer kan använda Pinterests API för konversioner för att skicka:

  • Webbkonversioner
  • Konversioner i appen
  • Offlinekonversioner
  • Händelser kan tas emot i realtid eller inom en timme efter att händelsen inträffade och registrerades. Händelser som registreras utanför detta fönster eller som en del av en försenad batchhändelse kommer att räknas som offlinekonversioner. 

    Om du använder Pinterests API för konversioner tillsammans med Pinterest-taggen kan det hjälpa till att maximera synligheten för registrerade konversioner. Vår bästa praxis är att använda båda lösningarna för konversionsregistrering för att säkerställa att du får en omfattande översikt över din konversionskampanjs resultat.

    Pinterests API

    Pinterests API för konversioner är en av flera produkter som finns inom vårt Pinterest API-ekosystem. Alla med ett företagskonto på Pinterest kan använda Pinterests API för konversioner, men detta ger inte automatiskt åtkomst till Pinterests bredare API. 

    Pinterests utvecklarplattform har information om alla Pinterests API-produkter. 

    Kom igång

    Alla med ett företagskonto på Pinterest har tillgång till Pinterests API för konversioner.

    För att komma igång måste du först generera en åtkomsttoken. En åtkomsttoken är en rad tecken som verifierar att förfrågningarna görs och skickas tillbaka till rätt användarkonto. 

    Generera en åtkomsttoken: 

  • Logga in på ditt företagskonto på Pinterest
  • Klicka på Annonser i toppmenyn och välj Konversioner
  • Välj sidan Åtkomsttoken för konversioner i navigeringsfältet till vänster
  • Klicka på knappen Generera ny token
  • Kopiera din nya åtkomsttoken och återgå till konfigurationsprocessen.
  • Om du försöker komma åt ett konto som du inte äger måste du först ställa in Företagsåtkomst. 

    Implementering

    Konversionshändelser: alla händelsetyper som finns tillgängliga för registrering på Pinterest-taggen finns även tillgängliga via Pinterests API för konversioner. Du hittar en fullständig lista över händelser och ytterligare information om deras betydelse i vår utvecklardokumentation för Pinterests API.

    Att ställa in en server-till-server-API-integration kräver utvecklar- och teknikresurser från webbplatsägaren. Mängden jobb för en teknisk utvecklare varierar beroende på

  • hur väl utvecklare känner till API-integrationer. Om hen aldrig har gjort en API-integration tidigare kan ytterligare arbete krävas. Om du har implementerat andra konversions-API:er bör din utvecklare bara behöva göra några mindre ändringar.
  • antalet händelser som spåras och i vilket skede av konversionsprocessen som data skickas till oss.
  • Om en annonsör vill eller behöver använda en tredje part för att integrera (t.ex. Shopify, GTM, Tellium).
  • Om du redan använder Pinterest-taggen

    Vi rekommenderar starkt att du använder Pinterests API för konversioner bredvid Pinterest-taggen för att säkerställa att du maximerar dina konversioner. 

    Om du har konfigurerat Pinterest-taggen tidigare måste du säkerställa att konversioner inte räknas två gånger - en gång via Pinterest-taggen och en gång via API. 

    För att kontrollera detta måste du se till att parametern event_id skickas tillbaka med konversioner som samlats in av både Pinterest-taggen och Pinterests API för konversioner. 

    Vårt system kommer sedan att känna igen event_ids som dubbletter och endast behålla den första konversion som registrerades. För att säkerställa att denna avduplicering fungerar måste:

  • event_ids vara identiska mellan samma konversioner – En person besöker en webbsida och en sidbesökskonversion registreras av både Pinterest-taggen och Pinterests API. De två konversionerna måste ha matchande event_ids som skickas tillbaka så att vårt system kan identifiera dem som samma konversion. 
  • event_ids vara unika för olika konversioner – En person besöker en webbsida och en sidbesökskonversion registreras av både Pinterest-taggen och Pinterests API. Personen lägger sedan till en t-shirt i sin varukorg, vilket utlöser en AddToCart-händelse som registreras av både Pinterest-taggen och Pinterests API. Även om event_ids som registreras för samma händelse måste matcha, måste event_ids som skickas för sidbesöks- och lagd i varukorg-händelserna vara unika. På så sätt kan vårt system identifiera dem som separata händelser.
  • Baserat på händelseidentifieraren och event_name kommer Pinterest att ta bort alla dubbletthändelser från registret, förutsatt att a) händelsen inte ägde rum offline (action_source är inte offline) och (b) Pinterest tar emot dubbletthändelserna inom 48 timmar från varandra.

    Verifiera dina inställningar

    När du har konfigurerat API:et kan du verifiera att konversionshändelserna registreras genom att kontrollera:

  • Svarskoder: utvecklaren som konfigurerat din API-integration kan granska de svarskoder som returneras med varje begäran som skickas tillbaka efter att en konversion har aktiverats. 
  • Avdupliceringssidan i annonshanteraren: konversioner efter avduplicering visas på avdupliceringssidan i annonshanteraren. För att komma åt avdupliceringssidan:
    • Logga in på ditt företagskonto på Pinterest
    • Klicka på Annonser i toppmenyn och välj Konversioner
    • Välj Avduplicering i navigeringsfältet till vänster.
  • Kvalitet och motståndskraft

    Motståndskraft är statusen för ett API för konversioner som möjliggör den högsta nivån av signalmatchning och attribution. Dessa ytterligare data kommer att hjälpa oss att tillhandahålla mer exakta rapporter i takt med att annonsindustrins policyer förändras och utvecklas.

    Motståndskraftsstatus

    Det finns två kategorier av motståndskraftsstatus: Bra och Dålig. Din motståndskraftsstatus är synlig under avsnittet Konversionshälsa i annonshanteraren.

    Bra motståndskraft

    Alternativ 1: Specifik identifierares täckning

  • Identifierares täckning
    • Minst 90% av händelserna bör ha IP/UA, 
    • Minst 10% av lägre funnel-händelser har hashad e-post eller MAID, 
    • Minst 10% av händelserna har ett externt ID.
  • Överlappning med taggdata (om tillämpligt)
    • Minst 90%* av tagghändelserna måste tas emot via CAPI 
  • Eller:

    Alternativ 2: Uppnå basmatchningsgrad

  • CAPI:s användarmatchningsgrad minst 60%
  • Överlappning med taggdata (om tillämpligt)
  • Minst 90%* av tagghändelserna måste tas emot via CAPI 


  • Dålig motståndskraft

    Alla konfigurationer som inte är bra.

    Motståndskrafts-ID och -signaler

    Skicka följande signaler för att nå motståndskraftig annonsörsstatus.

    API-ID/signaler Vikt/rank
    client_ip_address + client_user_agent Hög
    em Hög
    external_id Hög
    hashed_maid Hög
    click_id Hög
    fn + ln Låg
    ph Låg
    ge, bd, ct, st, zp, country Låg

    *Vikt/rank baserat på sannolikheten för ökad matchningsgrad

    Implementering av tredje part

    Pinterest har flera tredjepartsintegrationer för att stödja implementeringsprocessen av API. 

    Google Taggstyrning – serversidan

    Koppla ditt Google Taggstyrning-konto till Pinterests API för konversioner för att se hur Pinterest påverkar trafiken till din butik och försäljningen av dina produkter.

    Denna integrering kräver att du distribuerar en serverbehållare med hjälp av din föredragna molnleverantör samt kunskap om taggning på serversidan.Besök utvecklarsidan för mer information om förhandskraven. 

    Shopify

    Intregreringen av API för konversioner kompletterar Pinterest-taggen för att säkerställa hög datatäckning och -kvalitet. Så länge Shopify-appen är installerad krävs ingen åtgärd för att dra nytta av denna förbättring. Ändringarna kommer automatiskt att tillämpas på säljarens butik.

    Tealium

    Annonsörer som är intresserade av Tealium kan ställa in API för konversioner direkt med tredje part. Tealium bygger mallen och hjälper till att underlätta integrationen med annonsören. 

    Implementeringsprocessen beskrivs i Tealium’s Learning Center. Eventuella frågor om implementeringsstöd kan skickas till support [at] tealium.com (support[at]tealium[dot]com)

    Om du är intresserad av ytterligare tredjepartsintegrationer kan du kontakta Pinterest för mer information. 

    Förstå begränsad databehandling

    Från och med den 1 januari 2023 kan annonsörer använda en flagga för begränsad databehandling för att hjälpa dem att följa California Consumer Privacy Act, ändrat genom California Privacy Rights Act (tillsammans, CCPA). Med denna flagga på plats kommer Pinterest att begränsa hur vi använder vissa data för att hjälpa annonsörer att följa inställningarna för användarsekretess. En annonsör kan till exempel implementera flaggan för begränsad databehandling för användare i Kalifornien som har valt att inte sälja eller dela sina data under CCPA. När flaggan för begränsad databehandling används kommer Pinterest att fungera som en tjänsteleverantör under CCPA när det gäller flaggade data från användare i Kalifornien.

    Annonsörer är ansvariga för att följa användares avanmälningar samt identifiera användarens hemvist när de implementerar flaggan för begränsad databehandling.

    End of Other articles Links
    Behöver du fortfarande hjälp? Kontakta oss
    User feedback
    Var artikeln till hjälp?

    collection_fields

    Hur kan vi göra artikeln bättre?