Wymagania
- Shopware 6.5, 6.6 lub 6.7.
- Plik zip wtyczki, do pobrania ze strony Modules Twojego panelu klienta.
- Klucz połączenia Twojej witryny.
Instalacja
- Panel administracyjny Shopware: Extensions > My extensions > Upload extension, następnie zainstaluj i aktywuj wtyczkę.
- Albo w CLI:
bin/console plugin:install --activate DatafireflyServerSide
Konfiguracja
- Otwórz konfigurację wtyczki i wklej klucz połączenia
dfss_.... - Włącz Enable tracking.
Moduł sam rozpoznaje popularne narzędzia zgody (DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron), w przeglądarce i na serwerze, ta sama lista co w modułach WooCommerce i PrestaShop. Proszę zostawić Consent cookie name puste, aby użyć tego automatycznego wykrywania; wypełnić je tylko po to, by wymusić konkretne cookie (na przykład CookieConsent i marketing:true), które wtedy ma pierwszeństwo.
Weryfikacja
- Uruchom
bin/console datafirefly:serverside:test. - Zdarzenie testowe musi pojawić się ze statusem Delivered w Monitoringu Twojego panelu klienta.
Kolejka ponownych wysyłek
Dotyczy wersji 1.23.0 i nowszych.
- Nieudana wysyłka trafia do kolejki i jest ponawiana co 5 minut przez zaplanowane zadanie Shopware.
- 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 w
var/log/, prefiks[DataFirefly SS]. - Jeśli używasz wersji wtyczki starszej niż 1.9.0, zaktualizuj ją: 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