Požadavky
- Shopware 6.5, 6.6 nebo 6.7.
- Zip pluginu, ke stažení na stránce Modules vaší klientské sekce.
- Propojovací klíč vašeho webu.
Instalace
- Administrace Shopware: Extensions > My extensions > Upload extension, poté plugin nainstalujte a aktivujte.
- Nebo v CLI:
bin/console plugin:install --activate DatafireflyServerSide
Konfigurace
- Otevřete konfiguraci pluginu a vložte propojovací klíč
dfss_.... - Zapněte Enable tracking.
Modul sám rozpozná běžné nástroje souhlasu (DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron), v prohlížeči i na serveru, stejný seznam jako u modulů pro WooCommerce a PrestaShop. Nechte Consent cookie name prázdné pro toto automatické rozpoznání; vyplňte je jen tehdy, chcete-li vynutit konkrétní cookie (například CookieConsent a marketing:true), která pak má přednost.
Ověření
- Spusťte
bin/console datafirefly:serverside:test. - Testovací událost se musí zobrazit jako Delivered v Monitoringu vaší klientské sekce.
Fronta opakovaných odeslání
Platí od verze 1.23.0.
- Neúspěšné odeslání se zařadí do fronty a každých 5 minut se zopakuje naplánovanou úlohou Shopware.
- Nákupy a refundace mají přednost, po nich nejnovější události.
- Událost z fronty odejde, až když je starší než 7 dní a zároveň čeká déle než 7 dní. Pak se započítá jako prošlá: nic nezmizí bez povšimnutí.
- Když DataFirefly neodpovídá (chyba sítě, HTTP 429 nebo 5xx), obchod na 60 sekund přestane odesílat přímo a události rovnou řadí do fronty. Výpadek na naší straně tak nikdy nezpomalí váš obchod ani pokladnu. Opakování to dál zkouší, a jakmile uspěje, přímé odesílání se obnoví.
- Stránka vašeho webu v klientské sekci ukazuje stav této fronty. Jednotlivé stavy vysvětluje stránka Řešení potíží.
Když něco nefunguje
- Logy ve
var/log/, prefix[DataFirefly SS]. - Pokud používáte verzi pluginu starší než 1.9.0, aktualizujte: novější verze opravují možné dvojí započítání nákupů v GA4.
- Další časté příčiny najdete v průvodci řešením potíží.
Aktualizováno: 1. září 2026