Wymagania
- PrestaShop 1.7.6 lub nowszy.
- Plik zip modułu, do pobrania ze strony Modules Twojego panelu klienta.
- Klucz połączenia Twojej witryny.
Instalacja
- Back office PrestaShop: Moduły > Menedżer modułów > Wgraj moduł.
- Wyślij plik zip w całości, bez rozpakowywania.
- Kliknij Konfiguruj.
Konfiguracja
- Uzupełnij Tenant ID, HMAC secret i Events endpoint: trzy wartości ze strony Twojej witryny w DataFirefly.
- Opcja Require consent: moduł przepuszcza zdarzenie dopiero wtedy, gdy odwiedzający zaakceptował reklamy. Rozpoznaje samodzielnie, bez konfiguracji: tarteaucitron, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, w przeglądarce i na serwerze, ta sama lista co w modułach WooCommerce i Shopware. Zalecane, jeśli sklep ma baner zgody.
- Przełącz Enable tracking na Yes: domyślnie jest wyłączony.
- Zapisz, a następnie kliknij Send test event.
Nie masz jeszcze banera zgody w swoim sklepie? Moduł Cookie Manager dla PrestaShop instaluje gotowy do użycia tarteaucitron z Consent Mode v2.
Weryfikacja
- Zdarzenie testowe musi pojawić się ze statusem Delivered w Monitoringu Twojego panelu klienta.
- Złóż zamówienie testowe: moduł wysyła zakupy przy zatwierdzeniu zamówienia.
Kolejka ponownych wysyłek
Dotyczy wersji 1.29.0 i nowszych.
- Nieudana wysyłka trafia do kolejki i jest ponawiana przy kolejnych wizytach w sklepie: najwyżej co 30 sekund, nigdy dwa ponowienia naraz, w paczkach do 20 zdarzeń wysyłanych równolegle.
- Sklep z małym ruchem: opcjonalny adres URL crona, chroniony tokenem i dostępny wyłącznie przez https, uruchamia ponowienie bez czekania na wizytę.
- Najpierw idą zakupy i zwroty, potem najnowsze zdarzenia.
- Zdarzenie opuszcza kolejkę dopiero wtedy, gdy ma ponad 7 dni i czeka w niej dłużej niż 7 dni. Jest wtedy liczone jako wygasłe: nic nie znika bez śladu.
- Jeśli DataFirefly nie odpowiada (błąd sieci, HTTP 429 lub 5xx), sklep przez 60 sekund nie wysyła niczego bezpośrednio i od razu umieszcza zdarzenia w kolejce. Awaria po naszej stronie nigdy więc nie spowalnia sklepu ani procesu składania zamówienia. Ponawianie nadal próbuje, a gdy się powiedzie, wysyłka bezpośrednia zostaje wznowiona.
- Strona Twojej witryny w panelu klienta pokazuje stan tej kolejki. Stany opisuje strona Rozwiązywanie problemów.
Gdy coś nie działa
- Logi: Zaawansowane > Logi, filtruj po prefiksie
[DataFirefly SS]. - Jeśli używasz wersji modułu starszej niż 1.8.0, zaktualizuj go: nowsze wersje naprawiają możliwe podwójne zliczanie zakupów w GA4.
- Pozostałe częste przyczyny znajdziesz w przewodniku rozwiązywania problemów.
Aktualizacja: 1 września 2026