Pinterest Conversions API Shopifyhoz: beállítási útmutató

A Pinterest Conversions API a Pinterest szerver–szerver módszere konverziós események küldésére. A webáruházad vagy egy olyan eszköz, mint a ROASaurus, közvetlenül a Pinterest hirdetési fiókodba küldi az olyan eseményeket, mint a vásárlások, ahelyett, hogy csak a vásárló böngészőjében futó Pinterest Tagre támaszkodna. A Pinterest az adatokat konverziós riportoláshoz, kampányoptimalizáláshoz és célzáshoz használja.

Ez az útmutató a v5 API-t és az általa elfogadott eseményeket, az epik kattintásazonosítót, az ügyféladatok hashelését, a Pinterest Taggel való deduplikáció működését, a tesztelést, valamint az egész Shopifyon való beállítását tárgyalja.

Mi a Pinterest Conversions API?

A Pinterest Tag egy script a vásárló böngészőjében. A Conversions API ugyanezt a munkát végzi egy szerverről. Az API 5-ös verziójában az eseményeket a hirdetési fiókod events végpontjára küldöd, egy olyan konverziós hozzáférési tokennel engedélyezve, amelyet a Pinterest Ads Managerben hozol létre. Minden esemény megmondja, hol történt: webáruháznál az action source értéke web.

A Pinterest arra kéri azokat a hirdetőket, akik a Taget is használják, hogy kerüljék a konverziók kétszeri számolását úgy, hogy minden eseménnyel együtt event_id-t adnak át. Azt is kéri, hogy az események valós időben, de legfeljebb egy órával a megtörténtük után érkezzenek meg.

Shopifyon a szerveres kapcsolatnak van egy egyértelmű előnye: a vásárlások magából a rendelésből jönnek. A Shopify minden kifizetett rendelést webhookon jelent a ROASaurusnak, a ROASaurus pedig röviddel a fizetés után elküldi a Pinterestnek, akár elsült a Tag a böngészőben, akár nem. A Shopifyos szerveroldali követésről szóló útmutató mélyebben elmagyarázza az alapgondolatot.

Milyen eseményeket fogad el a Pinterest Conversions API?

A Pinterestnek van egy rögzített standard eseménynév-listája, kisbetűkkel és aláhúzásjelekkel írva, például page_visit, add_to_cart és checkout. Hirdetőnként legfeljebb 15 egyéni eseménytípust is meghatározhatsz. A ROASaurus az öt Shopify vásárlási eseményt így képezi le:

A név félrevezető lehet. A Pinterest checkout eseménye a befejezett vásárlás, nem a pénztárba lépés. A pénztárba lépés külön esemény, az initiate_checkout.

A checkout eseményhez a Pinterest az érték, a pénznem, a rendelésazonosító, a content id-k és a tételek számának elküldését javasolja. A ROASaurus mind az ötöt elküldi, valamint minden tétel mennyiségét és árát. A Pinterest az adó és a szállítás nélküli értéket kéri. Shopifyon a ROASaurus pontosan ezt küldi: a rendelés végösszegét az adó és a szállítás nélkül, a szerverről és a böngészőcímkéből is. Ha egy webáruház-platform nem jelenti külön az adót és a szállítást, a ROASaurus a rendelés végösszegét küldi.

Hogyan párosít a Pinterest egy eseményt egy személlyel?

Minden esemény felhasználói adatokat hordoz. A Pinterest a következő háromból legalább egyet megkövetel: hashelt e-mail-cím, hashelt mobil hirdetési azonosító, vagy az IP-cím a user agenttel együtt. Egy webáruháznak nincs hirdetési azonosítója, ezért e-mail-címre, vagy IP-címre és user agentre van szüksége. A ROASaurus kihagyja azt az eseményt, amelyben egyik sincs, ahelyett, hogy olyat küldene, amelyet a Pinterest nem tud használni.

Az epik kattintásazonosító

A Pinterest kattintásazonosítója két helyről érkezhet: a landing oldal URL-jében lévő epik paraméterből, vagy a domainedon lévő _epik sütiből. A Pinterest API-útmutatója a _epik süti értékének átadását javasolja, mert az akkor is működik, ha az URL-paraméter hiányzik vagy eltávolították, így jobb a lefedettség.

A ROASaurus mindkettőt kiolvassa a webáruházadon: az URL-paramétert használja, ha egy új kattintás hoz egyet, egyébként a sütit. A kattintásazonosítót a látogatóval együtt eltárolja, és minden szerveresemény click_id mezőjében elküldi, a vásárlást is beleértve. Az epik-kel rendelkező látogatások Pinterest-látogatásnak számítanak a ROASaurus attribúciós riportjaiban.

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
    }
  }]
}

Hogyan működik a deduplikáció a Pinterest Taggel?

Ha a Tag és az API is jelent egy vásárlást, a Pinterest két eseményt kap egyetlen rendelésről. Ahhoz, hogy egynek kezelje őket, mindkét oldalon ugyanaz az azonosító kell: a Tagben lévő eseményazonosítónak egyeznie kell a szerveresemény event_id mezőjével. A Pinterest az elsőként kapott eseményt tartja meg, és eltávolítja a 48 órán belül érkező duplikátumokat.

A ROASaurus a vásárlásazonosítót a Shopify rendelésazonosítójából képezi. Az 5512345678901-es rendelés vásárlásának order-5512345678901 az eseményazonosítója, mind a pénztárban elsülő Tagben, mind a szerveresemény esetében.

Mind az öt esemény deduplikálódik

A ROASaurusban a vásárlási folyamat minden eseményének egy eseményazonosítója van, amelyet a böngészőben a Tag és a szerveresemény is használ. A Tag a Pinterest saját neveit használja ugyanazokra az eseményekre: pagevisit, viewcontent, addtocart, initiatecheckout és checkout, amelyek az API-ban a page_visit, view_content, add_to_cart, initiate_checkout és checkout névnek felelnek meg. Így ha mindkettő fut, a Pinterest minden oldallátogatásból, termékmegtekintésből, kosárba tételből, pénztárba lépésből és vásárlásból egy példányt tart meg.

Kétféleképpen futtathatod:

• Tag és Conversions API együtt. A Tag böngészős jeleket ad hozzá, a szerver pótolja, amit a Tag kihagy, a Pinterest pedig összevonja a példányokat.
• Futtasd az API-t a Tag nélkül. Hagyd üresen a Tag ID mezőt, vagy kapcsold ki az Also load the browser tag opciót. Ekkor minden esemény egyszer, csak a szerverről megy.

A dupla számolásról szóló súgócikk ugyanezeket az ellenőrzéseket tárgyalja a többi hirdetési platformra.

Hogyan teszteled a Pinterest Conversions API-t?

Az API-nak van egy teszt jelzője. A test=true jelzéssel küldött kérések egy sandboxba mennek: a Pinterest teszt adatként kezeli őket, és nem használja riportoláshoz vagy optimalizáláshoz.

1. Kapcsold be a tesztmódot

   A ROASaurusban szerkeszd a Pinterest pixelt a Tracking & platforms alatt, és jelöld be a Test mode (events show under Test events, max 20) opciót. Ekkor minden szerveresemény test=true jelzéssel megy el. A Pinterest kötegenként legfeljebb 20 teszteseményt dolgoz fel.

2. Adj le egy tesztrendelést

   Látogass el a webáruházadba, nézz meg egy terméket, tedd kosárba, és add le a rendelést.

3. Olvasd el az eredményt

   Nyisd meg az Event log-ot. A Pinterest HTTP 200-zal is válaszolhat, miközben egy kérésben az egyik esemény hibás volt, ezért a ROASaurus ellenőrzi az egyes események állapotát, és itt mutatja a hibákat.

4. Kapcsold ki a tesztmódot

   Vedd ki a tesztmód jelölését, hogy az események beleszámítsanak a riportolásba és az optimalizálásba.

5. Nézd meg az Events Overview-t

   A Pinterest Ads Managerben nyisd meg az Events Overview oldalt. Megmutatja az érkező eseményeket és a deduplikált konverziókat. A Pinterest a Good Event Quality Score elérését javasolja.

A Pinterest Conversions API beállítása Shopifyon a ROASaurusszal

Szükséged van egy Shopify webáruházra a ROASaurus appal, és hozzáférésre a Pinterest Ads Managerhez. A Pinterest-integráció oldala felsorol minden mezőt, amelyet a ROASaurus elküld.

1. Csatlakoztasd a Shopify webáruházadat

   Lépj az Add a store › Shopify részhez, kattints az Install app gombra, és kapcsold be a ROASaurus app-beágyazását a sablonszerkesztőben. Ez minden oldalon rögzíti az epik-et és az _epik sütit. A Shopify beállítási útmutató minden lépést bemutat.

2. Hozz létre egy konverziós hozzáférési tokent

   A Pinterest Ads Managerben lépj a Conversions részhez, és hozz létre egy konverziós hozzáférési tokent. Jegyezd fel a hirdetési fiókod azonosítóját.

3. Add hozzá a Pinterest pixelt a ROASaurusban

   Lépj a Tracking & platforms részhez, kattints az Add pixel gombra a Pinterest kártyán, és töltsd ki az Ad account ID és a Conversion access token mezőt.

4. Add meg a Tag ID-t

   A Taggel való deduplikációhoz töltsd ki a Pinterest Tag ID mezőt, és hagyd bejelölve az Also load the browser tag opciót. Tag ID nélkül a ROASaurus csak szervereseményeket küld, és nem tölti be a Taget.

5. Add hozzá a pénztári pixelt

   A Shopify admin › Settings › Customer events oldalon adj hozzá egy ROASaurus nevű custom pixelt, és illeszd be a Tracking & platforms oldalon található kódrészletet. Ez a Shopify pénztárában elsüti a Tag checkout eseményét, event_id-ként a rendelésazonosítóval.

6. Válaszd ki a szervereseményeket, majd tesztelj

   Válaszd ki a kívánt szervereseményeket, és éles indulás előtt teszteld tesztmóddal.

A Respect visitor consent bekapcsolt állapotában, ami az alapértelmezett, a ROASaurus a vásárló Shopify cookie-bannerében hozott döntését követi. Ha egy vásárló elutasítja a marketingsütiket, a ROASaurus nem tölti be neki a Pinterest Taget, nem állít be látogatóazonosítót, így a kattintásai nem kapcsolódnak hozzá, és a böngészési eseményeit nem küldi el a Pinterestnek. A kifizetett rendelését a szerver ettől még elküldi a Conversions API-nak, hashelt rendelési adatokkal, valamint a rendelés IP-címével és user agentjével, de kattintásazonosító nélkül. A hozzájárulásról és adatvédelemről szóló útmutató elmagyarázza, mit tárolunk és küldünk el.

Csatlakoztasd a Pinterest hirdetési fiókodat a Setup › Ad spend alatt, és a ROASaurus óránként lekéri a kampányköltést, így a profitanalitikában látod a Pinterest ROAS-át és a hirdetések utáni profitot. A TikTok Events API útmutató ugyanezt a beállítást tárgyalja a TikTokra, ahol minden mindkét úton menő esemény deduplikálódik.

Források

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

A ROASaurusban

• Pinterest-integráció
• Szerveroldali követés a ROASaurusban
• Súgó: a dupla számolás megelőzése

Olvass tovább