TikTok Events API pentru Shopify: configurare și deduplicare

TikTok Events API este conexiunea server-to-server a TikTok pentru datele de conversie. În loc să se bazeze doar pe pixelul TikTok din browserul cumpărătorului, magazinul tău sau un instrument precum ROASaurus trimite evenimente, cum ar fi achizițiile, direct către TikTok. TikTok recomandă rularea Events API alături de pixel și deduplicarea celor două cu un event_id comun.

Acest ghid acoperă ce trimite Events API dintr-un magazin Shopify, numele evenimentelor Purchase și CompletePayment, click id-ul și cookie-ul după care potrivește TikTok, cum funcționează deduplicarea, cum testezi în TikTok Events Manager și cum configurezi totul în ROASaurus.

Ce este TikTok Events API?

Pixelul TikTok este un script din magazinul tău. Declanșează evenimente din browserul cumpărătorului, deci numără doar ce se întâmplă cât timp scriptul se încarcă și rulează. Îl pot opri un ad blocker, o eroare de script sau un cumpărător care închide fila înainte să se încarce confirmarea comenzii.

Events API trimite același fel de eveniment de pe un server. Pe Shopify, cea mai sigură înregistrare a unei achiziții este chiar comanda. Shopify raportează fiecare comandă plătită prin webhook, indiferent dacă scriptul din browser a rulat sau nu. Aceasta este ideea din spatele tracking-ului server-side pe Shopify.

Cele două nu sunt alternative. Sfatul TikTok este să partajezi evenimente prin ambele, să le menții consecvente pe parcursul traseului de cumpărare și să lași TikTok să elimine duplicatele.

Ce evenimente trimite ROASaurus către TikTok?

Patru momente dintr-un magazin Shopify contează pentru optimizarea TikTok: o vizualizare de produs, o adăugare în coș, începutul checkout-ului și achiziția. ROASaurus le trimite pe toate patru către Events API și declanșează aceleași patru prin pixelul TikTok, cu aceleași event id-uri. Vizualizările de pagină merg doar prin pixel.

În setările pixelului poți debifa evenimentele de pe server pe care nu vrei să le trimiți și poți adăuga filtre, precum o țară sau o valoare minimă a comenzii.

Purchase sau CompletePayment?

TikTok și-a redenumit evenimentul de achiziție. Numele actual este Purchase. Numele vechi, CompletePayment, încă funcționează: TikTok convertește numele vechi la el, le arată sub noul nume în raportare, audiențe și optimizare și spune că CompletePayment va fi acceptat pe termen nelimitat. TikTok cere ca noile configurări de pixel să folosească Purchase.

ROASaurus trimite CompletePayment, în pixel și în Events API. În TikTok Events Manager și Ads Manager, aceste evenimente apar ca Purchase. Pentru deduplicare contează ca ambele copii ale unei achiziții să folosească același nume de eveniment, și așa este.

Cum potrivește TikTok un eveniment cu un cumpărător?

Un eveniment ajută campaniile tale doar dacă TikTok îl poate lega de persoana care a văzut sau a apăsat reclama. TikTok numește acești identificatori match keys, iar ghidul lui Events API îți cere să transmiți înapoi toate match keys relevante pentru a crește ratele de potrivire. Events Manager arată rezultatul ca scor Event Match Quality, o medie ponderată a cât de des este prezent fiecare match key.

TikTok notează că pixelul partajează implicit adresa IP și user agent-ul, dar Events API are nevoie să fie adăugate manual. ROASaurus le preia din sesiunea de checkout a cumpărătorului sau din comandă, dacă nu a existat o sesiune. Alte două chei cer atenție pe Shopify.

ttclid: click id-ul TikTok

Când un cumpărător dă click pe o reclamă TikTok, TikTok adaugă ttclid la URL-ul paginii de destinație. Dacă magazinul tău nu îl salvează pe acea primă pagină, a dispărut până sosește comanda, câteva pagini mai târziu. ROASaurus citește ttclid pe pagina de destinație, îl stochează cu id-ul vizitatorului, îl scrie în coșul Shopify și îl adaugă la evenimentul de pe server când sosește comanda.

_ttp: cookie-ul pixelului

Cookie-ul _ttp este un cookie first-party pe care pixelul TikTok îl folosește pe domeniul tău. ROASaurus îl citește în vitrină și în checkout și îl trimite ca ttp în evenimentul de pe server. Este încă un motiv să ții pixelul activ alături de 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"
    }
  }]
}

Cum funcționează deduplicarea?

Când pixelul și Events API raportează amândouă aceeași achiziție, TikTok primește două evenimente pentru o singură comandă. Ca să păstreze doar unul, TikTok are nevoie ca două valori să fie identice în ambele copii: numele evenimentului și event_id. TikTok înregistrează apoi prima copie pe care o primește pentru măsurare și raportare, astfel încât comanda se numără o singură dată. Acest lucru funcționează pentru copiile potrivite care sosesc într-o fereastră de 48 de ore de la prima.

ROASaurus construiește event id-ul unei achiziții din id-ul comenzii Shopify. Achiziția din comanda 5512345678901 are event id-ul order-5512345678901, în pixelul de checkout și pe server. Evenimentele din vitrină, precum vizualizările de produs și adăugările în coș, primesc un id aleatoriu când au loc, iar copia din browser și copia de pe server îl împart.

Iată ce înseamnă asta pentru cifre. Ia un magazin exemplu cu 200 de comenzi într-o săptămână. Pixelul se declanșează pentru 150 dintre ele. Ceilalți 50 de cumpărători au folosit un ad blocker, au refuzat cookie-urile de marketing sau au plecat înainte să se încarce pagina de confirmare. Events API le trimite pe toate 200.

350 este cifra care trebuie să te îngrijoreze. Ar face numărul de achiziții din TikTok, și ROAS-ul bazat pe el, cu 75% mai mare decât în realitate, pentru că 350 ÷ 200 = 1.75. TikTok folosește aceste evenimente și pentru optimizare și targetare, deci licitarea lui ar învăța din 150 de achiziții care nu au avut loc.

De ce sunt numărate achizițiile de două ori pe Shopify?

Numărarea dublă apare când TikTok primește două copii ale unei achiziții pe care nu le poate potrivi. Verifică aceste cauze înainte să te încrezi într-un salt al achizițiilor din TikTok:

• Două instrumente trimit același pixel. Aplicația TikTok sales channel din Shopify poate trimite și ea evenimente pentru pixelul tău. Event id-urile ei nu se potrivesc cu id-urile folosite de ROASaurus, așa că TikTok numără fiecare comandă de două ori. Deconectează pixelul din acea aplicație.
• Pixelul este și în codul temei tale. Un fragment de pixel lipit în temă declanșează propriile evenimente fără event id-urile tale. Elimină-l și lasă un singur instrument să încarce pixelul.
• O parte nu are event_id. O achiziție de pe server fără event_id sau cu un id nou aleatoriu nu poate fi potrivită cu copia din pixel.
• Numele evenimentelor diferă. TikTok deduplică doar evenimentele identice. Ambele copii ale unei achiziții trebuie să folosească același nume de eveniment.

Articolul de ajutor despre numărarea dublă parcurge aceleași verificări pentru Meta și pentru celelalte platforme.

Cum testezi Events API în TikTok Events Manager?

TikTok Events Manager are o filă Test events pentru evenimentele din browser și de pe server. Folosește-o înainte să te bazezi pe date:

1. Copiază un cod de eveniment de test

   În TikTok Events Manager, deschide pixelul tău și mergi la Test events. Copiază codul evenimentului de test.

2. Lipește-l în ROASaurus

   Deschide Tracking & platforms, editează pixelul TikTok și lipește codul în câmpul Test event code. Evenimentele de pe server îl poartă acum.

3. Plasează o comandă de test

   Vizitează-ți magazinul, vezi un produs, adaugă-l în coș și finalizează o comandă.

4. Verifică ambele părți

   În Test events, filtrează după evenimentele din browser și după cele de pe server. Ar trebui să vezi achiziția din ambele. În ROASaurus, Event log arată fiecare livrare de pe server ca trimisă sau eșuată.

5. Elimină codul de test

   Șterge codul evenimentului de test când ai terminat, ca evenimentele tale live de pe server să nu mai fie trimise ca evenimente de test.

TikTok poate răspunde la o cerere cu HTTP 200 și totuși să respingă evenimentul, cu un cod de eroare în corpul răspunsului. ROASaurus citește acel cod, deci un eveniment respins apare ca eșuat în Event log, în loc să treacă neobservat.

După o zi de trafic live, deschide prezentarea generală a pixelului în Events Manager. Aceasta listează fiecare eveniment cu metoda lui de conectare, scorul Event Match Quality și momentul în care a fost primit ultima dată. Detaliile evenimentului includ informații despre potrivire și deduplicare, iar Diagnostics listează problemele de calitate, cu indicații despre cum să le remediezi.

Cum configurezi TikTok Events API pe Shopify cu ROASaurus

Ai nevoie de un magazin Shopify cu aplicația ROASaurus și de acces la TikTok Events Manager. Pagina integrării TikTok listează fiecare câmp pe care îl trimite ROASaurus.

1. Conectează-ți magazinul Shopify

   Mergi la Add a store › Shopify, fă click pe Install app și activează încorporarea aplicației ROASaurus în editorul de teme. Încorporarea captează ttclid și cookie-ul _ttp pe fiecare pagină. Ghidul de configurare Shopify arată fiecare pas.

2. Adaugă pixelul de checkout

   În Shopify admin › Settings › Customer events, adaugă un pixel personalizat numit ROASaurus și lipește fragmentul de pe pagina ta Tracking & platforms. Acesta declanșează pixelul TikTok în checkout, inclusiv copia din browser a achiziției.

3. Creează un token de acces

   În TikTok Events Manager, deschide pixelul tău și generează un token de acces Events API în setările lui. Copiază tokenul și codul pixelului.

4. Adaugă pixelul TikTok în ROASaurus

   Mergi la Tracking & platforms, fă click pe Add pixel pe cardul TikTok și completează Pixel code și Events API access token. Lasă bifat Also load the browser pixel (recommended, deduplicated), ca evenimentele din browser și de pe server să aibă aceleași id-uri.

5. Adaugă cheltuielile (opțional)

   Completează Advertiser ID for spend și un Marketing API token. ROASaurus importă apoi cheltuielile TikTok, astfel încât campaniile TikTok să arate ROAS și CPA alături de celelalte canale ale tale.

6. Testează, apoi treci în producție

   Trimite o comandă de test cu un cod de eveniment de test, așa cum este descris mai sus, apoi elimină codul.

Cu Respect visitor consent activat, ceea ce este implicit, ROASaurus respectă alegerea cumpărătorului din bannerul de cookie-uri al Shopify. Când un cumpărător refuză cookie-urile de marketing, ROASaurus nu încarcă pixelul TikTok pentru el, nu setează un id de vizitator, deci click-urile lui nu îi sunt asociate, și nu trimite către TikTok evenimentele lui de navigare. Comanda lui plătită este totuși trimisă către Events API de pe server, cu datele comenzii cu hash și cu adresa IP și user agent-ul comenzii, dar fără ttclid sau _ttp. Ghidul despre consimțământ și confidențialitate explică ce este stocat și trimis.

Cu cheltuielile sincronizate, campaniile TikTok apar în rapoartele de atribuire alături de Meta, iar analiza creativelor adaugă statisticile video TikTok pentru fiecare reclamă. ROASaurus atribuie comenzile click-urilor pe reclame și UTM-urilor pe care le-a înregistrat și numără conversiile view-through doar ca estimare modelată, în modelul său Clicks & views, deci totalurile lui diferă de obicei de TikTok Ads Manager. Pentru celelalte platforme server-side, vezi ghidul Pinterest Conversions API și ghidul Meta Conversions API.

Surse

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

În ROASaurus

• Integrare TikTok
• Tracking server-side în ROASaurus
• Ajutor: prevenirea dublei numărări
• Ajutor: configurează ROASaurus pe Shopify

Continuă lectura