# Roue de la fortune & Pop-up Exit-Intent — Guide complet

> Présentation La Roue de la fortune & Pop-up Exit-Intent intercepte les visiteurs au moment précis où ils s'apprêtent à quitter votre boutique et leur propose un jeu : ils saisissent…

- Page: <https://www.datafirefly.com/documentation/dfexitwheel/>
- Langue: fr
- Mis à jour le: 2026-06-27
- Autres langues: [en](https://www.datafirefly.com/en/documentation/dfexitwheel/index.md), [es](https://www.datafirefly.com/es/documentation/dfexitwheel/index.md), [de](https://www.datafirefly.com/de/documentation/dfexitwheel/index.md), [it](https://www.datafirefly.com/it/documentation/dfexitwheel/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfexitwheel/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfexitwheel/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfexitwheel/index.md)
- Index: <https://www.datafirefly.com/documentation/llms.txt>

## Présentation

La **Roue de la fortune & Pop-up Exit-Intent** intercepte les visiteurs au moment précis où ils s'apprêtent à quitter votre boutique et leur propose un jeu : ils saisissent leur email, tournent la roue et repartent avec un coupon. Vous transformez un abandon silencieux en lead qualifié et, souvent, en commande immédiate.

La particularité du module est que **le lot gagnant est déterminé côté serveur** par un tirage pondéré. Les probabilités ne quittent jamais le navigateur : la roue ne fait qu'animer un résultat déjà décidé en PHP, ce qui rend tout truquage impossible côté client.

Le module est compatible PrestaShop 8.0 à 9.x, sans Composer ni dépendance externe. Tous les textes sont personnalisables et multilingues.

## Installation

1. Dans le back-office, ouvrez **Modules > Module Manager**.
2. Cliquez sur **Téléverser un module** et sélectionnez le fichier `dfexitwheel.zip`.
3. L'installation crée automatiquement trois tables (segments, leads, configuration), six segments par défaut et deux onglets d'administration.
4. Le module est actif immédiatement avec des valeurs par défaut fonctionnelles.

Aucun réglage n'est obligatoire pour démarrer : la roue fonctionne dès l'installation. Vous pouvez ensuite affiner les segments, les textes et les déclencheurs.

## Configuration générale

Depuis la page de configuration du module (**Configurer**), vous réglez :

- **Activer le module** : interrupteur général.
- **Titre, sous-titre, placeholder email, texte du bouton** : tous les libellés de la pop-up, par langue.
- **Texte de consentement (RGPD)** : la phrase affichée à côté de la case de consentement obligatoire.
- **Message de gain / de non-gain** : ce qui s'affiche après le tirage.
- **Couleur principale** : la couleur d'accent de la pop-up et de la roue.
- **Délai avant éligibilité** : temps minimum passé sur le site avant que la pop-up puisse se déclencher.
- **Fréquence (jours)** : durée pendant laquelle un visiteur ne reverra pas la pop-up.
- **Afficher aux clients connectés**, **Activer sur mobile**, **Minuteur mobile**.
- **Validité par défaut des coupons**, **Un seul jeu par email**, **Inscrire à la newsletter**.

Les champs de texte sont multilingues : utilisez le sélecteur de langue de chaque champ pour saisir une version par langue de la boutique.

## Gérer les segments de la roue

L'écran **Segments de la roue** liste les parts affichées. Pour chacune, vous définissez :

- **Libellé** : le texte inscrit sur la part (ex. « -10% », « Livraison offerte », « Dommage ! »).
- **Couleur** : la couleur de fond de la part.
- **Type de lot** : remise en pourcentage, remise en montant fixe, livraison offerte, ou aucun (non-gagnant).
- **Valeur** : le pourcentage ou le montant selon le type.
- **Poids** : la probabilité relative de tomber sur ce segment. Un poids élevé = segment fréquent.
- **Montant minimum** : panier minimum requis pour que le coupon s'applique.
- **Préfixe de code** et **validité (jours)** propres au segment.
- **Position** et **actif**.

### Comment fonctionne la pondération

Le tirage additionne les poids de tous les segments actifs puis sélectionne un segment proportionnellement à son poids. Exemple : avec des poids 25, 30, 20, 15, 8 et 2, le segment de poids 2 (le gros lot) sort environ 2 fois sur 100. Vous gardez ainsi un contrôle total sur la générosité de la roue.

Pour une roue rentable, gardez un ou deux segments « non-gagnants » ou à faible remise avec un poids élevé, et réservez les fortes remises à des poids faibles.

## Coupons et règles panier

À chaque gain, le module crée une **règle panier PrestaShop (CartRule) réellement unique** :

- Un seul usage au total et un seul par client.
- Une date d'expiration calculée depuis la validité du segment (ou la validité par défaut).
- Un montant minimum optionnel.
- Un code unique généré pour chaque gagnant.

Trois types de récompense sont possibles : **pourcentage**, **montant fixe** et **livraison offerte**. Le code est affiché au gagnant avec un bouton de copie et un lien pré-rempli vers la boutique.

Comme chaque code est nominatif et à usage unique, il ne peut pas être partagé ni revendu sur les sites de bons plans, contrairement à un code générique.

## Leads collectés et export CSV

L'écran **Leads collectés** recense chaque participation : email, segment obtenu, code coupon, consentement, date, langue et boutique. La liste est en lecture seule et propose un **export CSV** pour alimenter votre outil d'emailing.

Si l'option **Inscrire à la newsletter** est active, l'email est aussi ajouté aux abonnés natifs PrestaShop (table d'inscription newsletter) lorsque le consentement est donné.

## Déclenchement desktop et mobile

Sur **desktop**, la pop-up se déclenche par détection d'intention de sortie : quand le curseur remonte rapidement vers la barre d'onglets du navigateur.

Sur **mobile**, cet événement n'existe pas. Le module bascule alors automatiquement sur un **minuteur configurable** et sur la détection d'une remontée rapide de la page (scroll vers le haut).

Des garde-fous évitent toute insistance : un plafond de fréquence (la pop-up ne réapparaît pas avant X jours), un délai d'éligibilité avant le premier déclenchement possible, et l'arrêt définitif après un gain.

## Conformité RGPD

- La capture d'email exige une **case de consentement explicite** avec un texte que vous personnalisez.
- L'inscription à la newsletter est **optionnelle** et liée au même consentement.
- Les leads sont consultables et exportables, ce qui facilite les demandes d'accès et de suppression.

## Compatibilité technique

- **PrestaShop** : 8.0 à 9.x.
- **Hooks** : actionFrontControllerSetMedia (chargement des ressources et de la configuration front) et displayFooter (rendu de la pop-up).
- **Multiboutique** et **multilingue** pris en charge.
- **Coupons** : règles panier natives, sans table parallèle.
- Aucune dépendance Composer.

## FAQ

### Le client peut-il truquer la roue ?

Non. Le segment gagnant est calculé côté serveur avant l'animation. Le navigateur ne reçoit que l'index du résultat et ne connaît jamais les poids.

### Quels types de lots puis-je distribuer ?

Remise en pourcentage, remise en montant fixe, livraison offerte, ou segment non-gagnant. Chaque gain crée une règle panier unique.

### Est-ce compatible PrestaShop 9 ?

Oui, le module est conçu pour PrestaShop 8.0 jusqu'à 9.x sans adaptation.

## Dépannage

- **La pop-up ne s'affiche pas** : vérifiez que le module est activé, que le délai d'éligibilité est écoulé et que vous n'avez pas déjà joué (videz le stockage local du navigateur pour tester à nouveau).
- **La pop-up ne réapparaît pas** : c'est volontaire après un gain ou pendant la fenêtre de fréquence. Réinitialisez le stockage local pour forcer un nouvel affichage.
- **Le coupon ne s'applique pas** : contrôlez le montant minimum du segment et la date d'expiration.
- **Les champs de texte semblent vides en configuration** : assurez-vous d'utiliser la dernière version du module (l'affichage multilingue des champs a été corrigé en 1.0.0).
