TikTok Events API za Shopify: postavljanje i deduplikacija

TikTok Events API je TikTokova veza od poslužitelja do poslužitelja za podatke o konverzijama. Umjesto da se oslanja samo na TikTok piksel u pregledniku kupca, vaša web-trgovina ili alat poput ROASaurusa šalje događaje poput kupnji izravno TikToku. TikTok preporučuje pokretanje Events API-ja uz piksel i deduplikaciju njih dvaju zajedničkim event_id.

Ovaj vodič obuhvaća što Events API šalje iz Shopify trgovine, nazive događaja Purchase i CompletePayment, ID klika i kolačić prema kojima TikTok povezuje događaje, kako funkcionira deduplikacija, kako testirati u TikTok Events Manageru i kako sve to postaviti u ROASaurusu.

Što je TikTok Events API?

TikTok piksel je skripta na vašoj trgovini. Aktivira događaje iz preglednika kupca, pa broji samo ono što se dogodi dok se skripta učitava i izvršava. Blokator oglasa, pogreška u skripti ili kupac koji zatvori karticu prije nego što se učita potvrda narudžbe mogu ga zaustaviti.

Events API šalje istu vrstu događaja s poslužitelja. Na Shopifyju je najpouzdaniji zapis kupnje sama narudžba. Shopify svaku plaćenu narudžbu prijavljuje webhookom, bez obzira na to je li se skripta u pregledniku izvršila. To je ideja iza praćenja na strani poslužitelja na Shopifyju.

Njih dvoje nisu alternative. TikTokov je savjet da se događaji dijele kroz oba kanala, da se drže usklađenima kroz cijeli put kupovine i da TikTok ukloni duplikate.

Koje događaje ROASaurus šalje TikToku?

Četiri trenutka u Shopify trgovini važna su za TikTokovu optimizaciju: pregled proizvoda, dodavanje u košaricu, početak naplate i kupnja. ROASaurus sva četiri šalje na Events API i aktivira ista četiri kroz TikTok piksel, s istim ID-ovima događaja. Prikazi stranica idu samo kroz piksel.

U postavkama piksela možete odznačiti događaje s poslužitelja koje ne želite slati i dodati filtre, primjerice po državi ili minimalnoj vrijednosti narudžbe.

Purchase ili CompletePayment?

TikTok je preimenovao svoj događaj kupnje. Trenutni naziv je Purchase. Stari naziv, CompletePayment, i dalje radi: TikTok na svojoj strani pretvara stare nazive, prikazuje ih pod novim nazivom u izvješćivanju, publikama i optimizaciji te kaže da će CompletePayment biti podržan neograničeno. TikTok traži da nove postave piksela koriste Purchase.

ROASaurus šalje CompletePayment, i u pikselu i u Events API-ju. U TikTok Events Manageru i Ads Manageru ti se događaji prikazuju kao Purchase. Za deduplikaciju je važno da obje kopije kupnje koriste isti naziv događaja, a koriste.

Kako TikTok povezuje događaj s kupcem?

Događaj pomaže vašim kampanjama samo ako ga TikTok može povezati s osobom koja je vidjela ili kliknula oglas. TikTok te identifikatore naziva ključevima podudaranja (match keys), a njegov vodič za Events API traži da se proslijede svi relevantni ključevi podudaranja kako bi se povećale stope podudaranja. Events Manager prikazuje rezultat kao ocjenu Event Match Quality, ponderirani prosjek koliko je često prisutan svaki ključ podudaranja.

TikTok navodi da piksel prema zadanim postavkama dijeli IP adresu i user agent, ali da ih Events API traži dodane ručno. ROASaurus ih preuzima iz sesije naplate kupca ili iz narudžbe ako sesije nije bilo. Dva druga ključa na Shopifyju traže pažnju.

ttclid: TikTokov ID klika

Kada kupac klikne TikTok oglas, TikTok URL-u odredišne stranice dodaje ttclid. Ako ga vaša trgovina ne spremi na toj prvoj stranici, do trenutka kada narudžba stigne, nekoliko stranica poslije, izgubljen je. ROASaurus čita ttclid na odredišnoj stranici, pohranjuje ga uz ID posjetitelja, zapisuje ga u Shopify košaricu i dodaje ga događaju s poslužitelja kada narudžba stigne.

_ttp: kolačić piksela

Kolačić _ttp je kolačić prve strane koji TikTok piksel koristi na vašoj domeni. ROASaurus ga čita na stranici trgovine i u naplati te ga šalje kao ttp u događaju s poslužitelja. To je još jedan razlog da piksel nastavite držati uključenim uz 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"
    }
  }]
}

Kako funkcionira deduplikacija?

Kada piksel i Events API prijave istu kupnju, TikTok prima dva događaja za jednu narudžbu. Da bi zadržao samo jedan, TikTok treba da dvije vrijednosti budu identične u obje kopije: naziv događaja i event_id. TikTok tada za mjerenje i izvješćivanje bilježi prvu kopiju koju primi, pa se narudžba računa jednom. To vrijedi za podudarne kopije koje stignu unutar 48-satnog prozora od prve.

ROASaurus ID događaja za kupnju gradi iz ID-a Shopify narudžbe. Kupnja iz narudžbe 5512345678901 ima ID događaja order-5512345678901, i u pikselu naplate i na poslužitelju. Događaji na stranici trgovine, poput pregleda proizvoda i dodavanja u košaricu, dobivaju nasumičan ID kada se dogode, a kopija u pregledniku i kopija na poslužitelju dijele ga.

Evo što to znači za brojeve. Uzmimo primjer trgovine s 200 narudžbi u tjednu. Piksel se aktivira za 150 njih. Preostalih 50 kupaca koristilo je blokator oglasa, odbilo marketinške kolačiće ili otišlo prije nego što se učitala stranica potvrde. Events API šalje svih 200.

Broj 350 je onaj zbog kojeg treba brinuti. TikTokov broj kupnji, a time i ROAS koji se na njemu temelji, bio bi 75% viši od stvarnosti, jer je 350 ÷ 200 = 1.75. TikTok te događaje koristi i za optimizaciju i ciljanje, pa bi njegova licitacija učila iz 150 kupnji koje se nisu dogodile.

Zašto se kupnje na Shopifyju broje dvaput?

Dvostruko brojanje događa se kada TikTok primi dvije kopije kupnje koje ne može povezati. Provjerite ove uzroke prije nego što povjerujete skoku kupnji na TikToku:

• Dva alata šalju isti piksel. Shopifyjeva aplikacija TikTok sales channel također može slati događaje za vaš piksel. Njezini ID-ovi događaja ne odgovaraju ID-ovima koje koristi ROASaurus, pa TikTok svaku narudžbu broji dvaput. Odspojite piksel u toj aplikaciji.
• Piksel je i u kodu vaše teme. Isječak piksela zalijepljen u temu aktivira vlastite događaje bez vaših ID-ova događaja. Uklonite ga i pustite da piksel učitava jedan alat.
• Jedna strana nema event_id. Kupnja s poslužitelja bez event_id ili s novim nasumičnim ID-om ne može se povezati s kopijom iz piksela.
• Nazivi događaja se razlikuju. TikTok deduplicira samo identične događaje. Obje kopije kupnje moraju koristiti isti naziv događaja.

Članak pomoći o dvostrukom brojanju prolazi kroz iste provjere za Metu i ostale platforme.

Kako testirati Events API u TikTok Events Manageru?

TikTok Events Manager ima karticu Test events za događaje iz preglednika i s poslužitelja. Upotrijebite je prije nego što se oslonite na podatke:

1. Kopirajte kod testnog događaja

   U TikTok Events Manageru otvorite svoj piksel i idite na Test events. Kopirajte kod testnog događaja.

2. Zalijepite ga u ROASaurus

   Otvorite Tracking & platforms, uredite TikTok piksel i zalijepite kod u polje Test event code. Događaji s poslužitelja sada ga nose.

3. Napravite probnu narudžbu

   Posjetite svoju trgovinu, pregledajte proizvod, dodajte ga u košaricu i dovršite narudžbu.

4. Provjerite obje strane

   U Test events filtrirajte događaje iz preglednika i s poslužitelja. Kupnju biste trebali vidjeti s obje strane. U ROASaurusu Event log prikazuje svaku isporuku s poslužitelja kao poslanu ili neuspjelu.

5. Uklonite testni kod

   Kad završite, obrišite kod testnog događaja kako se vaši stvarni događaji s poslužitelja više ne bi slali kao testni.

TikTok može odgovoriti na zahtjev s HTTP 200 i ipak odbiti događaj, s kodom pogreške u tijelu odgovora. ROASaurus čita taj kod, pa se odbijen događaj u Event log prikazuje kao neuspio umjesto da prođe neprimijećeno.

Nakon dan stvarnog prometa otvorite pregled piksela u Events Manageru. Navodi svaki događaj s načinom povezivanja, ocjenom Event Match Quality i vremenom zadnjeg primitka. Detalji događaja uključuju podatke o povezivanju i deduplikaciji, a Diagnostics navodi probleme s kvalitetom uz upute kako ih ispraviti.

Kako postaviti TikTok Events API na Shopifyju s ROASaurusom

Trebate Shopify trgovinu s aplikacijom ROASaurus i pristup TikTok Events Manageru. Stranica TikTok integracije navodi svako polje koje ROASaurus šalje.

1. Povežite svoju Shopify trgovinu

   Idite na Add a store › Shopify, kliknite Install app i uključite ugradnju aplikacije ROASaurus u uređivaču teme. Ugradnja bilježi ttclid i kolačić _ttp na svakoj stranici. Vodič za postavljanje Shopifyja prikazuje svaki korak.

2. Dodajte piksel naplate

   U Shopify admin › Settings › Customer events dodajte prilagođeni piksel naziva ROASaurus i zalijepite isječak sa svoje stranice Tracking & platforms. On aktivira TikTok piksel u naplati, uključujući kopiju kupnje u pregledniku.

3. Izradite pristupni token

   U TikTok Events Manageru otvorite svoj piksel i u njegovim postavkama generirajte pristupni token za Events API. Kopirajte token i kod piksela.

4. Dodajte TikTok piksel u ROASaurus

   Idite na Tracking & platforms, kliknite Add pixel na kartici TikTok i ispunite Pixel code i Events API access token. Ostavite označeno Also load the browser pixel (recommended, deduplicated), kako bi događaji iz preglednika i s poslužitelja dijelili ID-ove.

5. Dodajte potrošnju (neobavezno)

   Ispunite Advertiser ID for spend i Marketing API token. ROASaurus tada uvozi potrošnju na TikToku, pa TikTok kampanje prikazuju ROAS i CPA uz vaše ostale kanale.

6. Testirajte, pa pustite u rad

   Pošaljite testnu narudžbu s kodom testnog događaja kako je opisano gore, a zatim uklonite kod.

Kada je uključeno Respect visitor consent, što je zadano, ROASaurus poštuje izbor kupca u Shopifyjevu banneru za kolačiće. Kada kupac odbije marketinške kolačiće, ROASaurus za njega ne učitava TikTok piksel, ne postavlja ID posjetitelja pa se njegovi klikovi ne povezuju s njim i ne šalje TikToku njegove događaje pregledavanja. Njegova plaćena narudžba i dalje se s poslužitelja šalje na Events API, s hashiranim podacima o narudžbi te IP adresom i user agentom narudžbe, ali bez ttclid ili _ttp. Vodič o privoli i privatnosti objašnjava što se pohranjuje i šalje.

Uz sinkroniziranu potrošnju TikTok kampanje pojavljuju se u izvješćima o atribuciji uz Metu, a analitika kreativa dodaje TikTokovu statistiku videa po oglasu. ROASaurus narudžbe pripisuje klikovima na oglase i UTM-ovima koje je zabilježio, a view-through konverzije broji samo kao modeliranu procjenu u svojem modelu Clicks & views, pa se njegovi ukupni iznosi obično razlikuju od TikTok Ads Managera. Za ostale platforme na strani poslužitelja pogledajte vodič za Pinterest Conversions API i vodič za Meta Conversions API.

Izvori

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

U ROASaurusu

• Integracija s TikTokom
• Praćenje na strani poslužitelja u ROASaurusu
• Pomoć: sprječavanje dvostrukog brojanja
• Pomoć: postavljanje ROASaurusa na Shopifyju

Nastavite čitati