Pinterest Conversions API for Shopify: en oppsettguide

Pinterest Conversions API er Pinterests server-til-server-måte å sende konverteringsevents på. Nettbutikken din, eller et verktøy som ROASaurus, sender events som kjøp rett til Pinterest-annonsekontoen din, i stedet for å stole bare på Pinterest Tag i kundens nettleser. Pinterest bruker dataene til konverteringsrapportering, kampanjeoptimalisering og målretting.

Denne guiden dekker v5 API-et og eventene det godtar, click id-en epik, hvordan kundedata hashes, hvordan deduplisering med Pinterest Tag fungerer, hvordan du tester, og hvordan du setter opp alt på Shopify.

Hva er Pinterest Conversions API?

Pinterest Tag er et skript i kundens nettleser. Conversions API gjør den samme jobben fra en server. I API versjon 5 sender du events til events-endepunktet for annonsekontoen din, autorisert med et conversion access token som du oppretter i Pinterest Ads Manager. Hver event sier hvor den skjedde: for en nettbutikk er action source web.

Pinterest ber annonsører som også bruker Tag, om å unngå å telle en konvertering to ganger, ved å sende en event_id med hver event. Pinterest ber også om events i sanntid, eller senest én time etter at de skjer.

På Shopify har en serverforbindelse én tydelig fordel: kjøp kommer fra selve bestillingen. Shopify rapporterer hver betalte bestilling til ROASaurus via webhook, og ROASaurus sender den til Pinterest kort tid etter betalingen, uansett om Tag-en ble utløst i nettleseren eller ikke. Guiden til server-side tracking på Shopify forklarer ideen mer i dybden.

Hvilke events godtar Pinterest Conversions API?

Pinterest har en fast liste over standard eventnavn, skrevet med små bokstaver og understrek, som page_visit, add_to_cart og checkout. Du kan også definere opptil 15 egendefinerte eventtyper per annonsør. ROASaurus kobler de fem handleeventene fra Shopify slik:

Navnet kan være forvirrende. Pinterests checkout er det fullførte kjøpet, ikke starten på checkout. Starten på checkout er en egen event, initiate_checkout.

For checkout-eventen anbefaler Pinterest at du sender verdien, valutaen, bestillings-ID-en, innholds-ID-ene og antall varer. ROASaurus sender alle fem, pluss antall og pris for hver vare. Pinterest ber om verdien før skatt og frakt. På Shopify sender ROASaurus akkurat det: bestillingens totalbeløp minus skatt og frakt, både fra serveren og fra nettlesertaggen. Når en nettbutikkplattform ikke rapporterer skatt og frakt hver for seg, sender ROASaurus totalbeløpet for bestillingen.

Hvordan kobler Pinterest en event til en person?

Hver event har med brukerdata. Pinterest krever minst én av tre ting: en hashet e-postadresse, en hashet mobil annonse-ID, eller IP-adressen sammen med user agent. En nettbutikk har ingen annonse-ID, så den trenger e-posten eller IP-adressen og user agent. ROASaurus hopper over en event som ikke har noen av delene, i stedet for å sende en som Pinterest ikke kan bruke.

Click id-en epik

Pinterest click id kan komme fra to steder: en epik-parameter i URL-en til landingssiden, eller _epik-cookien på domenet ditt. Pinterests API-guide anbefaler å sende verdien fra _epik-cookien, fordi den fortsatt fungerer når URL-parameteren mangler eller er fjernet, noe som gir bedre dekning.

ROASaurus leser begge i nettbutikken din, og bruker URL-parameteren når et nytt klikk har med en, og cookien ellers. Den lagrer click id-en sammen med den besøkende og sender den i feltet click_id i hver server-event, inkludert kjøpet. Besøk med en epik teller som Pinterest-besøk i attribusjonsrapportene i ROASaurus.

POST https://api.pinterest.com/v5/ad_accounts/549755885175/events

{
  "data": [{
    "event_name": "checkout",
    "action_source": "web",
    "event_time": 1793016000,
    "event_id": "order-5512345678901",
    "event_source_url": "https://example-store.com/checkouts/…/thank-you",
    "user_data": {
      "em": ["a3f1…9c2e"],
      "ph": ["7b40…11d8"],
      "external_id": ["e05c…4a7f"],
      "client_ip_address": "203.0.113.24",
      "client_user_agent": "Mozilla/5.0 (iPhone; …)",
      "click_id": "dj0yJnU9…"
    },
    "custom_data": {
      "currency": "USD",
      "value": "84",
      "order_id": "5512345678901",
      "content_ids": ["44123456789"],
      "contents": [{ "id": "44123456789", "quantity": 2, "item_price": "42" }],
      "num_items": 2
    }
  }]
}

Hvordan fungerer deduplisering med Pinterest Tag?

Hvis både Tag og API rapporterer et kjøp, mottar Pinterest to events for én bestilling. For å behandle dem som én trenger Pinterest den samme ID-en på begge sider: event-ID-en i Tag må samsvare med event_id i server-eventen. Pinterest beholder den første eventen den mottar og fjerner duplikater som kommer innen 48 timer.

ROASaurus bygger kjøps-ID-en fra Shopify-bestillings-ID-en. Kjøpet fra bestilling 5512345678901 har event-ID-en order-5512345678901, både i Tag-en som utløses i checkout og i server-eventen.

Alle fem eventene dedupliseres

Hver handleevent i ROASaurus har én event-ID, som brukes av Tag i nettleseren og av server-eventen. Tag bruker Pinterests egne navn for de samme eventene: pagevisit, viewcontent, addtocart, initiatecheckout og checkout, som samsvarer med page_visit, view_content, add_to_cart, initiate_checkout og checkout i API-et. Så når begge kjører, beholder Pinterest én kopi av hvert sidebesøk, hver produktvisning, hvert tillegg i handlekurven, hver start på checkout og hvert kjøp.

Du kan kjøre det på to måter:

• Tag og Conversions API sammen. Tag legger til nettlesersignaler, serveren fyller inn det Tag går glipp av, og Pinterest slår sammen kopiene.
• Kjør API-et uten Tag. La Tag-ID-en stå tom eller slå av Also load the browser tag. Hver event sendes da én gang, bare fra serveren.

Hjelpeartikkelen om dobbelttelling dekker de samme kontrollene for de andre annonseplattformene.

Hvordan tester du Pinterest Conversions API?

API-et har et testflagg. Forespørsler sendt med test=true går til en sandbox: Pinterest behandler dem som testdata og bruker dem ikke til rapportering eller optimalisering.

1. Slå på testmodus

   Rediger Pinterest-pixelen i ROASaurus under Tracking & platforms og huk av for Test mode (events show under Test events, max 20). Hver server-event sendes da med test=true. Pinterest behandler høyst 20 testevents per batch.

2. Legg inn en testbestilling

   Besøk nettbutikken din, se på et produkt, legg det i handlekurven og fullfør en bestilling.

3. Les resultatet

   Åpne Event log. Pinterest kan svare HTTP 200 selv om én event i en forespørsel feilet, så ROASaurus sjekker statusen til hver event og viser feil der.

4. Slå av testmodus

   Fjern avhukingen for testmodus, slik at events teller i rapportering og optimalisering.

5. Sjekk Events Overview

   Åpne siden Events Overview i Pinterest Ads Manager. Den viser eventene som kommer inn og konverteringene etter deduplisering. Pinterest anbefaler å sikte mot en Good Event Quality Score.

Slik setter du opp Pinterest Conversions API på Shopify med ROASaurus

Du trenger en Shopify-butikk med ROASaurus-appen og tilgang til Pinterest Ads Manager. Siden om Pinterest-integrasjonen viser alle feltene ROASaurus sender.

1. Koble til Shopify-butikken din

   Gå til Add a store › Shopify, klikk på Install app og slå på ROASaurus app embed i temaredigereren. Den fanger epik og _epik-cookien på hver side. Oppsettguiden for Shopify viser hvert trinn.

2. Opprett et conversion access token

   Gå til Conversions i Pinterest Ads Manager og opprett et conversion access token. Noter annonsekonto-ID-en din.

3. Legg til Pinterest-pixelen i ROASaurus

   Gå til Tracking & platforms, klikk på Add pixel på Pinterest-kortet og fyll inn Ad account ID og Conversion access token.

4. Legg til Tag-ID-en din

   For deduplisering med Tag fyller du inn Pinterest Tag ID og lar Also load the browser tag stå avhuket. Uten en Tag-ID sender ROASaurus bare server-events og laster ikke inn Tag.

5. Legg til checkout-pixelen

   I Shopify admin › Settings › Customer events legger du til en egendefinert pixel som heter ROASaurus og limer inn kodebiten fra siden Tracking & platforms. Den utløser checkout-eventen til Tag i Shopifys checkout, med bestillings-ID-en som event_id.

6. Velg server-events, og test

   Velg server-eventene du vil ha, og test med testmodus før du går live.

Med Respect visitor consent på, som er standard, følger ROASaurus kundens valg i Shopifys cookiebanner. Når en kunde avslår markedsføringscookies, laster ROASaurus ikke inn Pinterest Tag for den kunden, setter ingen besøks-ID, så klikkene ikke kobles til kunden, og sender ikke eventene for nettleseraktiviteten til Pinterest. Den betalte bestillingen sendes fortsatt til Conversions API fra serveren, med hashede bestillingsdata og bestillingens IP-adresse og user agent, men uten click id. Guiden til samtykke og personvern forklarer hva som lagres og sendes.

Koble til Pinterest-annonsekontoen din under Setup › Ad spend, så henter ROASaurus kampanjekostnadene hver time, og du ser Pinterest-ROAS og fortjeneste etter annonser i fortjenesteanalysen. Guiden til TikTok Events API dekker det samme oppsettet for TikTok, der hver event som går begge veier, dedupliseres.

Kilder

1. Pinterest Developers: Track conversion events in the API
2. Pinterest Business help: The Pinterest Conversions API
3. Pinterest Developers: Track conversions with Pinterest Tag

I ROASaurus

• Pinterest-integrasjon
• Server-side tracking i ROASaurus
• Hjelp: forhindre dobbelttelling

Les videre