Pinterest Conversions API pro Shopify: průvodce nastavením

Pinterest Conversions API je způsob Pinterestu, jak odesílat konverzní události z jednoho serveru na druhý. Váš obchod nebo nástroj, jako je ROASaurus, odesílá události, například nákupy, přímo do vašeho reklamního účtu na Pinterest, místo aby se spoléhal jen na Pinterest Tag v prohlížeči nakupujícího. Pinterest data využívá pro reporting konverzí, optimalizaci kampaní a cílení.

Tento průvodce se věnuje API v5 a událostem, které přijímá, ID kliknutí epik, tomu, jak se hashují údaje o zákazníkovi, jak funguje deduplikace s Pinterest Tag, jak testovat a jak to celé nastavit na Shopify.

Co je Pinterest Conversions API?

Pinterest Tag je skript v prohlížeči nakupujícího. Conversions API dělá stejnou práci ze serveru. V API verze 5 odesíláte události na endpoint událostí svého reklamního účtu, autorizovaný přístupovým tokenem konverzí, který vytvoříte v Pinterest Ads Manageru. Každá událost uvádí, kde se stala: u e-shopu je zdrojem akce web.

Pinterest žádá inzerenty, kteří používají i Tag, aby se vyhnuli dvojímu započítání konverze tím, že s každou událostí předají event_id. Také žádá události v reálném čase, nebo nejpozději hodinu po jejich vzniku.

Na Shopify má serverové propojení jednu zřejmou výhodu: nákupy pocházejí přímo z objednávky. Shopify nahlásí každou zaplacenou objednávku do ROASaurus přes webhook a ROASaurus ji krátce po zaplacení odešle na Pinterest, ať se Tag v prohlížeči spustil, nebo ne. Myšlenku podrobněji vysvětluje průvodce server-side trackingem na Shopify.

Které události Pinterest Conversions API přijímá?

Pinterest má pevný seznam standardních názvů událostí, psaných malými písmeny s podtržítky, například page_visit, add_to_cart a checkout. Na inzerenta můžete definovat také až 15 vlastních typů událostí. ROASaurus mapuje pět nákupních událostí Shopify takto:

Název může být matoucí. Událost checkout na Pinterestu je dokončený nákup, ne začátek pokladny. Začátek pokladny je samostatná událost initiate_checkout.

Pro událost checkout Pinterest doporučuje odesílat hodnotu, měnu, ID objednávky, ID obsahu a počet položek. ROASaurus odesílá všech pět, navíc množství a cenu každé položky. Pinterest chce hodnotu před daní a dopravou. Na Shopify ROASaurus odesílá přesně to: celkovou částku objednávky bez daně a dopravy, ze serveru i ze značky v prohlížeči. Když platforma e-shopu nehlásí daň a dopravu zvlášť, ROASaurus odešle celkovou částku objednávky.

Jak Pinterest spáruje událost s člověkem?

Každá událost nese uživatelská data. Pinterest vyžaduje alespoň jednu ze tří věcí: hashovanou e-mailovou adresu, hashované mobilní reklamní ID, nebo IP adresu spolu s user agentem. E-shop reklamní ID nemá, takže potřebuje e-mail nebo IP adresu a user agent. ROASaurus událost, která nemá ani jedno, přeskočí, místo aby odeslal takovou, kterou Pinterest nemůže využít.

ID kliknutí epik

ID kliknutí z Pinterestu může pocházet ze dvou míst: z parametru epik v URL vstupní stránky, nebo z cookie _epik na vaší doméně. Průvodce API od Pinterestu doporučuje předávat hodnotu cookie _epik, protože funguje i tehdy, když parametr v URL chybí nebo byl odstraněn, což dává lepší pokrytí.

ROASaurus čte obojí ve vašem e-shopu: použije parametr z URL, když ho nové kliknutí přináší, a jinak cookie. ID kliknutí uloží k návštěvníkovi a odešle ho v poli click_id každé serverové události, včetně nákupu. Návštěvy s epik se v atribučních reportech ROASaurus počítají jako návštěvy z Pinterestu.

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

Jak funguje deduplikace s Pinterest Tag?

Pokud Tag i API nahlásí nákup, Pinterest dostane dvě události pro jednu objednávku. Aby je bral jako jednu, potřebuje na obou stranách stejné ID: ID události v Tagu musí odpovídat event_id v serverové události. Pinterest ponechá první událost, kterou přijme, a odstraní duplicity, které dorazí do 48 hodin.

ROASaurus sestavuje ID nákupu z ID objednávky Shopify. Nákup z objednávky 5512345678901 má ID události order-5512345678901, a to v Tagu, který se spouští v pokladně, i v serverové události.

Deduplikuje se všech pět událostí

Každá nákupní událost v ROASaurus má jedno ID události, které používá Tag v prohlížeči i serverová událost. Tag používá pro stejné události vlastní názvy Pinterestu: pagevisit, viewcontent, addtocart, initiatecheckout a checkout, které odpovídají page_visit, view_content, add_to_cart, initiate_checkout a checkout v API. Když tedy běží obojí, Pinterest ponechá jednu kopii každé návštěvy stránky, zobrazení produktu, přidání do košíku, zahájení pokladny a nákupu.

Můžete to provozovat dvěma způsoby:

• Tag a Conversions API společně. Tag přidává signály z prohlížeče, server doplní to, co Tag nezachytí, a Pinterest kopie sloučí.
• Provozujte API bez Tagu. Nechte pole ID Tagu prázdné nebo vypněte Also load the browser tag. Každá událost se pak odešle jednou, jen ze serveru.

Článek nápovědy o dvojím započítání pokrývá stejné kontroly pro ostatní reklamní platformy.

Jak otestovat Pinterest Conversions API?

API má testovací příznak. Požadavky odeslané s test=true jdou do sandboxu: Pinterest je zpracuje jako testovací data a nepoužije je pro reporting ani optimalizaci.

1. Zapněte testovací režim

   V ROASaurus upravte pixel Pinterest v části Tracking & platforms a zaškrtněte Test mode (events show under Test events, max 20). Každá serverová událost se pak odešle s test=true. Pinterest zpracuje nejvýše 20 testovacích událostí na dávku.

2. Zadejte testovací objednávku

   Navštivte svůj obchod, zobrazte produkt, přidejte ho do košíku a dokončete objednávku.

3. Přečtěte si výsledek

   Otevřete Event log. Pinterest může odpovědět HTTP 200, i když jedna událost v požadavku selhala, proto ROASaurus kontroluje stav každé události a selhání tam zobrazí.

4. Vypněte testovací režim

   Odškrtněte testovací režim, aby se události započítávaly do reportingu a optimalizace.

5. Zkontrolujte Events Overview

   V Pinterest Ads Manageru otevřete stránku Events Overview. Zobrazuje události, které přicházejí, a deduplikované konverze. Pinterest doporučuje mířit na Good Event Quality Score.

Jak nastavit Pinterest Conversions API na Shopify pomocí ROASaurus

Potřebujete e-shop na Shopify s aplikací ROASaurus a přístup do Pinterest Ads Manageru. Stránka integrace Pinterest uvádí všechna pole, která ROASaurus odesílá.

1. Připojte svůj e-shop na Shopify

   Přejděte na Add a store › Shopify, klikněte na Install app a v editoru motivů zapněte app embed ROASaurus. Zachytává epik a cookie _epik na každé stránce. Jednotlivé kroky ukazuje průvodce nastavením Shopify.

2. Vytvořte přístupový token konverzí

   V Pinterest Ads Manageru přejděte do části Conversions a vytvořte přístupový token konverzí. Poznamenejte si ID svého reklamního účtu.

3. Přidejte pixel Pinterest v ROASaurus

   Přejděte do Tracking & platforms, na kartě Pinterest klikněte na Add pixel a vyplňte Ad account ID a Conversion access token.

4. Přidejte své ID Tagu

   Pro deduplikaci s Tagem vyplňte Pinterest Tag ID a ponechte zaškrtnuté Also load the browser tag. Bez ID Tagu ROASaurus odesílá jen serverové události a Tag nenačítá.

5. Přidejte pixel pro pokladnu

   V Shopify admin › Settings › Customer events přidejte vlastní pixel s názvem ROASaurus a vložte úryvek ze stránky Tracking & platforms. Spouští událost checkout Tagu v pokladně Shopify s ID objednávky jako event_id.

6. Vyberte serverové události a otestujte

   Vyberte serverové události, které chcete, a před spuštěním naživo otestujte v testovacím režimu.

Se zapnutou volbou Respect visitor consent, což je výchozí nastavení, ROASaurus respektuje volbu nakupujícího v cookie liště Shopify. Když nakupující odmítne marketingové cookies, ROASaurus pro něj nenačte Pinterest Tag, nenastaví žádné ID návštěvníka, takže jeho kliknutí se k němu nepropojí, a neodešle jeho události procházení na Pinterest. Jeho zaplacená objednávka se přesto odešle do Conversions API ze serveru, s hashovanými daty objednávky a s IP adresou a user agentem objednávky, ale bez ID kliknutí. Co se ukládá a odesílá, vysvětluje průvodce souhlasem a soukromím.

Připojte svůj reklamní účet Pinterest v části Setup › Ad spend a ROASaurus bude každou hodinu stahovat útratu kampaní, takže v analýze zisku uvidíte ROAS a zisk po reklamách pro Pinterest. Průvodce TikTok Events API pokrývá totéž nastavení pro TikTok, kde se deduplikuje každá událost, která jde oběma cestami.

Zdroje

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

V ROASaurus

• Integrace Pinterest
• Server-side tracking v ROASaurus
• Nápověda: předcházení dvojímu započítání

Čtěte dál