# Śledzenie konwersji TikTok po stronie serwera

> Wysyłaj konwersje do API zdarzeń TikTok ze swojego serwera: zakup wyzwalany przez zatwierdzone zamówienie, identyfikatory hashowane, hosting w UE.

- Strona oryginalna: https://server-side.datafirefly.com/pl/tiktok-events-api-server-side-tracking.html
- Język: pl
- Zaktualizowano: 2026-09-05
- Wydawca: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/pl/

---

TikTok Events API v1.3

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.

[Załóż konto](https://admin.datafirefly.com/pricing?lang=pl) Zobacz, co jest wysyłane

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 (poza webhookami Shopify)

**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_view` | `Pageview` |
| `view_content` | `ViewContent` |
| `add_to_cart` | `AddToCart` |
| `initiate_checkout` | `InitiateCheckout` |
| `add_payment_info` | `AddPaymentInfo` |
| `purchase` | `CompletePayment` |
| `lead` | `SubmitForm` |
| `complete_registration` | `CompleteRegistration` |
| `search` | `Search` |
| `add_to_wishlist` | `AddToWishlist` |
| `contact` | `Contact` |
| `subscribe` | `Subscribe` |

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. W Shopify piksel DataFirefly respektuje zgodę marketingową zarejestrowaną w Shopify, ale zamówienia przychodzą przez podpisane webhooki, które nie przekazują sygnału zgody, dlatego obowiązuje je Twoja własna polityka zgód.

### 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. W Shopify piksel DataFirefly respektuje zgodę marketingową zarejestrowaną w Shopify, ale zamówienia przychodzą przez podpisane webhooki, które nie przekazują sygnału zgody, dlatego obowiązuje je Twoja własna polityka zgód.

### 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.

Dalej

## Kolejny krok

Zainstalować konektor w sklepie, wiedzieć, co mierzy, i sprawdzić, co naprawdę wyszło.

### [Moduł PrestaShop](https://server-side.datafirefly.com/pl/prestashop-server-side-tracking.html)

Instalacja w sklepie PrestaShop, krok po kroku.

### [Wtyczka WooCommerce](https://server-side.datafirefly.com/pl/woocommerce-server-side-tracking.html)

Instalacja w WordPressie i WooCommerce.

### [Rozszerzenie Shopware](https://server-side.datafirefly.com/pl/shopware-server-side-tracking.html)

Instalacja w Shopware 6.

### [Co mierzymy](https://server-side.datafirefly.com/pl/co-mierzymy.html)

28 zdarzeń po ludzku i to, co widzi strona bez sklepu.

### [Insights: panel](https://server-side.datafirefly.com/pl/insights.html)

Gdzie sprawdzasz, co wyszło i co miejsce docelowe z tym zrobiło.

### [Wszystkie miejsca docelowe](https://server-side.datafirefly.com/pl/#destinations)

Siedem platform, do których może trafić to samo zdarzenie.

## Podłącz to miejsce docelowe w kilka minut

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

[Zacznij za darmo](https://admin.datafirefly.com/pricing?lang=pl) [Napisz do nas](https://server-side.datafirefly.com/pl/contact.html)
