TikTok Events API for Shopify: oppsett og deduplisering

TikTok Events API er TikToks server-til-server-tilkobling for konverteringsdata. I stedet for å stole bare på TikTok-pixelen i kundens nettleser sender nettbutikken din, eller et verktøy som ROASaurus, events som kjøp rett til TikTok. TikTok anbefaler å kjøre Events API ved siden av pixelen og deduplisere de to med en felles event_id.

Denne guiden dekker hva Events API sender fra en Shopify-butikk, eventnavnene Purchase og CompletePayment, click id-en og cookien TikTok matcher på, hvordan deduplisering fungerer, hvordan du tester i TikTok Events Manager, og hvordan du setter opp alt i ROASaurus.

Hva er TikTok Events API?

TikTok-pixelen er et skript i nettbutikken din. Den utløser events fra kundens nettleser, så den teller bare det som skjer mens skriptet lastes og kjører. En annonseblokkerer, en skriptfeil eller en kunde som lukker fanen før bestillingsbekreftelsen er lastet, kan alle stoppe den.

Events API sender den samme typen event fra en server. På Shopify er den mest pålitelige registreringen av et kjøp selve bestillingen. Shopify rapporterer hver betalte bestilling via webhook, uansett om nettleserskriptet kjørte eller ikke. Det er ideen bak server-side tracking på Shopify.

De to er ikke alternativer til hverandre. TikToks råd er å dele events gjennom begge, holde dem konsistente gjennom hele handlereisen og la TikTok fjerne duplikatene.

Hvilke events sender ROASaurus til TikTok?

Fire øyeblikk i en Shopify-butikk betyr noe for TikToks optimalisering: en produktvisning, et tillegg i handlekurven, starten på checkout og kjøpet. ROASaurus sender alle fire til Events API og utløser de samme fire gjennom TikTok-pixelen, med de samme event-ID-ene. Sidevisninger går bare gjennom pixelen.

I pixelinnstillingene kan du fjerne avhukingen for server-events du ikke vil sende, og legge til filtre som et land eller en minste bestillingsverdi.

Purchase eller CompletePayment?

TikTok har gitt kjøpseventen sin nytt navn. Det nåværende navnet er Purchase. Det gamle navnet, CompletePayment, fungerer fortsatt: TikTok konverterer eldre navn på sin side, viser dem under det nye navnet i rapportering, målgrupper og optimalisering, og sier at CompletePayment vil støttes på ubestemt tid. TikTok ber nye pixeloppsett om å bruke Purchase.

ROASaurus sender CompletePayment, både i pixelen og i Events API. I TikTok Events Manager og Ads Manager vises disse eventene som Purchase. For deduplisering er det avgjørende at begge kopiene av et kjøp bruker samme eventnavn, og det gjør de.

Hvordan kobler TikTok en event til en kunde?

En event hjelper bare kampanjene dine hvis TikTok kan koble den til personen som så eller klikket på annonsen. TikTok kaller disse identifikatorene match keys, og guiden for Events API ber deg sende tilbake alle relevante match keys for å øke matchratene. Events Manager viser resultatet som en Event Match Quality-score, et vektet gjennomsnitt av hvor ofte hver match key er til stede.

TikTok oppgir at pixelen deler IP-adressen og user agent som standard, men at Events API trenger at de legges til manuelt. ROASaurus henter dem fra kundens checkout-økt, eller fra bestillingen hvis det ikke fantes noen økt. To andre nøkler krever oppmerksomhet på Shopify.

ttclid: TikTok-click id-en

Når en kunde klikker på en TikTok-annonse, legger TikTok ttclid til i URL-en til landingssiden. Hvis nettbutikken din ikke lagrer den på den første siden, er den borte når bestillingen kommer, flere sider senere. ROASaurus leser ttclid på landingssiden, lagrer den sammen med besøks-ID-en, skriver den til Shopify-handlekurven og legger den til server-eventen når bestillingen kommer inn.

_ttp: pixelcookien

_ttp-cookien er en førstepartscookie som TikTok-pixelen bruker på domenet ditt. ROASaurus leser den i nettbutikken og i checkout og sender den som ttp i server-eventen. Det er enda en grunn til å la pixelen kjøre ved siden av 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"
    }
  }]
}

Hvordan fungerer deduplisering?

Når pixelen og Events API begge rapporterer det samme kjøpet, mottar TikTok to events for én bestilling. For å beholde bare én trenger TikTok at to verdier er identiske i begge kopiene: eventnavnet og event_id. TikTok registrerer da den første kopien den mottar for måling og rapportering, så bestillingen telles én gang. Dette fungerer for kopier som samsvarer og kommer innenfor et vindu på 48 timer fra den første.

ROASaurus bygger event-ID-en for et kjøp fra Shopify-bestillings-ID-en. Kjøpet fra bestilling 5512345678901 har event-ID-en order-5512345678901, både i checkout-pixelen og på serveren. Events i nettbutikken, som produktvisninger og tillegg i handlekurven, får en tilfeldig ID når de skjer, og nettleserkopien og serverkopien deler den.

Slik slår dette ut på tallene. Ta en eksempelbutikk med 200 bestillinger på en uke. Pixelen utløses for 150 av dem. De andre 50 kundene brukte en annonseblokkerer, avslo markedsføringscookies eller dro før bekreftelsessiden var lastet. Events API sender alle 200.

De 350 er tallet du bør bekymre deg for. Det ville gjort TikToks antall kjøp, og ROAS-en som bygger på det, 75% høyere enn virkeligheten, fordi 350 ÷ 200 = 1.75. TikTok bruker også disse eventene til optimalisering og målretting, så budgivningen ville lært av 150 kjøp som aldri skjedde.

Hvorfor telles kjøp to ganger på Shopify?

Dobbelttelling skjer når TikTok mottar to kopier av et kjøp som den ikke kan matche. Sjekk disse årsakene før du stoler på et hopp i TikTok-kjøp:

• To verktøy sender den samme pixelen. Salgskanal-appen for TikTok på Shopify kan også sende events for pixelen din. Event-ID-ene deres samsvarer ikke med ID-ene ROASaurus bruker, så TikTok teller hver bestilling to ganger. Koble fra pixelen i den appen.
• Pixelen ligger også i temakoden din. En pixelkodebit limt inn i temaet utløser sine egne events uten event-ID-ene dine. Fjern den og la ett verktøy laste inn pixelen.
• Den ene siden mangler event_id. Et server-kjøp uten event_id, eller med en ny tilfeldig ID, kan ikke matches med pixelkopien.
• Eventnavnene er ulike. TikTok dedupliserer bare identiske events. Begge kopiene av et kjøp må bruke samme eventnavn.

Hjelpeartikkelen om dobbelttelling går gjennom de samme kontrollene for Meta og de andre plattformene.

Hvordan tester du Events API i TikTok Events Manager?

TikTok Events Manager har en fane Test events for både nettleser- og server-events. Bruk den før du stoler på dataene:

1. Kopier en testeventkode

   Åpne pixelen din i TikTok Events Manager og gå til Test events. Kopier testeventkoden.

2. Lim den inn i ROASaurus

   Åpne Tracking & platforms, rediger TikTok-pixelen og lim inn koden i feltet Test event code. Server-eventene har den nå med.

3. Legg inn en testbestilling

   Besøk nettbutikken din, se på et produkt, legg det i handlekurven og fullfør en bestilling.

4. Sjekk begge sider

   Filtrer på nettleser- og server-events i Test events. Du skal se kjøpet fra begge. I ROASaurus viser Event log hver serverleveranse som sendt eller mislykket.

5. Fjern testkoden

   Slett testeventkoden når du er ferdig, slik at de live server-eventene dine ikke lenger sendes som testevents.

TikTok kan svare på en forespørsel med HTTP 200 og likevel avvise eventen, med en feilkode i svarteksten. ROASaurus leser den koden, så en avvist event vises som mislykket i Event log i stedet for å passere stille.

Etter en dag med live trafikk åpner du oversikten for pixelen i Events Manager. Den lister hver event med tilkoblingsmetode, Event Match Quality-score og når den sist ble mottatt. Eventdetaljene inneholder informasjon om matching og deduplisering, og Diagnostics lister opp kvalitetsproblemer med veiledning om hvordan du løser dem.

Slik setter du opp TikTok Events API på Shopify med ROASaurus

Du trenger en Shopify-butikk med ROASaurus-appen og tilgang til TikTok Events Manager. Siden om TikTok-integrasjonen viser alle feltene ROASaurus sender.

1. Koble til Shopify-butikken din

   Gå til Add a store › Shopify, klikk på Install app og slå på ROASaurus app embed i temaredigereren. App embed fanger ttclid og _ttp-cookien på hver side. Oppsettguiden for Shopify viser hvert trinn.

2. Legg til checkout-pixelen

   I Shopify admin › Settings › Customer events legger du til en egendefinert pixel som heter ROASaurus og limer inn kodebiten fra siden Tracking & platforms. Den utløser TikTok-pixelen i checkout, inkludert nettleserkopien av kjøpet.

3. Opprett et access token

   Åpne pixelen din i TikTok Events Manager og generer et access token for Events API i innstillingene. Kopier tokenet og pixelkoden.

4. Legg til TikTok-pixelen i ROASaurus

   Gå til Tracking & platforms, klikk på Add pixel på TikTok-kortet og fyll inn Pixel code og Events API access token. La Also load the browser pixel (recommended, deduplicated) stå avhuket, slik at nettleser- og server-eventene deler ID-er.

5. Legg til annonsekostnader (valgfritt)

   Fyll inn Advertiser ID for spend og et Marketing API token. ROASaurus importerer da TikTok-annonsekostnadene, så TikTok-kampanjene viser ROAS og CPA ved siden av de andre kanalene dine.

6. Test, og gå live

   Send en testbestilling med en testeventkode som beskrevet ovenfor, og fjern deretter koden.

Med Respect visitor consent på, som er standard, følger ROASaurus kundens valg i Shopifys cookiebanner. Når en kunde avslår markedsføringscookies, laster ROASaurus ikke inn TikTok-pixelen for den kunden, setter ingen besøks-ID, så klikkene ikke kobles til kunden, og sender ikke eventene for nettleseraktiviteten til TikTok. Den betalte bestillingen sendes fortsatt til Events API fra serveren, med hashede bestillingsdata og bestillingens IP-adresse og user agent, men uten ttclid eller _ttp. Guiden til samtykke og personvern forklarer hva som lagres og sendes.

Når annonsekostnadene er synkronisert, vises TikTok-kampanjer i attribusjonsrapportene ved siden av Meta, og analysen av kreativer legger til TikToks videostatistikk per annonse. ROASaurus krediterer bestillinger til annonseklikkene og UTM-ene den har registrert, og teller view-through-konverteringer bare som et modellert estimat i Clicks & views-modellen, så totalene avviker vanligvis fra TikTok Ads Manager. For de andre server-side-plattformene, se guiden til Pinterest Conversions API og guiden til Meta Conversions API.

Kilder

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

I ROASaurus

• TikTok-integrasjon
• Server-side tracking i ROASaurus
• Hjelp: forhindre dobbelttelling
• Hjelp: sette opp ROASaurus på Shopify

Les videre