Pinterest Conversions API för Shopify: en installationsguide

Pinterest Conversions API är Pinterests server-till-server-sätt att skicka konverteringshändelser. Din butik, eller ett verktyg som ROASaurus, skickar händelser som köp direkt till ditt Pinterest-annonskonto, i stället för att förlita sig enbart på Pinterest Tag i köparens webbläsare. Pinterest använder datan för konverteringsrapportering, kampanjoptimering och målgruppsinriktning.

Den här guiden går igenom v5-API:et och de händelser det accepterar, klick-id:t epik, hur kunddata hashas, hur deduplicering med Pinterest Tag fungerar, hur du testar och hur du sätter upp allt på Shopify.

Vad är Pinterest Conversions API?

Pinterest Tag är ett skript i köparens webbläsare. Conversions API gör samma jobb från en server. I API-version 5 skickar du händelser till events-endpointen för ditt annonskonto, auktoriserad med en åtkomsttoken för konverteringar som du skapar i Pinterest Ads Manager. Varje händelse anger var den inträffade: för en webbshop är action source web.

Pinterest ber annonsörer som också använder Tag att undvika att räkna en konvertering två gånger, genom att skicka med ett event_id för varje händelse. Pinterest ber också om händelser i realtid, eller högst en timme efter att de inträffat.

På Shopify har en serveranslutning en tydlig fördel: köpen kommer från själva ordern. Shopify rapporterar varje betald order till ROASaurus via webhook, och ROASaurus skickar den till Pinterest kort efter betalningen, oavsett om Tag utlöstes i webbläsaren. Guiden om server-side tracking på Shopify förklarar idén mer ingående.

Vilka händelser accepterar Pinterest Conversions API?

Pinterest har en fast lista med standardhändelsenamn, skrivna med gemener och understreck, som page_visit, add_to_cart och checkout. Du kan också definiera upp till 15 egna händelsetyper per annonsör. ROASaurus mappar de fem shoppinghändelserna i Shopify så här:

Namnet kan förvirra. Pinterests checkout är det slutförda köpet, inte starten på kassan. Starten på kassan är en separat händelse, initiate_checkout.

För kassahändelsen rekommenderar Pinterest att du skickar värdet, valutan, order-id:t, content-id:n och antalet artiklar. ROASaurus skickar alla fem, plus varje artikels antal och pris. Pinterest ber om värdet före skatt och frakt. På Shopify skickar ROASaurus precis det: ordersumman minus skatt och frakt, både från servern och från webbläsartaggen. När en webbshopplattform inte rapporterar skatt och frakt separat skickar ROASaurus ordersumman.

Hur matchar Pinterest en händelse mot en person?

Varje händelse bär användardata. Pinterest kräver minst en av tre saker: en hashad e-postadress, ett hashat mobilt annons-id eller IP-adressen tillsammans med user agent. En webbshop har inget annons-id, så den behöver e-postadressen eller IP-adressen och user agent. ROASaurus hoppar över en händelse som saknar båda, i stället för att skicka en som Pinterest inte kan använda.

Klick-id:t epik

Pinterests klick-id kan komma från två ställen: en epik-parameter i landningssidans URL eller cookien _epik på din domän. Pinterests API-guide rekommenderar att du skickar värdet från cookien _epik, eftersom den fortfarande fungerar när URL-parametern saknas eller har tagits bort, vilket ger bättre täckning.

ROASaurus läser båda i din webbshop och använder URL-parametern när ett nytt klick har med en, och annars cookien. Det sparar klick-id:t tillsammans med besökaren och skickar det i fältet click_id för varje serverhändelse, inklusive köpet. Besök med en epik räknas som Pinterest-besök 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
    }
  }]
}

Hur fungerar deduplicering med Pinterest Tag?

Om Tag och API båda rapporterar ett köp får Pinterest två händelser för en order. För att behandla dem som en behöver Pinterest samma id på båda sidor: händelse-id:t i Tag måste matcha event_id i serverhändelsen. Pinterest behåller den första händelsen den tar emot och tar bort dubbletter som kommer in inom 48 timmar.

ROASaurus bygger köp-id:t från Shopifys order-id. Köpet från ordern 5512345678901 har händelse-id:t order-5512345678901, både i den Tag som utlöses i kassan och i serverhändelsen.

Alla fem händelserna dedupliceras

Varje shoppinghändelse i ROASaurus har ett händelse-id, som används av Tag i webbläsaren och av serverhändelsen. Tag använder Pinterests egna namn för samma händelser: pagevisit, viewcontent, addtocart, initiatecheckout och checkout, som motsvarar page_visit, view_content, add_to_cart, initiate_checkout och checkout i API:et. När båda körs behåller alltså Pinterest en kopia av varje sidbesök, produktvisning, tillägg i varukorgen, påbörjat köp och köp.

Du kan köra det på två sätt:

• Tag och Conversions API tillsammans. Tag lägger till webbläsarsignaler, servern fyller i det som Tag missar och Pinterest slår ihop kopiorna.
• Kör API:et utan Tag. Lämna Tag ID tomt eller stäng av Also load the browser tag. Varje händelse skickas då en gång, bara från servern.

Hjälpartikeln om dubbelräkning går igenom samma kontroller för de andra annonsplattformarna.

Hur testar du Pinterest Conversions API?

API:et har en testflagga. Anrop som skickas med test=true går till en sandbox: Pinterest hanterar dem som testdata och använder dem inte för rapportering eller optimering.

1. Slå på testläget

   Redigera Pinterest-pixeln i ROASaurus under Tracking & platforms och kryssa i Test mode (events show under Test events, max 20). Varje serverhändelse skickas då med test=true. Pinterest behandlar högst 20 testhändelser per batch.

2. Lägg en testorder

   Besök din butik, titta på en produkt, lägg den i varukorgen och slutför en order.

3. Läs resultatet

   Öppna Event log. Pinterest kan svara med HTTP 200 även om en händelse i ett anrop misslyckades, så ROASaurus kontrollerar statusen för varje händelse och visar misslyckanden där.

4. Stäng av testläget

   Avmarkera testläget, så att händelserna räknas i rapportering och optimering.

5. Kontrollera Events Overview

   Öppna sidan Events Overview i Pinterest Ads Manager. Den visar de händelser som kommer in och de deduplicerade konverteringarna. Pinterest rekommenderar att du siktar på en Good Event Quality Score.

Så sätter du upp Pinterest Conversions API på Shopify med ROASaurus

Du behöver en Shopify-butik med ROASaurus-appen och tillgång till Pinterest Ads Manager. Pinterest-integrationssidan listar varje fält som ROASaurus skickar.

1. Anslut din Shopify-butik

   Gå till Add a store › Shopify, klicka på Install app och slå på ROASaurus-appinbäddningen i temaredigeraren. Den fångar epik och cookien _epik på varje sida. Guiden för Shopify-uppsättning visar varje steg.

2. Skapa en åtkomsttoken för konverteringar

   Gå till Conversions i Pinterest Ads Manager och skapa en åtkomsttoken för konverteringar. Notera ditt annonskonto-id.

3. Lägg till Pinterest-pixeln i ROASaurus

   Gå till Tracking & platforms, klicka på Add pixel på Pinterest-kortet och fyll i Ad account ID och Conversion access token.

4. Lägg till ditt Tag ID

   För deduplicering med Tag fyller du i Pinterest Tag ID och låter Also load the browser tag vara ikryssat. Utan Tag ID skickar ROASaurus bara serverhändelser och laddar inte Tag.

5. Lägg till kassapixeln

   Gå till Shopify admin › Settings › Customer events, lägg till en anpassad pixel med namnet ROASaurus och klistra in snippeten från sidan Tracking & platforms. Den utlöser Tags checkout-händelse i Shopifys kassa, med order-id:t som event_id.

6. Välj serverhändelser och testa sedan

   Välj de serverhändelser du vill ha och testa med testläget innan du går live.

Med Respect visitor consent påslaget, vilket är standard, följer ROASaurus köparens val i Shopifys cookiebanner. När en köpare tackar nej till marknadsföringscookies laddar ROASaurus inte Pinterest Tag för den personen, sätter inget besökar-id, så att personens klick inte kopplas till den, och skickar inte webbläsarhändelserna till Pinterest. Den betalda ordern skickas ändå till Conversions API från servern, med hashad orderdata samt orderns IP-adress och user agent, men utan klick-id. Guiden om samtycke och integritet förklarar vad som sparas och skickas.

Anslut ditt Pinterest-annonskonto under Setup › Ad spend så hämtar ROASaurus kampanjkostnaderna varje timme, och du ser Pinterest-ROAS och vinst efter annonser i vinstanalysen. Guiden om TikTok Events API går igenom samma uppsättning för TikTok, där varje händelse som går åt båda hållen dedupliceras.

Källor

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: förhindra dubbelräkning

Läs vidare