TikTok Events API Shopifyhoz: beállítás és deduplikáció

A TikTok Events API a TikTok szerver–szerver kapcsolata konverziós adatokhoz. Ahelyett, hogy csak a vásárló böngészőjében futó TikTok pixelre támaszkodna, a webáruházad vagy egy olyan eszköz, mint a ROASaurus, közvetlenül a TikToknak küldi az olyan eseményeket, mint a vásárlások. A TikTok azt javasolja, hogy az Events API-t a pixel mellett futtasd, és a kettőt egy közös event_id-val deduplikáld.

Ez az útmutató azt tárgyalja, mit küld az Events API egy Shopify webáruházból, a Purchase és a CompletePayment eseménynevet, azt a kattintásazonosítót és sütit, amelyre a TikTok párosít, hogyan működik a deduplikáció, hogyan tesztelj a TikTok Events Managerben, és hogyan állítsd be az egészet a ROASaurusban.

Mi a TikTok Events API?

A TikTok pixel egy script a webáruházadon. A vásárló böngészőjéből süti el az eseményeket, ezért csak azt számolja, ami a script betöltése és futása alatt történik. Egy reklámblokkoló, egy scripthiba vagy egy vásárló, aki a rendelés-visszaigazolás betöltése előtt bezárja a lapot, mind megállíthatja.

Az Events API ugyanilyen eseményt küld egy szerverről. Shopifyon a vásárlás legmegbízhatóbb feljegyzése maga a rendelés. A Shopify minden kifizetett rendelést webhookon jelent, akár lefutott a böngészős script, akár nem. Ez a Shopifyos szerveroldali követés alapgondolata.

A kettő nem alternatíva. A TikTok javaslata, hogy mindkét úton oszd meg az eseményeket, tartsd őket konzisztensen a vásárlási úton, és hagyd, hogy a TikTok eltávolítsa a duplikátumokat.

Milyen eseményeket küld a ROASaurus a TikToknak?

A TikTok optimalizálása szempontjából egy Shopify webáruházban négy pillanat számít: a termékmegtekintés, a kosárba tétel, a pénztárba lépés és a vásárlás. A ROASaurus mind a négyet elküldi az Events API-nak, és ugyanezt a négyet elsüti a TikTok pixelen keresztül is, ugyanazokkal az eseményazonosítókkal. Az oldalmegtekintések csak a pixelen mennek át.

A pixel beállításaiban kiveheted a jelölést azokból a szervereseményekből, amelyeket nem akarsz küldeni, és szűrőket adhatsz hozzá, például egy országot vagy egy minimális rendelési értéket.

Purchase vagy CompletePayment?

A TikTok átnevezte a vásárlási eseményét. A jelenlegi név Purchase. A régi név, a CompletePayment továbbra is működik: a TikTok a saját oldalán átalakítja a régi neveket, az új név alatt jeleníti meg őket a riportolásban, a közönségekben és az optimalizálásban, és azt mondja, hogy a CompletePayment támogatott marad határozatlan ideig. A TikTok azt kéri, hogy az új pixelbeállítások a Purchase-t használják.

A ROASaurus a CompletePayment-et küldi, a pixelben és az Events API-ban is. A TikTok Events Managerben és az Ads Managerben ezek az események Purchase-ként jelennek meg. A deduplikációhoz az számít, hogy egy vásárlás mindkét példánya ugyanazt az eseménynevet használja, és ez teljesül.

Hogyan párosít a TikTok egy eseményt egy vásárlóval?

Egy esemény csak akkor segít a kampányaidnak, ha a TikTok össze tudja kapcsolni azzal a személlyel, aki látta vagy rákattintott a hirdetésre. A TikTok ezeket az azonosítókat párosítási kulcsoknak (match key) nevezi, és az Events API útmutatója azt kéri, hogy add vissza az összes releváns párosítási kulcsot a párosítási arány növeléséhez. Az Events Manager az eredményt Event Match Quality pontszámként mutatja, amely egy súlyozott átlag arról, hogy az egyes párosítási kulcsok milyen gyakran vannak jelen.

A TikTok megjegyzi, hogy a pixel alapértelmezetten megosztja az IP-címet és a user agentet, az Events API-nál viszont kézzel kell hozzáadni őket. A ROASaurus a vásárló pénztári munkamenetéből veszi őket, vagy a rendelésből, ha nem volt munkamenet. Shopifyon két másik kulcsra is figyelni kell.

ttclid: a TikTok kattintásazonosítója

Amikor egy vásárló rákattint egy TikTok-hirdetésre, a TikTok hozzáadja a ttclid paramétert a landing oldal URL-jéhez. Ha a webáruházad nem menti el az első oldalon, mire a rendelés megérkezik, több oldallal később, már nincs meg. A ROASaurus a landing oldalon kiolvassa a ttclid-et, eltárolja a látogatóazonosítóval együtt, beírja a Shopify kosárba, és hozzáadja a szervereseményhez, amikor a rendelés beérkezik.

_ttp: a pixelsüti

A _ttp süti egy first-party süti, amelyet a TikTok pixel használ a domaineden. A ROASaurus kiolvassa a webáruházban és a pénztárban, és ttp-ként elküldi a szerveresemény részeként. Ez egy újabb ok arra, hogy a pixel az Events API mellett is fusson.

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

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

Ha a pixel és az Events API is ugyanazt a vásárlást jelenti, a TikTok két eseményt kap egyetlen rendelésről. Hogy csak egyet tartson meg, a TikToknak két értéknek kell azonosnak lennie mindkét példányban: az eseménynévnek és az event_id-nek. A TikTok ekkor az elsőként kapott példányt rögzíti a méréshez és a riportoláshoz, így a rendelés egyszer számít. Ez az elsőtől számított 48 órás ablakon belül érkező, egyező példányoknál működik.

A ROASaurus a vásárlás eseményazonosítójá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, a pénztári pixelben és a szerveren is. A webáruházi események, például a termékmegtekintések és a kosárba tételek, a megtörténtükkor véletlenszerű azonosítót kapnak, és a böngészős és a szerveres példány ezt osztja meg.

Nézzük, mit jelent ez a számokra nézve. Vegyünk egy példa webáruházat, amelynek egy hét alatt 200 rendelése van. A pixel ebből 150-nél sül el. A másik 50 vásárló reklámblokkolót használt, elutasította a marketingsütiket, vagy elment, mielőtt a visszaigazoló oldal betöltődött volna. Az Events API mind a 200-at elküldi.

A 350 az a szám, amitől tartani kell. A TikTok vásárlásszámát és az arra épülő ROAS-t 75%-kal a valóság fölé emelné, mert 350 ÷ 200 = 1.75. A TikTok ezeket az eseményeket optimalizálásra és célzásra is használja, így a licitálása 150 olyan vásárlásból tanulna, amely meg sem történt.

Miért számolódnak kétszer a vásárlások Shopifyon?

A dupla számolás akkor történik, amikor a TikTok egy vásárlásnak két olyan példányát kapja meg, amelyeket nem tud párosítani. Mielőtt hiszel egy ugrásnak a TikTok-vásárlásokban, ellenőrizd ezeket az okokat:

• Két eszköz küldi ugyanazt a pixelt. A Shopify TikTok értékesítési csatorna appja is küldhet eseményeket a pixeledhez. Az eseményazonosítói nem egyeznek a ROASaurus által használt azonosítókkal, ezért a TikTok minden rendelést kétszer számol. Csatlakoztasd le a pixelt abban az appban.
• A pixel a sablonkódban is benne van. A sablonba beillesztett pixelkódrészlet a saját eseményeit süti el a te eseményazonosítóid nélkül. Távolítsd el, és hagyd, hogy egyetlen eszköz töltse be a pixelt.
• Az egyik oldalon nincs event_id. Az event_id nélküli, vagy új véletlenszerű azonosítóval rendelkező szerveres vásárlás nem párosítható a pixelpéldánnyal.
• Az eseménynevek eltérnek. A TikTok csak azonos eseményeket deduplikál. Egy vásárlás mindkét példányának ugyanazt az eseménynevet kell használnia.

A dupla számolásról szóló súgócikk ugyanezeket az ellenőrzéseket járja végig a Metára és a többi platformra.

Hogyan teszteled az Events API-t a TikTok Events Managerben?

A TikTok Events Managerben van egy Test events fül a böngésző- és a szervereseményekhez is. Használd, mielőtt az adatokra támaszkodsz:

1. Másolj ki egy teszteseménykódot

   A TikTok Events Managerben nyisd meg a pixeledet, és menj a Test events részhez. Másold ki a teszteseménykódot.

2. Illeszd be a ROASaurusban

   Nyisd meg a Tracking & platforms oldalt, szerkeszd a TikTok pixelt, és illeszd be a kódot a Test event code mezőbe. A szervereseményekben ezután ott lesz.

3. 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.

4. Ellenőrizd mindkét oldalt

   A Test events nézetben szűrj böngészős és szerveres eseményekre. A vásárlást mindkét oldalról látnod kell. A ROASaurusban az Event log minden szerveres kézbesítést elküldöttként vagy sikertelenként mutat.

5. Távolítsd el a tesztkódot

   Töröld a teszteseménykódot, amikor végeztél, hogy az éles szervereseményeid már ne teszteseményként menjenek el.

A TikTok HTTP 200-zal is válaszolhat egy kérésre, miközben elutasítja az eseményt, a válasz törzsében egy hibakóddal. A ROASaurus kiolvassa ezt a kódot, így az elutasított esemény az Event log-ban sikertelenként jelenik meg, nem megy át észrevétlenül.

Egy nap élő forgalom után nyisd meg a pixel áttekintését az Events Managerben. Felsorolja az egyes eseményeket a kapcsolati módjukkal, az Event Match Quality pontszámukkal és azzal, mikor érkeztek meg utoljára. Az esemény részletei párosítási és deduplikációs információt tartalmaznak, a Diagnostics pedig a minőségi problémákat sorolja fel a javításukra vonatkozó útmutatással.

A TikTok Events 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 TikTok Events Managerhez. A TikTok-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. A beágyazás minden oldalon rögzíti a ttclid-et és a _ttp sütit. A Shopify beállítási útmutató minden lépést bemutat.

2. 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 pénztárban elsüti a TikTok pixelt, a vásárlás böngészős példányát is beleértve.

3. Hozz létre egy hozzáférési tokent

   A TikTok Events Managerben nyisd meg a pixeledet, és a beállításaiban generálj egy Events API hozzáférési tokent. Másold ki a tokent és a pixelkódot.

4. Add hozzá a TikTok pixelt a ROASaurusban

   Lépj a Tracking & platforms részhez, kattints az Add pixel gombra a TikTok kártyán, és töltsd ki a Pixel code és az Events API access token mezőt. Hagyd bejelölve az Also load the browser pixel (recommended, deduplicated) opciót, hogy a böngészős és a szerveres események azonos azonosítókat használjanak.

5. Add hozzá a költést (opcionális)

   Töltsd ki az Advertiser ID for spend és a Marketing API token mezőt. A ROASaurus ekkor importálja a TikTok-költést, így a TikTok-kampányok a többi csatorna mellett mutatnak ROAS-t és CPA-t.

6. Tesztelj, majd indulj élesben

   Küldj egy tesztrendelést teszteseménykóddal a fent leírtak szerint, majd távolítsd el a kódot.

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 TikTok pixelt, 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 TikToknak. A kifizetett rendelését a szerver ettől még elküldi az Events API-nak, hashelt rendelési adatokkal, valamint a rendelés IP-címével és user agentjével, de ttclid és _ttp 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.

Szinkronizált költéssel a TikTok-kampányok a Meta mellett megjelennek az attribúciós riportokban, a kreatívelemzés pedig hirdetésenként hozzáadja a TikTok videóstatisztikáit. A ROASaurus a rendeléseket az általa rögzített hirdetési kattintásoknak és UTM-eknek írja jóvá, a view-through konverziókat pedig csak modellezett becslésként számolja a Clicks & views modelljében, ezért a végösszegei általában eltérnek a TikTok Ads Managerétől. A többi szerveroldali platformhoz lásd a Pinterest Conversions API útmutatót és a Meta Conversions API útmutatót.

Források

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

A ROASaurusban

• TikTok-integráció
• Szerveroldali követés a ROASaurusban
• Súgó: a dupla számolás megelőzése
• Súgó: a ROASaurus beállítása Shopifyon

Olvass tovább