Events API TikTok – serwerowe śledzenie konwersji krok po kroku

Piksel i Events API – dlaczego razem

Piksel wysyła zdarzenia z przeglądarki klienta. To proste rozwiązanie, ale według Centrum pomocy może być ograniczane przez problemy z przeglądarką lub restrykcje. Events API wysyła zdarzenia z serwera, co daje bardziej niezawodne połączenie i kontrolę nad tym, co jest udostępniane. W poradach dotyczących połączeń danych TikTok zaleca połączenie obu rozwiązań: wysyłanie zdarzeń zarówno z przeglądarki, jak i z serwera pomaga zmaksymalizować liczbę przekazanych zdarzeń i może poprawić skuteczność oraz pomiar. [#chart:tt45]

TikTok rekomenduje wszystkim reklamodawcom kampanii konwersyjnych na stronę trzy elementy: połączenie piksela i Events API z deduplikacją zdarzeń, spójne przesyłanie zdarzeń i parametrów na całej ścieżce klienta w obu źródłach oraz przekazywanie wszystkich istotnych kluczy dopasowania. Mechanizm jest bardzo podobny do Conversions API w Meta, które opisujemy w artykule o Conversions API.

Deduplikacja zdarzeń – jak uniknąć podwójnego liczenia

Jeśli to samo zdarzenie, np. zakup, wysyłasz jednocześnie przez piksel i Events API, TikTok musi wiedzieć, że chodzi o jedno zamówienie. Według Centrum pomocy o deduplikacji w takiej sytuacji deduplikacja jest wymagana, a warunkiem jest przekazywanie parametru event_id – identyfikatora zdarzenia – zarówno przez piksel, jak i przez Events API. Gdy TikTok rozpozna duplikaty, zachowa pierwsze otrzymane zdarzenie i może je wzbogacić danymi z drugiego.

Deduplikacja nie jest potrzebna, jeśli przez piksel i Events API wysyłasz różne zdarzenia, bez nakładania się – np. AddToCart tylko przez piksel, a Purchase tylko przez Events API. Centrum pomocy opisuje też okna czasowe: zdarzenia z tym samym event_id są deduplikowane, jeśli docierają w ciągu 48 godzin od pierwszego zdarzenia; przy nakładaniu się piksela i Events API dotyczy to zdarzeń, które docierają po 5 minutach i w ciągu 48 godzin od pierwszego.

[#tip] Najprostszym event_id dla zakupu jest numer zamówienia ze sklepu – ten sam w pikselu i w zdarzeniu z serwera. Dla innych zdarzeń możesz generować unikalny identyfikator w przeglądarce i przekazywać go do serwera razem z danymi zdarzenia. Podobne zasady dla Meta opisujemy w artykule o deduplikacji zdarzeń.

Klucze dopasowania – jakie dane przekazywać

Żeby zdarzenie z serwera mogło zostać przypisane do osoby, która widziała reklamę na TikToku, potrzebne są klucze dopasowania. Według Centrum pomocy TikTok Ads przy Events API warto przekazywać następujące dane.

Centrum pomocy TikTok o zaawansowanym dopasowaniu wyjaśnia, że e-maile i numery telefonów są haszowane algorytmem SHA-256 przed dotarciem na serwery TikToka. TikTok zaleca jednoczesne korzystanie z ręcznego i automatycznego zaawansowanego dopasowania, a w branżach bardziej regulowanych, np. finansach czy ochronie zdrowia, rozważenie samego dopasowania ręcznego. Pamiętaj, że przekazywanie danych klientów musi być zgodne z RODO i polityką prywatności sklepu. O jakości dopasowania zdarzeń w Meta piszemy w artykule o Event Match Quality.

Jak wdrożyć Events API w sklepie

Według Centrum pomocy połączenie danych dla strony – zarówno piksel, jak i Events API – można skonfigurować przez wybranych partnerów zewnętrznych albo ręcznie. W Events Manager wybierasz Połącz źródło danych, następnie Web, a potem sposób połączenia. [#chart:tt45b]

Integracja partnerska to najprostsza droga dla sklepów na popularnych platformach. Jeśli Twoja platforma lub wtyczka oferuje integrację z TikTokiem obejmującą Events API, wdrożenie sprowadza się często do połączenia kont i wybrania ustawień udostępniania danych. Sprawdź dokumentację swojej platformy – o integracjach TikToka ze Shopify, WooCommerce i Shoper piszemy w artykule o łączeniu sklepu z TikTokiem.

Wdrożenie własne wymaga pracy programisty. Serwer sklepu wysyła zdarzenia do TikToka zgodnie z dokumentacją API dla firm, z tokenem dostępu wygenerowanym w Events Manager. Kluczowe jest, żeby zdarzenia z serwera miały te same nazwy i parametry co zdarzenia z piksela, zawierały event_id do deduplikacji oraz jak najwięcej kluczy dopasowania. Po wdrożeniu sprawdź dane w funkcji Testuj zdarzenia i w zakładce Diagnostyka w Events Manager.

[#przyklad] Sklep z suplementami ma piksel z pełnym zestawem zdarzeń, ale zauważa, że w Ads Managerze widzi wyraźnie mniej zakupów niż w panelu sklepu. Programista dodaje wysyłanie zdarzenia Purchase z serwera w momencie potwierdzenia płatności, z numerem zamówienia jako event_id, zahaszowanym e-mailem klienta i Click ID zapisanym przy wejściu z reklamy. Po kilku dniach liczba zakupów w raportach jest bliższa danym ze sklepu, a w Events Manager nie widać zdublowanych zdarzeń.

Najczęstsze błędy przy wdrażaniu Events API

• Brak event_id – te same zakupy liczone podwójnie, raz z piksela, raz z serwera.

• Różne nazwy zdarzeń w obu źródłach – np. CompletePayment w pikselu i Purchase w API utrudniają analizę; w nowych wdrożeniach używaj Purchase.

• Brak IP i user agenta – w Events API trzeba je przekazać ręcznie, inaczej dopasowanie jest słabsze.

• Niezahaszowany e-mail lub telefon – TikTok wymaga haszowania tych danych.

• Zdarzenia tylko z serwera bez Click ID – trudniej przypisać zakup do reklamy.

• Brak testów po zmianach w sklepie – aktualizacja platformy lub koszyka potrafi przerwać wysyłanie zdarzeń.

Raz skonfigurowany pomiar trzeba monitorować. Warto co tydzień porównywać liczbę zakupów w Events Manager z danymi ze sklepu i sprawdzać zakładkę Diagnostyka. Duża, nagła różnica to sygnał, że coś przestało działać. Pamiętaj też, że nawet idealny pomiar nie da identycznych liczb jak sklep czy Google Analytics 4 – TikTok przypisuje konwersje według własnego modelu atrybucji. Jak wykorzystać dane w kampaniach, opisujemy w przewodnikach po TikTok Ads Manager i TikTok Ads dla sklepu.

Events API a zgody użytkowników

Przesyłanie zdarzeń z serwera nie zwalnia sklepu z obowiązków wynikających z przepisów o ochronie danych. To, że zdarzenie nie przechodzi przez przeglądarkę, nie oznacza, że możesz je wysyłać bez względu na decyzję klienta w banerze zgód. Ustal z osobą odpowiedzialną za RODO, na jakiej podstawie przekazujesz dane do TikToka, i zadbaj o to, żeby wysyłanie zdarzeń z serwera respektowało te same zgody co piksel. Informacje o przekazywaniu danych do TikToka powinny znaleźć się w polityce prywatności sklepu.

Events API daje tu jedną przewagę: pełną kontrolę nad tym, jakie dane trafiają do TikToka. Możesz przekazywać tylko te parametry, które są potrzebne do celów marketingowych, i świadomie decydować o kluczach dopasowania. Podobne zagadnienia dla Meta opisujemy w artykule o pikselu Meta a zgodach cookies.

Najczęściej zadawane pytania

Czy Events API zastępuje piksel TikTok?

Nie musi. Dla połączeń ze stroną internetową TikTok zaleca korzystanie z Events API razem z pikselem i deduplikacją zdarzeń. Połączenie obu źródeł pomaga przekazać więcej zdarzeń i poprawić pomiar.

Czy do kampanii sprzedażowych potrzebuję Events API?

Według Centrum pomocy warunkiem kampanii konwersyjnych na stronę jest piksel lub Events API. Events API nie jest więc obowiązkowe, jeśli masz działający piksel, ale TikTok zaleca je jako uzupełnienie.

Czym jest event_id?

To identyfikator zdarzenia przekazywany zarówno przez piksel, jak i przez Events API. Dzięki niemu TikTok rozpoznaje duplikaty i liczy jedno zamówienie tylko raz.

Jakie dane klienta mogę przesyłać przez Events API?

Centrum pomocy wymienia m.in. Click ID, zahaszowany e-mail i telefon, zahaszowane External ID, adres IP, user agent i wartość cookie ttp. Przekazywanie danych musi być zgodne z RODO i polityką prywatności sklepu.

Czy wdrożenie Events API wymaga programisty?

Przy integracji partnerskiej często nie – wystarczy połączyć konta i wybrać ustawienia. Przy wdrożeniu własnym potrzebny jest programista, który skonfiguruje wysyłanie zdarzeń z serwera zgodnie z dokumentacją API.

Podsumowanie

Events API TikTok przesyła zdarzenia ze sklepu bezpośrednio z serwera i uzupełnia piksel, pomagając odzyskać część konwersji, które gubią się w przeglądarce. TikTok zaleca korzystanie z obu rozwiązań jednocześnie, z deduplikacją przez event_id, spójnymi zdarzeniami i parametrami oraz pełnym zestawem kluczy dopasowania. Wdrożenie możesz wykonać przez integrację partnerską lub samodzielnie, a po uruchomieniu regularnie monitoruj dane w Events Manager, porównując je z liczbą zamówień w sklepie.

Wdrażamy i obsługujemy TikTok Shop i kampanie na TikToku – konfigurujemy piksel i Events API, sprawdzamy deduplikację i jakość danych, a potem prowadzimy kampanie na rzetelnym pomiarze. Sprawdź naszą usługę prowadzenia social mediów dla e-commerce.