Prérequis
- Shopware 6.5, 6.6 ou 6.7.
- Le zip du plugin, à télécharger depuis la page Modules de votre espace client.
- La clé de connexion de votre site.
Installation
- Admin Shopware : Extensions > My extensions > Upload extension, puis installez et activez le plugin.
- Ou en CLI :
bin/console plugin:install --activate DatafireflyServerSide
Configuration
- Ouvrez la configuration du plugin et collez la clé de connexion
dfss_.... - Activez Enable tracking.
Le module reconnaît seul les outils de consentement courants (DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron), côté navigateur comme côté serveur, la même liste que les modules WooCommerce et PrestaShop. Laissez Consent cookie name vide pour cette détection automatique ; ne le remplissez que pour imposer un cookie précis (par exemple CookieConsent et marketing:true), qui devient alors prioritaire.
Vérifier
- Lancez
bin/console datafirefly:serverside:test. - L'événement de test doit apparaître en Delivered dans le Monitoring de votre espace client.
File de renvoi
Comportement des versions 1.23.0 et suivantes.
- Un envoi échoué est mis en file, puis rejoué toutes les 5 minutes par une tâche planifiée de Shopware.
- 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.
En cas de problème
- Journaux dans
var/log/, préfixe[DataFirefly SS]. - Si vous utilisez une version du plugin antérieure à 1.9.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.
Mise à jour : 1 septembre 2026