Rozwiązywanie problemów

Rzeczywiste przyczyny awarii, w kolejności, w jakiej się je spotyka. Zawsze zaczynaj od przycisku „Diagnose my connection” na stronie swojej witryny.

„Nic nie dociera”

Trzy przyczyny, w kolejności prawdopodobieństwa:

  1. 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.
  2. Witryna nigdy nie została aktywowana. Niezapisane platformy docelowe albo nigdy niekliknięty przycisk „Activate my tracking”: moduł otrzymuje błędy 401.
  3. Tracking jest wyłączony w module. Na PrestaShop i Shopware „Enable tracking” jest domyślnie OFF.

Błędy 401

BłądPrzyczyna i rozwiązanie
unknown_tenantWitryna czeka na aktywację albo Site ID jest błędny
invalid_signatureBody zostało ponownie zakodowane między podpisaniem a wysyłką: podpisuj dokładnie te bajty, które wysyłasz
timestamp_out_of_windowTimestamp 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

WordPress / WooCommerce

Po każdej zmianie konfiguracji wyczyść cache witryny: inaczej LiteSpeed Cache i inne wtyczki cache nadal serwują stary JavaScript.

GA4

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

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.

StanZnaczenie
Brak raportuModuł 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ę.
OKNic do zgłoszenia.
OpóźnienieNajstarsze zdarzenie czeka dłużej niż godzinę.
CiszaZdarzenia 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