Pinterest Conversions API til Shopify: en opsætningsguide

Pinterest Conversions API er Pinterests server-til-server-metode til at sende konverteringsevents. Din shop, eller et værktøj som ROASaurus, sender events som køb direkte til din Pinterest-annoncekonto i stedet for kun at stole på Pinterest Tag i shopperens browser. Pinterest bruger dataene til konverteringsrapportering, kampagneoptimering og targeting.

Denne guide dækker v5-API'et og de events, det accepterer, klik-id'et epik, hvordan kundedata hashes, hvordan deduplikering med Pinterest Tag fungerer, hvordan du tester, og hvordan du sætter det hele op på Shopify.

Hvad er Pinterest Conversions API?

Pinterest Tag er et script i shopperens browser. Conversions API gør det samme arbejde fra en server. I API-version 5 sender du events til events-endpointet for din annoncekonto, autoriseret med et conversion access token, som du opretter i Pinterest Ads Manager. Hvert event angiver, hvor det skete: For en webshop er action source web.

Pinterest beder annoncører, der også bruger Tag, om at undgå at tælle en konvertering to gange ved at sende et event_id med hvert event. Pinterest beder også om events i realtid eller senest én time efter, at de sker.

På Shopify har en serverforbindelse én klar fordel: Køb kommer fra selve ordren. Shopify melder hver betalt ordre til ROASaurus via webhook, og ROASaurus sender den til Pinterest kort efter betalingen, uanset om tagget blev udløst i browseren. Guiden til server-side tracking på Shopify forklarer idéen mere i dybden.

Hvilke events accepterer Pinterest Conversions API?

Pinterest har en fast liste over standardeventnavne, skrevet med små bogstaver og understregninger, for eksempel page_visit, add_to_cart og checkout. Du kan også definere op til 15 brugerdefinerede eventtyper pr. annoncør. ROASaurus oversætter de fem shoppingevents fra Shopify på denne måde:

Navnet kan være forvirrende. Pinterests checkout er det afsluttede køb, ikke starten på checkout. Starten på checkout er et separat event, initiate_checkout.

Til checkout-eventet anbefaler Pinterest at sende værdien, valutaen, ordre-id'et, content-id'erne og antallet af varer. ROASaurus sender alle fem plus hver vares antal og pris. Pinterest beder om værdien før moms og fragt. På Shopify sender ROASaurus netop det: ordretotalen minus moms og fragt, både fra serveren og fra browser-tagget. Når en webshopplatform ikke rapporterer moms og fragt hver for sig, sender ROASaurus ordretotalen.

Hvordan matcher Pinterest et event med en person?

Hvert event bærer brugerdata. Pinterest kræver mindst én af tre ting: en hashet e-mailadresse, et hashet mobilt reklame-id eller IP-adressen sammen med user agent. En webshop har intet reklame-id, så den skal bruge e-mailen eller IP-adressen og user agent. ROASaurus springer et event over, der hverken har det ene eller det andet, i stedet for at sende et, som Pinterest ikke kan bruge.

Klik-id'et epik

Pinterests klik-id kan komme fra to steder: en epik-parameter i landingssidens URL eller _epik-cookien på dit domæne. Pinterests API-guide anbefaler at sende værdien fra _epik-cookien, fordi den stadig virker, når URL-parameteren mangler eller er fjernet, hvilket giver bedre dækning.

ROASaurus læser begge dele i din storefront og bruger URL-parameteren, når et nyt klik medbringer en, og ellers cookien. Den gemmer klik-id'et sammen med den besøgende og sender det i feltet click_id på hvert server-event, også købet. Besøg med en epik tæller som Pinterest-besøg i ROASaurus' attributionsrapporter.

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 deduplikering med Pinterest Tag?

Hvis Tag og API begge rapporterer et køb, modtager Pinterest to events for én ordre. For at behandle dem som ét skal det samme id være på begge sider: Event-id'et i Tag skal matche event_id i server-eventet. Pinterest beholder det første event, det modtager, og fjerner dobbelte events, der ankommer inden for 48 timer.

ROASaurus bygger købs-id'et ud fra Shopify-ordre-id'et. Købet fra ordre 5512345678901 har event-id'et order-5512345678901 både i Pinterest Tag, som udløses i checkout, og i server-eventet.

Alle fem events deduplikeres

Hvert shoppingevent i ROASaurus har ét event-id, som bruges af Tag i browseren og af server-eventet. Tag bruger Pinterests egne navne for de samme events: pagevisit, viewcontent, addtocart, initiatecheckout og checkout, som matcher page_visit, view_content, add_to_cart, initiate_checkout og checkout i API'et. Så når begge kører, beholder Pinterest én kopi af hvert sidebesøg, hver produktvisning, hver tilføjelse til kurven, hver start på checkout og hvert køb.

Du kan køre det på to måder:

• Tag og Conversions API sammen. Tag tilføjer browsersignaler, serveren udfylder det, Tag går glip af, og Pinterest slår kopierne sammen.
• Kør API'et uden Tag. Lad Tag ID være tomt, eller slå Also load the browser tag fra. Så sendes hvert event kun én gang, fra serveren.

Hjælpeartiklen om dobbelttælling dækker de samme tjek for de andre annonceplatforme.

Hvordan tester du Pinterest Conversions API?

API'et har et testflag. Anmodninger sendt med test=true går til en sandbox: Pinterest håndterer dem som testdata og bruger dem ikke til rapportering eller optimering.

1. Slå testtilstand til

   Rediger Pinterest-pixelen i ROASaurus under Tracking & platforms, og sæt kryds ved Test mode (events show under Test events, max 20). Hvert server-event sendes så med test=true. Pinterest behandler højst 20 testevents pr. batch.

2. Læg en testordre

   Besøg din shop, se et produkt, læg det i kurven, og gennemfør en ordre.

3. Læs resultatet

   Åbn Event log. Pinterest kan svare med HTTP 200, selvom ét event i en anmodning mislykkedes, så ROASaurus tjekker status for hvert event og viser fejl dér.

4. Slå testtilstand fra

   Fjern fluebenet ved testtilstand, så events tæller i rapportering og optimering.

5. Tjek Events Overview

   Åbn siden Events Overview i Pinterest Ads Manager. Den viser de events, der ankommer, og de deduplikerede konverteringer. Pinterest anbefaler at sigte efter en Good Event Quality Score.

Sådan sætter du Pinterest Conversions API op på Shopify med ROASaurus

Du skal bruge en Shopify-shop med ROASaurus-appen og adgang til Pinterest Ads Manager. Pinterest-integrationssiden viser alle felter, ROASaurus sender.

1. Forbind din Shopify-shop

   Gå til Add a store › Shopify, klik på Install app, og slå ROASaurus-app-embedden til i theme-editoren. Den registrerer epik og _epik-cookien på hver side. Shopify-opsætningsguiden viser hvert trin.

2. Opret et conversion access token

   Gå til Conversions i Pinterest Ads Manager, og opret et conversion access token. Notér dit annoncekonto-id.

3. Tilføj Pinterest-pixelen i ROASaurus

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

4. Tilføj dit Tag ID

   For at deduplikere med Tag skal du udfylde Pinterest Tag ID og lade Also load the browser tag være afkrydset. Uden et Tag ID sender ROASaurus kun server-events og indlæser ikke Tag.

5. Tilføj checkout-pixelen

   Gå til Shopify admin › Settings › Customer events, tilføj en custom pixel med navnet ROASaurus, og indsæt snippeten fra din side Tracking & platforms. Den udløser Tags checkout-event i Shopifys checkout med ordre-id'et som event_id.

6. Vælg server-events, og test derefter

   Vælg de server-events, du vil have, og test med testtilstand, før du går live.

Når Respect visitor consent er slået til, hvilket er standard, følger ROASaurus shopperens valg i Shopifys cookiebanner. Når en shopper afviser marketingcookies, indlæser ROASaurus ikke Pinterest Tag for shopperen og sætter intet besøgs-id, så shopperens klik ikke bliver knyttet til vedkommende. Shopperens browsing-events sendes ikke til Pinterest. Den betalte ordre sendes stadig til Conversions API fra serveren, med hashede ordredata og ordrens IP-adresse og user agent, men uden et klik-id. Guiden til samtykke og privatliv forklarer, hvad der gemmes og sendes.

Forbind din Pinterest-annoncekonto under Setup › Ad spend, så henter ROASaurus kampagneforbruget hver time, og du ser Pinterest-ROAS og overskud efter annoncer i overskudsanalysen. Guiden til TikTok Events API dækker den samme opsætning for TikTok, hvor alle events, der går begge veje, deduplikeres.

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-integration
• Server-side tracking i ROASaurus
• Hjælp: forebyg dobbelttælling

Læs videre