# Rozwiązywanie problemów

> Rozwiązywanie problemów z DataFirefly Server-Side: nic nie dociera, błędy 401, zniknięty webhook Shopify, duplikaty w GA4, konwersje Unassigned.

- Strona oryginalna: https://server-side.datafirefly.com/pl/docs/troubleshooting.html
- Język: pl
- Zaktualizowano: 2026-09-01
- Wydawca: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/pl/

---

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łą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 `purchase` i wyłącznie po `transaction_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](https://server-side.datafirefly.com/pl/docs/prestashop.html), [WooCommerce](https://server-side.datafirefly.com/pl/docs/woocommerce.html) i [Shopware](https://server-side.datafirefly.com/pl/docs/shopware.html)). 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: [support@datafirefly.com](https://server-side.datafirefly.com/pl/contact.html), załączając wynik przycisku „Diagnose my connection”. Odpowiadamy w ciągu jednego dnia roboczego.

Aktualizacja: 1 września 2026
