# Instalace pluginu WooCommerce

> Instalace a konfigurace pluginu DataFirefly Server-Side na WooCommerce: propojovací klíč dfss\_, celá nákupní cesta, deduplikace objednávek, podporované CMP.

- Původní stránka: https://server-side.datafirefly.com/cs/docs/woocommerce.html
- Jazyk: cs
- Aktualizováno: 2026-09-05
- Vydavatel: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/cs/

---

Celá nákupní cesta, od zobrazení produktu po nákup, s automatickou deduplikací a frontou opakovaných odeslání. Kompatibilní s HPOS.

## Požadavky

- WordPress 5.8+, WooCommerce 5.0+, PHP 7.4+. Kompatibilní s HPOS.
- Zip pluginu, ke stažení na stránce [**Modules**](https://admin.datafirefly.com/app/connectors) vaší klientské sekce.
- [Propojovací klíč vašeho webu](https://server-side.datafirefly.com/cs/docs/connect-your-site.html).

## Instalace

1. Administrace WordPressu: **Plugins > Add New > Upload Plugin**.
2. Nahrajte zip a klikněte na **Activate**.

## Konfigurace

1. Otevřete **Settings > DataFirefly Server-Side**.
2. 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í

1. Testovací událost se musí zobrazit jako **Delivered** v Monitoringu vaší klientské sekce.
2. 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íží](https://server-side.datafirefly.com/cs/docs/troubleshooting.html).

## 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íží](https://server-side.datafirefly.com/cs/docs/troubleshooting.html).

Aktualizováno: 1. září 2026
