TikTok Events API til Shopify: opsætning og deduplikering

TikTok Events API er TikToks server-til-server-forbindelse til konverteringsdata. I stedet for kun at stole på TikTok-pixelen i shopperens browser sender din shop, eller et værktøj som ROASaurus, events som køb direkte til TikTok. TikTok anbefaler at køre Events API ved siden af pixelen og deduplikere de to med et fælles event_id.

Denne guide dækker, hvad Events API sender fra en Shopify-shop, eventnavnene Purchase og CompletePayment, klik-id'et og cookien, TikTok matcher på, hvordan deduplikering fungerer, hvordan du tester i TikTok Events Manager, og hvordan du sætter det hele op i ROASaurus.

Hvad er TikTok Events API?

TikTok-pixelen er et script i din shop. Den udløser events fra shopperens browser, så den kun tæller det, der sker, mens scriptet indlæses og kører. En adblocker, en scriptfejl eller en shopper, der lukker fanen, før ordrebekræftelsen er indlæst, kan alle stoppe den.

Events API sender den samme slags event fra en server. På Shopify er den mest pålidelige registrering af et køb selve ordren. Shopify melder hver betalt ordre via webhook, uanset om browserscriptet kørte. Det er tanken bag server-side tracking på Shopify.

De to er ikke alternativer. TikToks råd er at dele events gennem begge, holde dem konsistente gennem hele shoppingforløbet og lade TikTok fjerne de dobbelte events.

Hvilke events sender ROASaurus til TikTok?

Fire øjeblikke i en Shopify-shop har betydning for TikToks optimering: en produktvisning, en tilføjelse til kurven, starten på checkout og købet. ROASaurus sender alle fire til Events API og udløser de samme fire gennem TikTok-pixelen med de samme event-id'er. Sidevisninger går kun gennem pixelen.

I pixelindstillingerne kan du fjerne fluebenet ved server-events, du ikke vil sende, og tilføje filtre som et land eller en minimumsordreværdi.

Purchase eller CompletePayment?

TikTok har omdøbt sit købsevent. Det nuværende navn er Purchase. Det gamle navn, CompletePayment, virker stadig: TikTok konverterer ældre navne hos sig selv, viser dem under det nye navn i rapportering, målgrupper og optimering og siger, at CompletePayment vil blive understøttet på ubestemt tid. TikTok beder nye pixelopsætninger om at bruge Purchase.

ROASaurus sender CompletePayment, både i pixelen og i Events API. I TikTok Events Manager og Ads Manager vises de events som Purchase. Til deduplikering er det afgørende, at begge kopier af et køb bruger det samme eventnavn, og det gør de.

Hvordan matcher TikTok et event med en shopper?

Et event hjælper kun dine kampagner, hvis TikTok kan knytte det til den person, der så eller klikkede på annoncen. TikTok kalder disse identifikatorer match keys, og dens Events API-guide beder dig sende alle relevante match keys med for at øge matchraten. Events Manager viser resultatet som en Event Match Quality-score, et vægtet gennemsnit af, hvor ofte hver match key er til stede.

TikTok bemærker, at pixelen deler IP-adressen og user agent som standard, men at Events API skal have dem tilføjet manuelt. ROASaurus henter dem fra shopperens checkout-session eller fra ordren, hvis der ikke var nogen session. To andre nøgler kræver opmærksomhed på Shopify.

ttclid: TikToks klik-id

Når en shopper klikker på en TikTok-annonce, tilføjer TikTok ttclid til landingssidens URL. Hvis din shop ikke gemmer det på den første side, er det væk, når ordren kommer flere sider senere. ROASaurus læser ttclid på landingssiden, gemmer det sammen med besøgs-id'et, skriver det til Shopify-kurven og tilføjer det til server-eventet, når ordren kommer ind.

_ttp: pixelcookien

Cookien _ttp er en first-party-cookie, som TikTok-pixelen bruger på dit domæne. ROASaurus læser den i storefronten og i checkout og sender den som ttp i server-eventet. Det er endnu en grund til at lade pixelen køre ved siden af 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 deduplikering?

Når pixelen og Events API begge rapporterer det samme køb, modtager TikTok to events for én ordre. For kun at beholde ét skal TikTok have to værdier, der er identiske i begge kopier: eventnavnet og event_id. TikTok registrerer så den første kopi, det modtager, til måling og rapportering, så ordren tælles én gang. Det virker for matchende kopier, der ankommer inden for et vindue på 48 timer fra den første.

ROASaurus bygger event-id'et for et køb ud fra Shopify-ordre-id'et. Købet fra ordre 5512345678901 har event-id'et order-5512345678901 i checkout-pixelen og på serveren. Storefront-events som produktvisninger og tilføjelser til kurven får et tilfældigt id, når de sker, og browserkopien og serverkopien deler det.

Her er, hvad det betyder for tallene. Tag en eksempel-shop med 200 ordrer på en uge. Pixelen udløses for 150 af dem. De øvrige 50 shoppere brugte en adblocker, afviste marketingcookies eller forlod siden, før bekræftelsessiden blev indlæst. Events API sender alle 200.

De 350 er det tal, du skal være bekymret for. Det ville gøre TikToks købsantal, og den ROAS der bygger på det, 75% højere end virkeligheden, fordi 350 ÷ 200 = 1.75. TikTok bruger også disse events til optimering og targeting, så dens budgivning ville lære af 150 køb, der aldrig skete.

Hvorfor tælles køb to gange på Shopify?

Dobbelttælling opstår, når TikTok modtager to kopier af et køb, som det ikke kan matche. Tjek disse årsager, før du stoler på et hop i TikTok-køb:

• To værktøjer sender den samme pixel. TikTok-salgskanalappen på Shopify kan også sende events for din pixel. Dens event-id'er stemmer ikke med de id'er, ROASaurus bruger, så TikTok tæller hver ordre to gange. Afbryd pixelen i den app.
• Pixelen står også i din themekode. Et pixel-snippet, der er indsat i dit theme, udløser sine egne events uden dine event-id'er. Fjern det, og lad ét værktøj indlæse pixelen.
• Den ene side har intet event_id. Et serverkøb uden event_id eller med et nyt tilfældigt id kan ikke matches med pixelkopien.
• Eventnavnene er forskellige. TikTok deduplikerer kun identiske events. Begge kopier af et køb skal bruge det samme eventnavn.

Hjælpeartiklen om dobbelttælling gennemgår de samme tjek for Meta og de andre platforme.

Hvordan tester du Events API i TikTok Events Manager?

TikTok Events Manager har en fane Test events til både browser- og server-events. Brug den, før du stoler på dataene:

1. Kopiér en testeventkode

   Åbn din pixel i TikTok Events Manager, og gå til Test events. Kopiér testeventkoden.

2. Indsæt den i ROASaurus

   Åbn Tracking & platforms, rediger TikTok-pixelen, og indsæt koden i feltet Test event code. Server-events bærer den nu.

3. Læg en testordre

   Besøg din shop, se et produkt, læg det i kurven, og gennemfør en ordre.

4. Tjek begge sider

   Filtrér i Test events på browser- og server-events. Du skulle gerne se købet fra begge. I ROASaurus viser Event log hver serverlevering som sent eller failed.

5. Fjern testkoden

   Slet testeventkoden, når du er færdig, så dine live server-events ikke længere sendes som testevents.

TikTok kan svare på en anmodning med HTTP 200 og alligevel afvise eventet med en fejlkode i svaret. ROASaurus læser den kode, så et afvist event vises som mislykket i Event log i stedet for at slippe igennem uset.

Efter en dags live trafik skal du åbne pixelens oversigt i Events Manager. Den lister hvert event med dets forbindelsesmetode, Event Match Quality-score og tidspunktet for, hvornår det sidst blev modtaget. Eventdetaljerne indeholder oplysninger om matching og deduplikering, og Diagnostics lister kvalitetsproblemer med vejledning i, hvordan du løser dem.

Sådan sætter du TikTok Events API op på Shopify med ROASaurus

Du skal bruge en Shopify-shop med ROASaurus-appen og adgang til TikTok Events Manager. TikTok-integrationssiden viser alle felter, ROASaurus sender.

1. Forbind din Shopify-shop

   Gå til Add a store › Shopify, klik på Install app, og slå ROASaurus-app-embedden til i theme-editoren. Embedden fanger ttclid og _ttp-cookien på hver side. Shopify-opsætningsguiden viser hvert trin.

2. Tilføj checkout-pixelen

   Gå til Shopify admin › Settings › Customer events, tilføj en custom pixel med navnet ROASaurus, og indsæt snippeten fra din side Tracking & platforms. Den udløser TikTok-pixelen i checkout, inklusive browserkopien af købet.

3. Opret et access token

   Åbn din pixel i TikTok Events Manager, og generér et Events API access token i dens indstillinger. Kopiér tokenet og pixelkoden.

4. Tilføj TikTok-pixelen i ROASaurus

   Gå til Tracking & platforms, klik på Add pixel på TikTok-kortet, og udfyld Pixel code og Events API access token. Lad Also load the browser pixel (recommended, deduplicated) være afkrydset, så browser- og server-events deler id'er.

5. Tilføj forbrug (valgfrit)

   Udfyld Advertiser ID for spend og et Marketing API token. ROASaurus importerer så TikTok-forbrug, så TikTok-kampagner viser ROAS og CPA ved siden af dine andre kanaler.

6. Test, og gå derefter live

   Send en testordre med en testeventkode som beskrevet ovenfor, og fjern derefter koden.

Når Respect visitor consent er slået til, hvilket er standard, følger ROASaurus shopperens valg i Shopifys cookiebanner. Når en shopper afviser marketingcookies, indlæser ROASaurus ikke TikTok-pixelen for shopperen og sætter intet besøgs-id, så shopperens klik ikke bliver knyttet til vedkommende. Shopperens browsing-events sendes ikke til TikTok. Den betalte ordre sendes stadig til Events API fra serveren, med hashede ordredata og ordrens IP-adresse og user agent, men uden ttclid eller _ttp. Guiden til samtykke og privatliv forklarer, hvad der gemmes og sendes.

Når forbruget er synkroniseret, vises TikTok-kampagner i attributionsrapporterne ved siden af Meta, og creative-analysen tilføjer TikToks videostatistik pr. annonce. ROASaurus tilskriver ordrer til de annonceklik og UTM'er, den har registreret, og tæller kun view-through-konverteringer som et modelleret estimat i sin Clicks & views-model, så dens totaler afviger som regel fra TikTok Ads Manager. For de andre server-side-platforme, 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-integration
• Server-side tracking i ROASaurus
• Hjælp: forebyg dobbelttælling
• Hjælp: sæt ROASaurus op på Shopify

Læs videre