Požadavky
- WordPress 5.8+, WooCommerce 5.0+, PHP 7.4+. Kompatibilní s HPOS.
- Zip pluginu, ke stažení na stránce Modules vaší klientské sekce.
- Propojovací klíč vašeho webu.
Instalace
- Administrace WordPressu: Plugins > Add New > Upload Plugin.
- Nahrajte zip a klikněte na Activate.
Konfigurace
- Otevřete Settings > DataFirefly Server-Side.
- Vložte propojovací klíč
dfss_...a klikněte na Connect: tlačítko zapne kompletní měření i volbu souhlasu a rovnou odešle testovací událost.
Plugin automaticky rozpozná následující nástroje souhlasu, bez nastavování: WP Consent API, Complianz, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron. Moduly pro PrestaShop a Shopware používají stejné rozpoznávání: nástroj rozpoznaný zde je rozpoznaný všude.
Co plugin pokrývá
- Celou nákupní cestu: prohlížení, zobrazení produktu, košík, pokladnu, nákup.
- Deduplikaci podle identifikátoru objednávky: žádné dvojí započítání mezi prohlížečem a serverem.
- Automatickou frontu opakovaných odeslání: neúspěšná odeslání se opakují, nákupy jako první (podrobnosti níže).
- Panel DataFirefly Activity v administraci zobrazuje poslední odeslané události.
Ověření
- Testovací událost se musí zobrazit jako Delivered v Monitoringu vaší klientské sekce.
- Vytvořte testovací objednávku a najděte ji v panelu DataFirefly Activity.
Fronta opakovaných odeslání
Platí od verze 2.30.0.
- Neúspěšné odeslání se zařadí do fronty a každých 5 minut se zopakuje přes WP-Cron.
- 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
- Po každé změně konfigurace vymažte cache svého webu: LiteSpeed Cache a podobné pluginy jinak dál servírují starý JavaScript.
- Pokud používáte verzi pluginu starší než 2.8.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