Oversigt

Pinterest API til konverteringer giver annoncører mulighed for at sende konverteringer direkte til Pinterest via en server til server-forbindelse. Konverteringer, der registreres med Pinterest API, kan derefter bruges til retargeting i kampagner og nærstuderes i konverteringsrapporter for at få bedre indblik i annoncernes effektivitet.

Annoncører kan sende følgende via Pinterest API til konverteringer:

  • Konverteringer på web
  • Konverteringer i app
  • Konverteringer offline
  • Hændelser kan modtages i realtid, eller inden for en time efter hændelsen er indtruffet og registreret. Hændelser, der modtages uden for dette vindue eller som en del af en udskudt gruppehændelse, tælles som offlinekonverteringer. 

    Hvis du bruger Pinterest API til konverteringer sammen med Pinterest-tagget, får du maksimal indsigt i dine registrerede konverteringer. Vi anbefaler, at du bruger begge løsninger for at sikre, at du får et samlet overblik over resultaterne i dine konverteringskampagner.

    Pinterest API

    Pinterest API til konverteringer er et af flere produkter i vores Pinterest API-økosystem. Alle med en virksomhedskonto på Pinterest kan bruge Pinterest API til konverteringer, men det giver ikke automatisk adgang til den bredere Pinterest API. 

    Du kan finde mere om alle Pinterests API-produkter på Pinterests Udviklerplatform

    Kom i gang

    Alle med en virksomhedskonto på Pinterest har adgang til Pinterest API til konverteringer.

    Du skal generere et adgangstoken for at komme i gang. Et adgangstoken er en række tegn, der verificerer, at anmodningerne foretages og sendes tilbage til den korrekte brugers konto. 

    Sådan genererer du et adgangstoken: 

  • Log på din Pinterest-virksomhedskonto
  • Klik på Annoncer i topmenuen, og vælg Konverteringer
  • Vælg Adgangstoken i navigationen til venstre
  • Klik på Generér nyt token
  • Kopiér det nye adgangstoken, og vend tilbage til konfigurationen
  • Hvis du forsøger at få adgang til en konto, du ikke ejer, skal du først oprette Virksomhedsadgang. 

    Implementering

    Konverteringshændelser: Alle hændelsestyper, der kan registreres via Pinterest-tagget, kan også registreres via Pinterest API til konverteringer. Du finder en komplet liste over hændelserne og yderligere oplysninger om deres betydning i vores udviklerdokumentation til Pinterest API.

    Konfigurering af en API-integration fra server til server kræver udviklingsressourcer fra ejeren af websitet. Den nødvendige tekniske indsats varierer afhængigt af:

  • Din udviklers kendskab til API-integrationer. Hvis din udvikler aldrig har udført en API-integration før, kan det kræve ekstra arbejde. Hvis du har implementeret andre konverterings-API'er, skal din udvikler sandsynligvis kun foretage små ændringer.
  • Antallet af sporede hændelser og det stadie af konverteringsprocessen, hvor der sendes data til os.
  • Om en annoncør ønsker eller har brug for at anvende en tredjepart til integrationen (f.eks. Shopify, GTM, Tealium).
  • Hvis du allerede bruger Pinterest-tagget

    Vi anbefaler på det kraftigste, at du bruger Pinterest API til konverteringer sammen med Pinterest-tagget for at sikre, at du maksimerer dine konverteringer. 

    Hvis du allerede har konfigureret Pinterest-tagget, skal du sikre dig, at konverteringer ikke tælles to gange – én gang via Pinterest-tagget og én gang via API'en. 

    Du undgår at tælle dobbelt ved at returnere parameteren event_id, når konverteringer registreres af både Pinterest-tagget og Pinterest API til konverteringer. 

    Vores system genkender derefter matchende event_id'er som dubletter, så kun den først registrerede konvertering bibeholdes. Sådan sikrer du en korrekt deduplikering:

  • Dine event_id'er skal være identiske ved samme konvertering – når en person åbner en webside, udløser både Pinterest-tagget og Pinterest API en konvertering i form af et Sidebesøg. De to konverteringer skal sende matchende event_id'er tilbage, så vores system genkender, at der er tale om den samme konvertering. 
  • Dine event_id'er skal være unikke ved forskellige konverteringer – når en person åbner en webside, udløser både Pinterest-tagget og Pinterest API en konvertering i form af et Sidebesøg. Personen lægger derefter en T-shirt i sin indkøbskurv, så hændelsen AddToCart udløses af både Pinterest-tagget og Pinterest API. Mens event_id'er udløst af den samme hændelse skal matche, skal event_id'erne for henholdsvis Sidebesøg og AddToCart hver især være unikke. På den måde genkender vores system dem som separate hændelser.
  • Pinterest fjerner alle dublerede hændelser ud fra event_id og event_name, så længe (a) hændelsen ikke fandt sted offline (action_source er ikke offline), og (b) Pinterest modtager de dublerede hændelser inden for 48 timer efter hinanden.

    Verificer din opsætning

    Når du har konfigureret din API, kan du verificere, at dine konverteringshændelser modtages korrekt, ved at tjekke:

  • Svarkoder: Udvikleren, der konfigurerer din API-integration, kan gennemgå de svarkoder, der returneres sammen med de enkelte anmodninger, når der udløses en konvertering. 
  • Deduplikeringssiden i Ads Manager: Konverteringer efter deduplikering vises på deduplikeringssiden i Ads Manager. Sådan får du adgang til deduplikeringssiden:
    • Log på din Pinterest-virksomhedskonto
    • Klik på Annoncer i topmenuen, og vælg Konverteringer
    • Vælg Deduplikering i navigationen til venstre
  • Kvalitet og robusthed

    Robusthed er status for en API til konverteringer, der giver mulighed for det højeste niveau af signalmatch og tilskrivning. De ekstra data hjælper os med at levere en mere præcis rapportering, i takt med ændringer og udvikling i annoncebranchens politikker.

    Status for robusthed

    Der er to kategorier af status for robusthed: god og dårlig. Du kan se status for din robusthed i din Konverteringsstatus i Ads Manager.

    God robusthed

    Mulighed 1: Specifik id-dækning

  • Dækning af id'er
    • Mindst 90 % af hændelserne skal have IP/UA 
    • Mindst 10 % af de lavere tragthændelser har hashet E-mail eller MAID 
    • Mindst 10 % af hændelserne har et eksternt id.
  • Overlap med tagdata (hvor det er relevant)
    • Mindst 90 %* af taghændelser skal modtages via CAPI 
  • Eller:

    Mulighed 2: Opnå basismatchfrekvens

  • CAPI-frekvens for brugermatch på mindst 60 %
  • Overlap med tagdata (hvor det er relevant)
  • Mindst 90 %* af taghændelser skal modtages via CAPI 


  • Dårlig robusthed

    Enhver opsætning, der er mindre end god.

    Id'er og signaler for robusthed

    Send følgende signaler for at opnå robust annoncørstatus.

    API-id'er/signaler Vægt/rangering
    client_ip_address + client_user_agent Høj
    em Høj
    external_id Høj
    hashed_maid Høj
    click_id Høj
    fn + ln Lav
    ph Lav
    ge, bd, ct, st, zp, country Lav

    *Vægt/rang baseret på sandsynligheden for øget matchfrekvens

    Implementering via tredjepart

    Pinterest har adskillige tredjepartsintegrationer, der understøtter din API-implementering. 

    Google Tag Manager – serverside

    Forbind din konto hos Google Tag Manager med dit Pinterest API til konverteringer, og se, hvor stor indflydelse Pinterest har på trafikken til din butik og salget af dine produkter.

    Integrationen kræver, at du installerer en servercontainer via din foretrukne cloud-udbyder, og kendskab til tagging på serversiden. Læs mere om forudsætningerne på vores website for udviklere

    Shopify

    API til konverteringer komplimenterer Pinterest-tagget, så du får høj datadækning og kvalitet. Så længe Shopify-appen er installeret, skal du ikke foretage dig noget for at få glæde af forbedringen. Ændringerne anvendes automatisk på butikken.

    Tealium

    Annoncører, der er interesseret i Tealium, kan konfigurere API til konverteringer direkte med tredjeparten. Tealium bygger skabelonen og hjælper med at facilitere integrationen med annoncøren. 

    Implementeringsprocessen er beskrevet i Tealiums læringscenter. Spørgsmål om implementering kan sendes til support [at] tealium.com (support[at]tealium[dot]com)

    Hvis du er interesseret i andre integrationer fra tredjepart, kan du kontakte din salgsrepræsentant. 

    Om begrænset databehandling

    Fra den 1. januar 2023 kan annoncører bruge en afmærkning af "Begrænset databehandling" som hjælp til at overholde California Consumer Privacy Act jf. ændringerne i California Privacy Rights Act (samlet betegnet som "CCPA"). Når afmærkningen er på plads, begrænser Pinterest brugen af visse data for at hjælpe annoncørerne med at efterleve brugernes indstillinger for persondata. En annoncør kan f.eks. implementere afmærkningen af Begrænset databehandling for brugere i Californien, der har fravalgt salg og deling af deres data i henhold til CCPA. Når afmærkningen af Begrænset databehandling bruges, fungerer Pinterest som tjenesteudbyder under CCPA med hensyn til afmærket data fra brugere i Californien.

    Annoncører er ansvarlige for at efterleve brugeres frameldinger og for at identificere brugerens bopælsstat, når de implementerer afmærkningen af Begrænset databehandling.

    End of Other articles Links
    Har du brug for mere hjælp? Kontakt os
    User feedback
    Kunne du bruge artiklen?

    collection_fields

    Hvordan kan vi gøre artiklen bedre?