# Installer le plugin WooCommerce

> Installer et configurer le plugin DataFirefly Server-Side sur WooCommerce : clé de connexion dfss\_, tunnel complet, déduplication des commandes, CMP compatibles.

- Page d'origine : https://server-side.datafirefly.com/docs/woocommerce.html
- Langue : fr
- Mis à jour le : 2026-09-05
- Éditeur : DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/

---

Tunnel complet, de la vue produit à l'achat, avec déduplication automatique et file de renvoi. Compatible HPOS.

## Prérequis

- WordPress 5.8+, WooCommerce 5.0+, PHP 7.4+. Compatible HPOS.
- Le zip du plugin, à télécharger depuis la page [**Modules**](https://admin.datafirefly.com/app/connectors) de votre espace client.
- La [clé de connexion de votre site](https://server-side.datafirefly.com/docs/connect-your-site.html).

## Installation

1. Admin WordPress : **Extensions > Ajouter > Téléverser une extension**.
2. Envoyez le zip, puis cliquez **Activer**.

## Configuration

1. Ouvrez **Réglages > DataFirefly Server-Side**.
2. Collez la clé de connexion `dfss_...` et cliquez **Connect** : le bouton active le tracking complet et l'option de consentement, et déclenche un événement de test dans la foulée.

Le plugin détecte automatiquement les outils de consentement suivants, sans réglage : WP Consent API, Complianz, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron. La même détection est utilisée par les modules PrestaShop et Shopware : un outil reconnu ici l'est partout.

## Ce que le plugin couvre

- Tout le tunnel : navigation, vue produit, panier, checkout, achat.
- Déduplication par identifiant de commande : pas de double comptage entre navigateur et serveur.
- File de renvoi automatique : les envois échoués sont rejoués, les achats en premier (détails ci-dessous).
- Le panneau **DataFirefly Activity** dans l'admin montre les derniers événements envoyés.

## Vérifier

1. L'événement de test doit apparaître en **Delivered** dans le Monitoring de votre espace client.
2. Passez une commande de test et retrouvez-la dans le panneau DataFirefly Activity.

## File de renvoi

Comportement des versions 2.30.0 et suivantes.

- Un envoi échoué est mis en file, puis rejoué toutes les 5 minutes par WP-Cron.
- Les achats et les remboursements passent en premier, puis les événements les plus récents.
- Un événement ne sort de la file que s'il a plus de 7 jours **et** attend depuis plus de 7 jours. Il est alors compté comme expiré : rien ne disparaît en silence.
- Si DataFirefly ne répond pas (panne réseau, erreur HTTP 429 ou 5xx), la boutique cesse d'envoyer en direct pendant 60 secondes et met les événements directement en file. Une panne chez nous ne ralentit donc jamais votre boutique ni le checkout. Le rejeu continue d'essayer, et dès qu'il réussit, l'envoi direct reprend.
- La page de votre site, dans l'espace client, affiche l'état de cette file. Les états sont expliqués dans le [guide de dépannage](https://server-side.datafirefly.com/docs/troubleshooting.html).

## En cas de problème

- Après un changement de configuration, **purgez le cache** de votre site : LiteSpeed Cache et consorts servent sinon l'ancien JavaScript.
- Si vous utilisez une version du plugin antérieure à 2.8.0, mettez à jour : les versions récentes corrigent un double comptage possible des achats dans GA4.
- Les autres causes fréquentes sont listées dans le [guide de dépannage](https://server-side.datafirefly.com/docs/troubleshooting.html).

Mise à jour : 1 septembre 2026
