„Nic nie dociera”
Trzy przyczyny, w kolejności prawdopodobieństwa:
- Zgoda. Jeśli opcja „Require consent” jest włączona, a Twoja witryna nie ma banera CMP albo odwiedzający nie wyraził zgody, żadne zdarzenie nie wychodzi: to oczekiwane zachowanie, nie awaria. Nieomylny sygnał: przycisk Send test event działa (pomija zgodę), ale nic innego nie dociera.
- Witryna nigdy nie została aktywowana. Niezapisane platformy docelowe albo nigdy niekliknięty przycisk „Activate my tracking”: moduł otrzymuje błędy 401.
- Tracking jest wyłączony w module. Na PrestaShop i Shopware „Enable tracking” jest domyślnie OFF.
Błędy 401
| Błąd | Przyczyna i rozwiązanie |
|---|---|
unknown_tenant | Witryna czeka na aktywację albo Site ID jest błędny |
invalid_signature | Body zostało ponownie zakodowane między podpisaniem a wysyłką: podpisuj dokładnie te bajty, które wysyłasz |
timestamp_out_of_window | Timestamp w milisekundach zamiast sekund albo niezsynchronizowany zegar serwera (NTP) |
Po rotacji klucza HMAC
Zbieranie danych jest przerwane, dopóki nowy klucz nie zostanie wklejony w module. To celowe: rotacja służy właśnie do unieważnienia starego klucza.
Shopify
- Zniknięty webhook: usunięty przez Shopify po około 48 godzinach niepowodzeń. Sprawdź Site ID w adresie URL i utwórz webhook ponownie.
- Zduplikowane zamówienia: obok webhooka „Order payment” pozostał webhook „Order creation”. Usuń go.
WordPress / WooCommerce
Po każdej zmianie konfiguracji wyczyść cache witryny: inaczej LiteSpeed Cache i inne wtyczki cache nadal serwują stary JavaScript.
GA4
- Zduplikowane zakupy: zaktualizuj moduł (PrestaShop 1.8.0+, WooCommerce 2.8.0+, Shopware 1.9.0+). GA4 deduplikuje wyłącznie
purchasei wyłącznie potransaction_id: nowsze wersje nie wysyłają już zakupu po stronie przeglądarki. - Konwersje „Unassigned”: wysyłane zdarzenia niosą identyfikator sesji i stronę odsyłającą, co przypisuje konwersje do ich kanału. Historia zarejestrowana już przez GA4 nie zostaje przeklasyfikowana: przypisanie działa dla ruchu od tej chwili.
„Delivered”, ale mała atrybucja
Dostarczone zdarzenie nie musi zostać przypisane: atrybucja zależy od jakości dopasowania. Wzbogać wysyłane dane użytkownika: e-mail, telefon, IP i user agent, cookies fbp i gclid. Moduły DataFirefly przekazują je automatycznie, gdy są dostępne i gdy pozwala na to zgoda.
Okna odtwarzania
Zanim DataFirefly wyśle zdarzenie do platformy, sprawdza jego wiek. Ta sama zasada obowiązuje dla zdarzenia wysyłanego na bieżąco, ponawianego przez moduł i zwolnionego po pauzie limitu planu darmowego.
- Meta, ChatGPT Ads (OpenAI) i Microsoft Advertising: 7 dni.
- GA4: po naszej stronie bez limitu. GA4 przyjmuje starsze zdarzenia i nadaje im nową datę; to świadoma decyzja.
- Google Ads, TikTok i Pinterest: po naszej stronie bez limitu, decyduje platforma.
Zdarzenie, które przekroczyło okno danego celu, nie jest do niego wysyłane. Inspector pokazuje je jako Not sent: too late: w chwili wysyłki zdarzenie było już starsze niż okno akceptacji tej platformy.
Kolejka modułu
Gdy sklep nie może połączyć się z DataFirefly, moduł umieszcza zdarzenia w kolejce i ponawia ich wysyłkę (zob. przewodniki PrestaShop, WooCommerce i Shopware). Strona Twojej witryny w panelu klienta pokazuje tę kolejkę: liczbę oczekujących zdarzeń, wiek najstarszego z nich i godzinę ostatniego raportu modułu.
| Stan | Znaczenie |
|---|---|
| Brak raportu | Moduł jeszcze niczego nie zgłosił. Wersje starsze niż PrestaShop 1.29.0, WooCommerce 2.30.0 i Shopware 1.23.0 pozostają w tym stanie: zaktualizuj moduł, aby zobaczyć kolejkę. |
| OK | Nic do zgłoszenia. |
| Opóźnienie | Najstarsze zdarzenie czeka dłużej niż godzinę. |
| Cisza | Zdarzenia czekały, a moduł od 2 godzin nie wysłał żadnego raportu. |
Gdy kolejka wymaga uwagi, dostajesz e-mail, najwyżej jeden na 24 godziny. Jeśli wiele witryn naraz zaczyna mieć opóźnienie, awaria leży najpewniej po stronie DataFirefly: e-maile do klientów są wtedy wstrzymywane, a powiadamiany jest tylko nasz zespół operacyjny.
Nadal nie działa?
Napisz do nas: [email protected], załączając wynik przycisku „Diagnose my connection”. Odpowiadamy w ciągu jednego dnia roboczego.
Aktualizacja: 1 września 2026