TikTok Events API pro Shopify: nastavení a deduplikace

TikTok Events API je propojení TikToku pro konverzní data z jednoho serveru na druhý. Místo toho, aby se spoléhal jen na pixel TikTok v prohlížeči nakupujícího, odesílá váš obchod nebo nástroj, jako je ROASaurus, události, například nákupy, přímo na TikTok. TikTok doporučuje provozovat Events API vedle pixelu a deduplikovat obojí sdíleným event_id.

Tento průvodce se věnuje tomu, co Events API odesílá z e-shopu na Shopify, názvům událostí Purchase a CompletePayment, ID kliknutí a cookie, podle kterých TikTok páruje, jak funguje deduplikace, jak testovat v TikTok Events Manageru a jak to celé nastavit v ROASaurus.

Co je TikTok Events API?

Pixel TikTok je skript ve vašem e-shopu. Spouští události z prohlížeče nakupujícího, takže počítá jen to, co se stane, když se skript načte a běží. Zastavit ho může blokátor reklam, chyba skriptu nebo nakupující, který zavře kartu dřív, než se načte potvrzení objednávky.

Events API odesílá stejný druh události ze serveru. Na Shopify je nejspolehlivějším záznamem o nákupu samotná objednávka. Shopify hlásí každou zaplacenou objednávku webhookem, ať skript v prohlížeči běžel, nebo ne. To je myšlenka za server-side trackingem na Shopify.

Oba způsoby nejsou alternativy. TikTok radí sdílet události oběma způsoby, držet je konzistentní napříč nákupní cestou a nechat TikTok odstranit duplicity.

Které události ROASaurus odesílá do TikToku?

Pro optimalizaci TikToku jsou v e-shopu na Shopify důležité čtyři okamžiky: zobrazení produktu, přidání do košíku, zahájení pokladny a nákup. ROASaurus všechny čtyři odesílá do Events API a stejné čtyři spouští přes pixel TikTok, se stejnými ID událostí. Zobrazení stránek jdou jen přes pixel.

V nastavení pixelu můžete odškrtnout serverové události, které odesílat nechcete, a přidat filtry, například zemi nebo minimální hodnotu objednávky.

Purchase, nebo CompletePayment?

TikTok přejmenoval svou událost nákupu. Aktuální název je Purchase. Starý název CompletePayment stále funguje: TikTok převádí staré názvy na své straně, v reportingu, publikách a optimalizaci je zobrazuje pod novým názvem a uvádí, že CompletePayment bude podporován neomezeně dlouho. TikTok žádá, aby nová nastavení pixelu používala Purchase.

ROASaurus odesílá CompletePayment, v pixelu i v Events API. V TikTok Events Manageru a Ads Manageru se tyto události zobrazují jako Purchase. Pro deduplikaci je důležité, aby obě kopie nákupu používaly stejný název události, a používají ho.

Jak TikTok spáruje událost s nakupujícím?

Událost pomůže vašim kampaním jen tehdy, když ji TikTok dokáže propojit s člověkem, který reklamu viděl nebo na ni klikl. TikTok tyto identifikátory nazývá párovací klíče (match keys) a jeho průvodce Events API žádá, abyste předávali zpět všechny relevantní párovací klíče, čímž se zvýší míra spárování. Events Manager ukazuje výsledek jako skóre Event Match Quality, vážený průměr toho, jak často je každý párovací klíč přítomen.

TikTok uvádí, že pixel ve výchozím nastavení sdílí IP adresu a user agent, ale Events API vyžaduje jejich ruční přidání. ROASaurus je bere z relace pokladny nakupujícího, nebo z objednávky, pokud relace nebyla. Na Shopify vyžadují pozornost ještě dva další klíče.

ttclid: ID kliknutí z TikToku

Když nakupující klikne na reklamu na TikToku, TikTok přidá ttclid do URL vstupní stránky. Pokud ho váš obchod na první stránce neuloží, je pryč v době, kdy objednávka dorazí, o několik stránek později. ROASaurus čte ttclid na vstupní stránce, uloží ho spolu s ID návštěvníka, zapíše ho do košíku Shopify a přidá ho do serverové události, když objednávka přijde.

_ttp: cookie pixelu

Cookie _ttp je first-party cookie, kterou pixel TikTok používá na vaší doméně. ROASaurus ji čte v e-shopu i v pokladně a odesílá ji jako ttp v serverové události. Je to další důvod ponechat pixel spuštěný vedle Events API.

{
  "event_source": "web",
  "event_source_id": "CXXXXXXXXXXXXXXXXXXX",
  "data": [{
    "event": "CompletePayment",
    "event_time": 1793016000,
    "event_id": "order-5512345678901",
    "user": {
      "email": "a3f1…9c2e",
      "phone": "7b40…11d8",
      "external_id": "e05c…4a7f",
      "ttclid": "E.C.P.v3…",
      "ttp": "2Xb7…",
      "ip": "203.0.113.24",
      "user_agent": "Mozilla/5.0 (iPhone; …)"
    },
    "page": { "url": "https://example-store.com/checkouts/…/thank-you" },
    "properties": {
      "currency": "USD",
      "value": 84,
      "content_type": "product",
      "contents": [{ "content_id": "44123456789", "content_name": "Linen shirt", "quantity": 2, "price": 42 }],
      "order_id": "5512345678901"
    }
  }]
}

Jak funguje deduplikace?

Když pixel i Events API nahlásí stejný nákup, TikTok dostane dvě události pro jednu objednávku. Aby ponechal jen jednu, potřebuje, aby byly v obou kopiích shodné dvě hodnoty: název události a event_id. TikTok pak zaznamená první kopii, kterou přijme, pro měření a reporting, takže se objednávka počítá jednou. Funguje to pro odpovídající kopie, které dorazí do 48hodinového okna od první.

ROASaurus sestavuje ID události nákupu z ID objednávky Shopify. Nákup z objednávky 5512345678901 má ID události order-5512345678901, v pixelu v pokladně i na serveru. Události z e-shopu, například zobrazení produktů a přidání do košíku, dostanou v okamžiku vzniku náhodné ID a kopie z prohlížeče a ze serveru ho sdílejí.

Co to znamená pro čísla. Vezměme ukázkový e-shop s 200 objednávkami za týden. Pixel se spustí u 150 z nich. Ostatních 50 nakupujících použilo blokátor reklam, odmítlo marketingové cookies nebo odešlo dřív, než se načetla stránka s potvrzením. Events API odešle všech 200.

Číslo 350 je to, co by vás mělo znepokojit. Počet nákupů v TikToku a ROAS, který se z něj počítá, by byl o 75% vyšší než ve skutečnosti, protože 350 ÷ 200 = 1.75. TikTok tyto události používá také pro optimalizaci a cílení, takže by se jeho bidding učil ze 150 nákupů, které se nestaly.

Proč se na Shopify nákupy počítají dvakrát?

K dvojímu započítání dochází, když TikTok dostane dvě kopie nákupu, které nedokáže spárovat. Než uvěříte skoku v nákupech na TikToku, zkontrolujte tyto příčiny:

• Dva nástroje odesílají stejný pixel. Aplikace prodejního kanálu TikTok na Shopify může odesílat události i pro váš pixel. Její ID událostí neodpovídají ID, která používá ROASaurus, takže TikTok započítá každou objednávku dvakrát. Odpojte pixel v této aplikaci.
• Pixel je také v kódu vašeho motivu. Úryvek pixelu vložený do motivu spouští vlastní události bez vašich ID událostí. Odstraňte ho a nechte pixel načítat jen jeden nástroj.
• Jedna strana nemá event_id. Serverový nákup bez event_id nebo s novým náhodným ID nelze spárovat s kopií z pixelu.
• Názvy událostí se liší. TikTok deduplikuje jen shodné události. Obě kopie nákupu musí používat stejný název události.

Článek nápovědy o dvojím započítání projde stejné kontroly pro Meta a ostatní platformy.

Jak otestovat Events API v TikTok Events Manageru?

TikTok Events Manager má záložku Test events pro události z prohlížeče i ze serveru. Použijte ji dřív, než se na data spolehnete:

1. Zkopírujte kód testovací události

   V TikTok Events Manageru otevřete svůj pixel a přejděte na Test events. Zkopírujte kód testovací události.

2. Vložte ho v ROASaurus

   Otevřete Tracking & platforms, upravte pixel TikTok a vložte kód do pole Test event code. Serverové události ho teď ponesou.

3. Zadejte testovací objednávku

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

4. Zkontrolujte obě strany

   V Test events filtrujte události z prohlížeče a ze serveru. Nákup byste měli vidět z obou. V ROASaurus Event log ukazuje každé serverové doručení jako odeslané nebo neúspěšné.

5. Odstraňte testovací kód

   Až skončíte, smažte kód testovací události, aby se vaše živé serverové události už neodesílaly jako testovací.

TikTok může na požadavek odpovědět HTTP 200 a událost přesto odmítnout, s chybovým kódem v těle odpovědi. ROASaurus tento kód čte, takže odmítnutá událost se v Event log zobrazí jako neúspěšná, místo aby tiše prošla.

Po dni živého provozu otevřete přehled pixelu v Events Manageru. Uvádí každou událost se způsobem připojení, skóre Event Match Quality a časem posledního přijetí. Podrobnosti události obsahují informace o párování a deduplikaci a Diagnostics uvádí problémy s kvalitou s návodem, jak je opravit.

Jak nastavit TikTok Events API na Shopify pomocí ROASaurus

Potřebujete e-shop na Shopify s aplikací ROASaurus a přístup do TikTok Events Manageru. Stránka integrace TikTok 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. Embed zachytává ttclid a cookie _ttp na každé stránce. Jednotlivé kroky ukazuje průvodce nastavením Shopify.

2. 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í pixel TikTok v pokladně, včetně kopie nákupu z prohlížeče.

3. Vytvořte přístupový token

   V TikTok Events Manageru otevřete svůj pixel a v jeho nastavení vygenerujte přístupový token Events API. Zkopírujte token a kód pixelu.

4. Přidejte pixel TikTok v ROASaurus

   Přejděte do Tracking & platforms, na kartě TikTok klikněte na Add pixel a vyplňte Pixel code a Events API access token. Ponechte zaškrtnuté Also load the browser pixel (recommended, deduplicated), aby události z prohlížeče a ze serveru sdílely ID.

5. Přidejte útratu (volitelné)

   Vyplňte Advertiser ID for spend a Marketing API token. ROASaurus pak importuje útratu z TikToku, takže kampaně na TikToku zobrazují ROAS a CPA vedle vašich ostatních kanálů.

6. Otestujte a spusťte naostro

   Odešlete testovací objednávku s kódem testovací události, jak je popsáno výše, a poté kód odstraňte.

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 pixel TikTok, 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 TikTok. Jeho zaplacená objednávka se přesto odešle do Events API ze serveru, s hashovanými daty objednávky a s IP adresou a user agentem objednávky, ale bez ttclid nebo _ttp. Co se ukládá a odesílá, vysvětluje průvodce souhlasem a soukromím.

Se synchronizovanou útratou se kampaně na TikToku objevují v atribučních reportech vedle Meta a analýza kreativ přidává statistiky videí z TikToku na úrovni reklam. ROASaurus připisuje objednávky kliknutím na reklamy a UTM, která zaznamenal, a konverze po zhlédnutí (view-through) počítá jen jako modelovaný odhad ve svém modelu Clicks & views, takže jeho součty se obvykle liší od TikTok Ads Manageru. Pro další server-side platformy viz průvodce Pinterest Conversions API a průvodce Meta Conversions API.

Zdroje

1. TikTok For Business: About Events API
2. TikTok Ads Manager: About Event Deduplication
3. TikTok Ads Manager: How to Adopt TikTok's Updated Standard Events
4. TikTok Ads Manager: How to set up matching events with Events API
5. TikTok Ads Manager: About diagnostic and monitoring tools in TikTok Events Manager

V ROASaurus

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

Čtěte dál