# Installer le module PrestaShop

> Installer et configurer le module DataFirefly Server-Side sur PrestaShop 1.7.6 et plus : téléversement du zip, clé de connexion, consentement tarteaucitron.

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

---

Compatible PrestaShop 1.7.6 et versions supérieures. Installation en 5 minutes depuis le gestionnaire de modules. Une livraison échouée est mise en file et rejouée, les achats en premier : une panne passagère ne coûte rien.

## Prérequis

- PrestaShop 1.7.6 ou plus récent.
- Le zip du module, à 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. Back-office PrestaShop : **Modules > Gestionnaire de modules > Téléverser un module**.
2. Envoyez le zip tel quel, sans le dézipper.
3. Cliquez **Configurer**.

## Configuration

1. Renseignez **Tenant ID**, **HMAC secret** et **Events endpoint** : les trois valeurs de la page de votre site DataFirefly.
2. 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.
3. Passez **Enable tracking** à Yes : il est désactivé par défaut.
4. Enregistrez, puis cliquez **Send test event**.

Pas encore de bannière de consentement sur votre boutique ? Le module [Cookie Manager pour PrestaShop](https://www.datafirefly.com/product/cookie-manager-tarteaucitron-conformite-rgpd-cle-en-main-pour-prestashop/) installe tarteaucitron prêt à l'emploi, avec Consent Mode v2.

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

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

Mise à jour : 1 septembre 2026
