TikTok Events API v1.3

Śledzenie konwersji TikTok po stronie serwera

Twoje konwersje wychodzą z Twojego serwera do API zdarzeń TikTok, a nie z przeglądarki odwiedzającego, który być może blokuje piksel. Zakup wyzwala zatwierdzone zamówienie, a nie strona podziękowania, której klient może nigdy nie wczytać.

Identyfikatory są normalizowane, a potem hashowane przed wysyłką: TikTok dostaje tyle, by powiązać konwersję z osobą, nigdy samego adresu.

Wysyłane z Twojego serwera Identyfikatory hashowane przed wysyłką Hostowane w UE
Droga zakupu
Twój sklep Zamówienie zatwierdzane po stronie serwera, nie na stronie podziękowania
Dispatcher DataFirefly Zgoda sprawdzona, identyfikatory znormalizowane i zahaszowane
TikTok Events API v1.3 CompletePayment, z kwotą i produktami
Pageview AddToCart CompletePayment SubmitForm
Problem

Gdzie sklep traci konwersje z TikToka

Piksel TikToka zależy od kruchego łańcucha: przeglądarka wczytuje skrypt, wykonuje go i nic po drodze go nie blokuje.

Piksel się nie wczytuje

Blokery, restrykcyjne przeglądarki, zerwane połączenie mobilne w trakcie sesji: zdarzenie nigdy nie powstaje, a TikTok optymalizuje na tym, co zostało.

Zakup zależy od strony

Piksel odpala się na stronie potwierdzenia. Kto zamknie kartę po zapłacie, kupił: a konwersja nigdy nie wyszła.

Słabe dopasowanie kosztuje ROAS

Bez użytecznego identyfikatora TikTok nie powiąże konwersji z profilem. Kampania wygląda gorzej, niż jest, a algorytm uczy się na niepełnych danych.

Instalacja

Trzy kroki i nic do przepisywania

Konektor instaluje się w sklepie; resztę ustawia się w konsoli.

1: Zainstaluj konektor

Moduł PrestaShop, wtyczka WooCommerce albo rozszerzenie Shopware, pobrane z konsoli. Bez pisania kodu.

2: Wklej dwie wartości

Kod piksela i token, wzięte z Twojego konta TikTok. Są szyfrowane w spoczynku i nigdy nie pojawiają się ponownie na stronie.

3: Sprawdź w Test Events

Twoje zdarzenia trafiają do ekranu testowego TikToka, zanim przełączysz się na produkcję.

Odpowiedniki

Co dostaje TikTok, zdarzenie po zdarzeniu

Dwanaście naszych zdarzeń ma oficjalną nazwę w TikToku. Te bez nazwy nie są tam wysyłane: trafiają do pozostałych miejsc, bez błędu i bez straty.

Nasza nazwa Nazwa u platformy
page_viewPageview
view_contentViewContent
add_to_cartAddToCart
initiate_checkoutInitiateCheckout
add_payment_infoAddPaymentInfo
purchaseCompletePayment
leadSubmitForm
complete_registrationCompleteRegistration
searchSearch
add_to_wishlistAddToWishlist
contactContact
subscribeSubscribe
Ograniczenia

Czego TikTok nie zrobi

Każde miejsce docelowe ma zamknięty słownik, poza jednym. Oto co z tego wynika: powiedziane, zanim to odkryjesz.

Zdarzenia bez nazwy w TikToku nie wychodzą

TikTok nie ma oficjalnego odpowiednika dla rezerwacji, udostępnienia czy zgłoszenia. Te zdarzenia nie są tam wysyłane: trafiają do pozostałych miejsc, bez błędu. Wolimy nie wysłać nic, niż wtłoczyć je w zbliżoną nazwę, która zafałszowałaby Twoje liczby.

Jakość dopasowania zależy od Ciebie

TikTok wiąże konwersję z profilem dzięki identyfikatorom, które przekazuje nam Twój sklep. Zamówienie bez adresu e-mail i tak wychodzi, ale dopasowuje się gorzej. Konsola pokazuje to pokrycie dzień po dniu.

Sprawdzalne

Co konsola pokaże Ci dla tego miejsca docelowego

Argument, który możemy postawić, bo strona istnieje: nie musisz nam wierzyć, patrzysz.

Każde zdarzenie, z odpowiedzią platformy

Inspector wypisuje, co wyszło, co miejsce docelowe z tym zrobiło i dokładny powód odmowy. Nieprawidłowy identyfikator czy wygasły token czyta się wprost, tego samego dnia.

Pokrycie identyfikatorami

Ile Twoich zdarzeń niosło dość, by powiązać konwersję z osobą. To decyduje o jakości dopasowania, a więc o ROAS, który odczytasz u reklamodawcy.

Okresy, w których nic nie wyszło

Najdroższa i najcichsza anomalia: pusty panel czyta się jak słaby tydzień, nigdy jak awaria. Konsola je nazywa.

Czego potrzebujesz

Czego potrzebujesz

Dwie wartości, z Twojego konta TikTok. Nigdy nie prosimy o hasło.

Kod piksela

TikTok Ads Manager → Assets → Events → Web Events → Twój piksel. To „Event Source ID”.

Token dostępu

Wygenerowany w konfiguracji Events API na tym samym ekranie. Szyfrowany w spoczynku i nigdy niewidoczny na stronie.

Kod zdarzenia testowego (opcjonalnie)

Aby zobaczyć zdarzenia w Test Events przed przejściem na produkcję.

Prywatność

Co nie opuszcza naszej infrastruktury

Produkt, który przetwarza dane klientów, jest winien odpowiedź, gdzie się zatrzymuje.

Identyfikatory są hashowane przed wysyłką

Znormalizowane, a potem zahaszowane u nas: miejsce docelowe dostaje odcisk, nigdy adresu e-mail ani numeru telefonu.

Zgoda decyduje, także po stronie serwera

Każde zdarzenie niesie stan zapisany przez Twój baner. Odmowa pozostaje odmową: przejście przez serwer niczego nie obchodzi.

Hostowane w Unii Europejskiej

Dispatcher, baza i konsola są w Niemczech. Twoje tokeny są szyfrowane w spoczynku i nigdy nie pojawiają się jawnie na stronie.

Bez niespodzianek

Prosta instalacja, bez dodatkowych kosztów

To decyzja projektowa, nie obietnica handlowa: nie ma nic do hostowania ani nic do odblokowywania plan po planie.

Moduł jak każdy inny

Konektor instaluje się jak każde inne rozszerzenie sklepu. Nic do hostowania: żadnego kontenera do wynajęcia, serwera do utrzymania ani subdomeny do skonfigurowania.

Wszystkie miejsca docelowe, w każdym planie

Łącznie z darmowym. Plany różnią się wyłącznie liczbą stron i zdarzeń: żadne miejsce docelowe nie jest zarezerwowane dla wyższego progu, choć taki jest zwyczaj.

Start nic nie kosztuje

Plan darmowy obejmuje jedną stronę i 10 000 zdarzeń miesięcznie, bez karty. Nic się nie psuje po przekroczeniu limitu.

Ce qu'on nous demande

Questions fréquentes

Czy piksel TikToka jest nadal potrzebny?

Tak, i to celowo. Piksel i wysyłka serwerowa niosą ten sam identyfikator zdarzenia, więc TikTok je łączy zamiast liczyć dwa razy. Piksel dostarcza kontekst przeglądarki, serwer gwarantuje, że zakup dotrze, nawet jeśli piksel nie mógł się wykonać.

Czy moje konwersje zostaną policzone podwójnie?

Nie. Deduplikacja opiera się na identyfikatorze zdarzenia, który ustalamy z numeru zamówienia. Dwie wysyłki tego samego zamówienia mają ten sam identyfikator: TikTok zatrzymuje jedną.

Jakie dane osobowe są wysyłane?

Identyfikatory są normalizowane, a potem hashowane, zanim opuszczą naszą infrastrukturę: TikTok dostaje odcisk, nigdy adres. Nic nie wychodzi bez zgody zarejestrowanej przez Twój baner.

Co się dzieje, gdy TikTok odrzuci zdarzenie?

Inspector w konsoli pokazuje odmowę z dokładnym komunikatem TikToka. Wygasły token widać tego samego dnia, nie przy miesięcznym podsumowaniu.

Podłącz to miejsce docelowe w kilka minut

Plan darmowy obejmuje wszystkie miejsca docelowe. Bez zobowiązań i bez karty.