Prérequis
- PrestaShop 1.7.6 ou plus récent.
- Le zip du module, à télécharger depuis la page Modules de votre espace client.
- La clé de connexion de votre site.
Installation
- Back-office PrestaShop : Modules > Gestionnaire de modules > Téléverser un module.
- Envoyez le zip tel quel, sans le dézipper.
- Cliquez Configurer.
Configuration
- Renseignez Tenant ID, HMAC secret et Events endpoint : les trois valeurs de la page de votre site DataFirefly.
- Option Require consent : le module ne laisse partir un événement que si le visiteur a accepté la publicité. Il reconnaît seul, sans réglage : tarteaucitron, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, côté navigateur comme côté serveur, la même liste que les modules WooCommerce et Shopware. Recommandé si votre boutique a une bannière de consentement.
- Passez Enable tracking à Yes : il est désactivé par défaut.
- Enregistrez, puis cliquez Send test event.
Pas encore de bannière de consentement sur votre boutique ? Le module Cookie Manager pour PrestaShop installe tarteaucitron prêt à l'emploi, avec Consent Mode v2.
Vérifier
- L'événement de test doit apparaître en Delivered dans le Monitoring de votre espace client.
- Passez une commande de test : le module envoie les achats à la validation de commande.
File de renvoi
Comportement des versions 1.29.0 et suivantes.
- Un envoi échoué est mis en file, puis rejoué au fil des visites de la boutique : au plus toutes les 30 secondes, jamais deux rejeux à la fois, par lots de 20 événements maximum envoyés en parallèle.
- Boutique peu visitée : une URL de cron facultative, protégée par un jeton et accessible en https uniquement, déclenche le rejeu sans attendre une visite.
- 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 : Paramètres avancés > Logs, filtrez sur le préfixe
[DataFirefly SS]. - Si vous utilisez une version du module antérieure à 1.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.
Mise à jour : 1 septembre 2026