TikTok Events API Shopifylle: käyttöönotto ja deduplikointi

TikTok Events API on TikTokin palvelin–palvelin-yhteys konversiodatalle. Sen sijaan, että luottaisi pelkästään ostajan selaimessa olevaan TikTok-pikseliin, kauppasi tai työkalu, kuten ROASaurus, lähettää tapahtumia, kuten ostoja, suoraan TikTokille. TikTok suosittelee ajamaan Events API:a pikselin rinnalla ja deduplikoimaan nämä kaksi yhteisellä event_id:llä.

Tämä opas käsittelee, mitä Events API lähettää Shopify-kaupasta, Purchase- ja CompletePayment-tapahtumien nimiä, klikkaus-ID:tä ja evästettä, joilla TikTok yhdistää tapahtumat, miten deduplikointi toimii, miten testataan TikTok Events Managerissa ja miten kaikki otetaan käyttöön ROASaurusissa.

Mikä on TikTok Events API?

TikTok-pikseli on skripti kaupassasi. Se laukaisee tapahtumat ostajan selaimesta, joten se laskee vain sen, mitä tapahtuu, kun skripti latautuu ja toimii. Mainostenesto, skriptivirhe tai ostaja, joka sulkee välilehden ennen tilausvahvistuksen latautumista, voivat kaikki pysäyttää sen.

Events API lähettää saman tyyppisen tapahtuman palvelimelta. Shopifyssa luotettavin tieto ostosta on itse tilaus. Shopify ilmoittaa jokaisesta maksetusta tilauksesta webhookilla riippumatta siitä, ajettiinko selaimen skripti. Siihen perustuu palvelinpuolen seuranta Shopifyssa.

Nämä kaksi eivät ole vaihtoehtoja toisilleen. TikTokin neuvo on jakaa tapahtumat molempien kautta, pitää ne yhdenmukaisina koko ostopolun ajan ja antaa TikTokin poistaa päällekkäiset.

Mitä tapahtumia ROASaurus lähettää TikTokille?

Neljä hetkeä Shopify-kaupassa on tärkeää TikTokin optimoinnille: tuotteen katselu, ostoskoriin lisäys, kassan aloitus ja osto. ROASaurus lähettää kaikki neljä Events API:lle ja laukaisee samat neljä TikTok-pikselin kautta samoilla tapahtuma-ID:illä. Sivunäytöt kulkevat vain pikselin kautta.

Pikselin asetuksissa voit poistaa valinnan palvelintapahtumista, joita et halua lähettää, ja lisätä suodattimia, kuten maan tai tilauksen vähimmäisarvon.

Purchase vai CompletePayment?

TikTok nimesi ostotapahtumansa uudelleen. Nykyinen nimi on Purchase. Vanha nimi, CompletePayment, toimii edelleen: TikTok muuntaa vanhat nimet omalla puolellaan, näyttää ne uudella nimellä raportoinnissa, yleisöissä ja optimoinnissa ja sanoo CompletePaymentin olevan tuettu toistaiseksi. TikTok pyytää uusia pikselimäärityksiä käyttämään nimeä Purchase.

ROASaurus lähettää CompletePaymentin, sekä pikselissä että Events API:ssa. TikTok Events Managerissa ja Ads Managerissa nämä tapahtumat näkyvät nimellä Purchase. Deduplikoinnin kannalta on tärkeää, että oston molemmat kopiot käyttävät samaa tapahtuman nimeä, ja niin ne tekevätkin.

Miten TikTok yhdistää tapahtuman ostajaan?

Tapahtumasta on hyötyä kampanjoillesi vain, jos TikTok voi yhdistää sen henkilöön, joka näki tai klikkasi mainosta. TikTok kutsuu näitä tunnisteita match keyiksi, ja sen Events API -opas pyytää välittämään takaisin kaikki olennaiset avaimet yhdistämisasteen nostamiseksi. Events Manager näyttää tuloksen Event Match Quality -pistemääränä, painotettuna keskiarvona siitä, kuinka usein kukin avain on mukana.

TikTok huomauttaa, että pikseli jakaa IP-osoitteen ja user agentin oletuksena, mutta Events API vaatii niiden lisäämistä käsin. ROASaurus ottaa ne ostajan kassaistunnosta tai, jos istuntoa ei ollut, tilauksesta. Kaksi muuta avainta vaatii huomiota Shopifyssa.

ttclid: TikTokin klikkaus-ID

Kun ostaja klikkaa TikTok-mainosta, TikTok lisää ttclid:n laskeutumissivun URL-osoitteeseen. Jos kauppasi ei tallenna sitä ensimmäisellä sivulla, se on kadonnut siihen mennessä, kun tilaus saapuu useita sivuja myöhemmin. ROASaurus lukee ttclid:n laskeutumissivulla, tallentaa sen kävijätunnuksen kanssa, kirjoittaa sen Shopifyn ostoskoriin ja lisää sen palvelintapahtumaan, kun tilaus saapuu.

_ttp: pikselin eväste

_ttp-eväste on first-party-eväste, jota TikTok-pikseli käyttää verkkotunnuksellasi. ROASaurus lukee sen verkkokaupassa ja kassalla ja lähettää sen palvelintapahtumassa nimellä ttp. Se on yksi syy lisää pitää pikseli käynnissä Events API:n rinnalla.

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

Miten deduplikointi toimii?

Kun pikseli ja Events API raportoivat saman oston, TikTok saa kaksi tapahtumaa yhdestä tilauksesta. Jotta vain yksi säilyy, TikTok tarvitsee kaksi arvoa identtisiksi molemmissa kopioissa: tapahtuman nimen ja event_id:n. TikTok kirjaa silloin ensimmäisen vastaanottamansa kopion mittausta ja raportointia varten, joten tilaus lasketaan kerran. Tämä toimii vastaaville kopioille, jotka saapuvat 48 tunnin ikkunan sisällä ensimmäisestä.

ROASaurus rakentaa oston tapahtuma-ID:n Shopifyn tilaus-ID:stä. Tilauksen 5512345678901 ostolla on tapahtuma-ID order-5512345678901 sekä kassapikselissä että palvelimella. Verkkokaupan tapahtumille, kuten tuotteiden katselulle ja ostoskoriin lisäyksille, annetaan satunnainen ID niiden tapahtuessa, ja selaimen kopio ja palvelimen kopio jakavat sen.

Näin tämä vaikuttaa luvuihin. Otetaan esimerkkikauppa, jolla on 200 tilausta viikossa. Pikseli laukeaa 150:lle niistä. Muut 50 ostajaa käyttivät mainostenestoa, kieltäytyivät markkinointievästeistä tai poistuivat ennen vahvistussivun latautumista. Events API lähettää kaikki 200.

Luku 350 on se, josta kannattaa huolestua. Se tekisi TikTokin ostomäärästä ja siihen perustuvasta ROAS:ista 75% korkeamman kuin todellisuus, koska 350 ÷ 200 = 1.75. TikTok käyttää näitä tapahtumia myös optimointiin ja kohdentamiseen, joten sen tarjousten optimointi oppisi 150 ostosta, joita ei tapahtunut.

Miksi ostot lasketaan kahdesti Shopifyssa?

Kaksoislaskentaa tapahtuu, kun TikTok saa kaksi kopiota ostosta, joita se ei voi yhdistää. Tarkista nämä syyt, ennen kuin luotat TikTokin ostojen hyppäykseen:

• Kaksi työkalua lähettää saman pikselin. Shopifyn TikTok-myyntikanavasovellus voi myös lähettää tapahtumia pikselillesi. Sen tapahtuma-ID:t eivät vastaa ROASaurusin käyttämiä ID:itä, joten TikTok laskee jokaisen tilauksen kahdesti. Irrota pikseli siinä sovelluksessa.
• Pikseli on myös teemasi koodissa. Teemaan liitetty pikselikoodinpätkä laukaisee omat tapahtumansa ilman tapahtuma-ID:itäsi. Poista se ja anna yhden työkalun ladata pikseli.
• Toiselta puolelta puuttuu event_id. Palvelimen osto ilman event_id:tä tai uudella satunnaisella ID:llä ei voi yhdistää pikselin kopioon.
• Tapahtumien nimet eroavat. TikTok deduplikoi vain identtiset tapahtumat. Oston molempien kopioiden täytyy käyttää samaa tapahtuman nimeä.

Kaksoislaskentaa käsittelevä ohjeartikkeli käy läpi samat tarkistukset Metalle ja muille alustoille.

Miten Events API testataan TikTok Events Managerissa?

TikTok Events Managerissa on Test events -välilehti sekä selaimen että palvelimen tapahtumille. Käytä sitä, ennen kuin luotat dataan:

1. Kopioi testitapahtumakoodi

   Avaa TikTok Events Managerissa pikselisi ja siirry kohtaan Test events. Kopioi testitapahtumakoodi.

2. Liitä se ROASaurusiin

   Avaa Tracking & platforms, muokkaa TikTok-pikseliä ja liitä koodi kenttään Test event code. Palvelintapahtumat sisältävät sen nyt.

3. Tee testitilaus

   Käy kaupassasi, katso tuotetta, lisää se ostoskoriin ja tee tilaus loppuun.

4. Tarkista molemmat puolet

   Suodata Test events -näkymässä selaimen ja palvelimen tapahtumat. Sinun pitäisi nähdä osto molemmista. ROASaurusin Event log näyttää jokaisen palvelintoimituksen lähetettynä tai epäonnistuneena.

5. Poista testikoodi

   Poista testitapahtumakoodi, kun olet valmis, jotta live-palvelintapahtumia ei enää lähetetä testitapahtumina.

TikTok voi vastata pyyntöön HTTP 200:lla ja silti hylätä tapahtuman, jolloin vastauksen rungossa on virhekoodi. ROASaurus lukee tuon koodin, joten hylätty tapahtuma näkyy kohdassa Event log epäonnistuneena sen sijaan, että se ohittaisi huomaamatta.

Päivän live-liikenteen jälkeen avaa pikselin yleiskatsaus Events Managerissa. Se listaa jokaisen tapahtuman yhteystapoineen, Event Match Quality -pistemäärineen ja viimeisen vastaanottohetken kanssa. Tapahtuman tiedot sisältävät vastaavuus- ja deduplikointitietoja, ja Diagnostics listaa laatuongelmat korjausohjeineen.

Miten TikTok Events API otetaan käyttöön Shopifyssa ROASaurusin avulla

Tarvitset Shopify-kaupan, jossa on ROASaurus-sovellus, sekä pääsyn TikTok Events Manageriin. TikTok-integraatiosivu listaa kaikki kentät, jotka ROASaurus lähettää.

1. Yhdistä Shopify-kauppasi

   Siirry kohtaan Add a store › Shopify, klikkaa Install app ja kytke ROASaurus app embed päälle teemaeditorissa. Upote tallentaa ttclid:n ja _ttp-evästeen jokaisella sivulla. Shopify-käyttöönotto-opas näyttää jokaisen vaiheen.

2. Lisää kassapikseli

   Siirry Shopify adminissa kohtaan Settings › Customer events, lisää mukautettu pikseli nimeltä ROASaurus ja liitä sivultasi Tracking & platforms löytyvä koodinpätkä. Se laukaisee TikTok-pikselin kassalla, mukaan lukien oston selainkopion.

3. Luo käyttöoikeustunnus

   Luo TikTok Events Managerissa pikselisi asetuksista Events API -käyttöoikeustunnus. Kopioi tunnus ja pikselikoodi.

4. Lisää TikTok-pikseli ROASaurusiin

   Siirry kohtaan Tracking & platforms, klikkaa TikTok-kortilla Add pixel ja täytä Pixel code ja Events API access token. Pidä Also load the browser pixel (recommended, deduplicated) valittuna, jotta selaimen ja palvelimen tapahtumat jakavat tunnukset.

5. Lisää mainoskulut (valinnainen)

   Täytä Advertiser ID for spend ja Marketing API token. ROASaurus tuo silloin TikTokin mainoskulut, joten TikTok-kampanjoille näytetään ROAS ja CPA muiden kanavien rinnalla.

6. Testaa ja ota sitten käyttöön

   Lähetä testitilaus testitapahtumakoodilla yllä kuvatulla tavalla ja poista sitten koodi.

Kun Respect visitor consent on päällä, mikä on oletus, ROASaurus noudattaa ostajan valintaa Shopifyn evästebannerissa. Kun ostaja kieltäytyy markkinointievästeistä, ROASaurus ei lataa hänelle TikTok-pikseliä, ei aseta kävijätunnusta, joten hänen klikkauksiaan ei yhdistetä häneen, eikä lähetä hänen selaustapahtumiaan TikTokille. Hänen maksettu tilauksensa lähetetään silti Events API:lle palvelimelta hashatun tilausdatan sekä tilauksen IP-osoitteen ja user agentin kanssa, mutta ilman ttclid:tä tai _ttp:tä. Suostumus- ja tietosuojaopas selittää, mitä tallennetaan ja lähetetään.

Kun mainoskulut on synkronoitu, TikTok-kampanjat näkyvät attribuutioraporteissa Metan rinnalla, ja mainosmateriaalianalytiikka lisää TikTokin videotilastot mainosta kohden. ROASaurus lukee tilaukset ansioksi kirjaamilleen mainosklikkauksille ja UTM-parametreille ja laskee view-through-konversiot vain mallinnettuna arviona Clicks & views -mallissaan, joten sen summat eroavat yleensä TikTok Ads Managerista. Muista palvelinpuolen alustoista katso Pinterest Conversions API -opas ja Meta Conversions API -opas.

Lähteet

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

ROASaurusissa

• TikTok-integraatio
• Palvelinpuolen seuranta ROASaurus-palvelussa
• Ohje: estä kaksoislaskenta
• Ohje: ROASaurus-palvelun käyttöönotto Shopifyssa

Lue lisää