# Segmentation Client RFM PrestaShop : documentation
> Le module note chaque client de 1 à 5 sur la récence, la fréquence et le montant de ses commandes, le place dans l'un des 11 segments RFM, calcule son…
- Page:
- Langue: fr
- Mis à jour le: 2026-09-24
- Autres langues: [en](https://www.datafirefly.com/en/documentation/dfrfmsegment/index.md), [es](https://www.datafirefly.com/es/documentation/dfrfmsegment/index.md), [de](https://www.datafirefly.com/de/documentation/dfrfmsegment/index.md), [it](https://www.datafirefly.com/it/documentation/dfrfmsegment/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfrfmsegment/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfrfmsegment/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfrfmsegment/index.md)
- Index:
Le module note chaque client de 1 à 5 sur la récence, la fréquence et le montant de ses commandes, le place dans l'un des 11 segments RFM, calcule son risque de perte et vous permet de lancer des campagnes mesurées avec groupe témoin. Cette page couvre l'installation, les réglages et chaque écran du module.
## Installation
1. Dans le back-office, ouvrez **Modules > Gestionnaire de modules** et cliquez sur **Installer un module**.
2. Envoyez le fichier ZIP `dfrfmsegment`. L'installation crée les tables du module et trois entrées dans le menu **Clients** : **Segmentation RFM** (tableau de bord), **Scores RFM clients** (liste) et **Campagnes RFM**.
3. Ouvrez **Clients > Segmentation RFM** et cliquez sur **Calculer les scores maintenant**. Le premier calcul analyse tout l'historique de commandes : quelques secondes, jusqu'à une minute sur une très grosse base.
Compatible PrestaShop 8.0 à 9.x avec le même ZIP. Pour une mise à jour depuis une version précédente, envoyez simplement le nouveau ZIP : les scripts de mise à jour créent les nouvelles tables sans perdre vos scores.
## Réglages
Les réglages s'ouvrent depuis le bouton **Configurer** du module ou le bouton **Réglages** du tableau de bord. Les champs sans objet se masquent selon vos choix. Après une modification, relancez le calcul pour appliquer les nouveaux paramètres.
### Source des données
- **Période d'analyse** : nombre de mois pris en compte pour la fréquence et le montant (24 par défaut, 0 pour tout l'historique). La récence utilise toujours la dernière commande valide, même plus ancienne.
- **Montant** : produits HT moins remises (défaut), total payé HT ou total payé TTC. Les montants sont convertis dans la devise par défaut. Seules les commandes valides comptent.
- **Inclure les comptes invités** : désactivé par défaut.
- **Mise à jour en temps réel** : recalcule un client dès qu'un statut de ses commandes change, avec les seuils du dernier calcul complet.
- **Séparateur CSV** : point-virgule pour Excel en Europe, virgule ou tabulation.
- **Fenêtre de suivi des campagnes** : durée pendant laquelle les commandes comptent dans les résultats d'une campagne (30 jours par défaut).
- **Préfixe des codes promo** : par exemple RFM donne des codes du type RFM-7KQ2M9XA.
### Notation de 1 à 5
Chaque dimension fonctionne en mode **automatique** (vos clients sont répartis en cinq groupes de même taille) ou **manuel** (quatre seuils croissants). En récence, un client dont la dernière commande date de moins que la première valeur obtient 5. En fréquence et en montant, atteindre la quatrième valeur donne 5. La fréquence est en manuel par défaut (2, 3, 5, 10 commandes), car la plupart des clients n'ont qu'une commande et les quintiles deviennent alors peu parlants.
### Risque de perte
Le ratio de risque divise les jours depuis la dernière commande par le délai habituel entre deux commandes du client. Pour un client d'une seule commande, le module utilise le délai médian de réachat de la boutique. Par défaut, le client passe **À surveiller** à 1,5, **À risque de perte** à 2,5 et **Critique** à 4.
## Les 11 segments
| Segment | Profil | Campagne recommandée |
| --- | --- | --- |
| Champions | Achat récent, fréquent, panier élevé | Accès anticipé, avantages VIP, demande d'avis et de parrainage |
| Clients fidèles | Achètent régulièrement avec un bon panier | Récompenses de fidélité, montée en gamme |
| Fidèles potentiels | Récents, plus d'une commande | Programme de fidélité, recommandations personnalisées |
| Nouveaux clients | Première commande récente | Séquence de bienvenue, incitation à la deuxième commande |
| Prometteurs | Récents, petit panier | Contenu de marque, seuil de livraison offerte |
| À relancer | Clients moyens dont la dernière commande commence à dater | Offre limitée basée sur les achats passés |
| En train de s'endormir | Faible valeur, activité en baisse | Produits populaires, remise modérée |
| À risque | Achetaient régulièrement, ne reviennent plus | E-mail de reconquête personnalisé avec une offre forte |
| À ne pas perdre | Anciens meilleurs clients qui ont cessé de commander | Contact personnel, questionnaire, meilleure offre |
| En hibernation | Faible valeur, dernière commande ancienne | Réactivation à faible coût, nouveautés |
| Perdus | Scores les plus bas partout | Dernière tentative, puis exclusion des campagnes payantes |
Un client d'une seule commande avec une récence de 4 ou 5 est toujours classé en Nouveaux clients.
## Tableau de bord
**Clients > Segmentation RFM** regroupe tout l'état de votre base. Une barre de navigation mène à chaque section.
- **Indicateurs** : clients notés et CA de la période, part de clients récurrents, CA à risque, délai de réachat typique.
- **Segments** : nombre et part de clients, part du CA, panier moyen, jours moyens depuis la dernière commande, évolution de la part sur 30 jours, entrées sur 7 jours. Les boutons **Voir** et **CSV** ouvrent ou exportent le segment.
- **Évolution des segments** : courbe de la part de chaque segment sur 30, 90 ou 365 jours. Elle apparaît après deux calculs faits des jours différents.
- **Carte récence et valeur** : lignes = score de récence, colonnes = moyenne des scores de fréquence et de montant. Cliquez sur une case pour ouvrir ses clients.
- **Risque de perte** : clients et CA par niveau, avec liste et export.
- **Mouvements des 30 derniers jours** : passages d'un segment à un autre, flèche verte pour une progression, rouge pour une baisse, export CSV par mouvement.
- **Intégrations** : état des groupes clients et du dernier envoi Brevo ou Klaviyo.
- **Bons clients récurrents en train de décrocher** : les 10 clients à risque qui pèsent le plus lourd.
## Liste des clients et fiche client
**Clients > Scores RFM clients** affiche tous les clients notés avec leur segment, segment précédent, code RFM, scores R et FM, jours depuis la dernière commande, commandes et CA de la période, risque et abonnement newsletter. Chaque colonne se filtre et se trie. Cochez des clients puis choisissez **Exporter la sélection en CSV** dans les actions groupées.
Sur la fiche d'un client (**Clients > Clients > Voir**), l'encart **Profil RFM** affiche son segment, ses scores, son risque, son délai habituel entre commandes, son segment précédent, sa dernière campagne et son code promo, utilisé ou non.
## Campagnes
### Créer une campagne
1. Ouvrez **Clients > Campagnes RFM**.
2. Partez d'un modèle (Reconquérir les clients qui décrochent, Deuxième commande des nouveaux clients, Fidèles en perte de vitesse, Récompenser les champions, Réveiller les clients endormis) ou composez votre cible : segments, segment d'origine, niveau de risque, changement récent de segment, consentement newsletter.
3. Le récapitulatif à droite affiche en direct le nombre de clients trouvés, ciblés et témoins.
4. Cliquez sur **Créer et télécharger le CSV**, ou **Créer et envoyer vers Brevo** ou **Klaviyo** si l'intégration est active. Le rapport de la campagne s'ouvre et le fichier se télécharge.
Décochez **Suivre les résultats** pour un simple export ponctuel, sans enregistrement de la liste ni mesure.
### Groupe témoin
Le curseur **Groupe témoin** (0 à 50 %, 10 % par défaut) met de côté une partie de la liste, tirée au hasard. Ces clients ne figurent ni dans le CSV ni dans l'envoi vers Brevo ou Klaviyo. Comparer leurs achats à ceux des clients ciblés donne l'effet réel de la campagne. Visez au moins 100 clients témoins pour une conclusion fiable.
### Codes promo personnels
Cochez **Créer un bon personnel pour chaque client** et choisissez le type (pourcentage ou montant), la valeur, la durée de validité, le minimum de commande et éventuellement la livraison offerte. Chaque client ciblé reçoit une règle panier à usage unique, réservée à son compte. Le code figure dans le CSV et dans les attributs envoyés à Brevo ou Klaviyo. La limite est de 10 000 codes par campagne.
### Rapport de campagne
Le rapport compare les clients ciblés et le groupe témoin sur la fenêtre de suivi : conversion, commandes, CA HT, CA par client, gain en points de conversion, CA supplémentaire estimé et codes utilisés. Un test de comparaison de deux proportions à 95 % indique si l'écart est significatif, et un message résume la conclusion. Supprimer une campagne retire ses codes non utilisés ; les codes déjà utilisés restent pour l'historique des commandes.
## Groupes clients
Dans les réglages, section **Groupes clients**, activez la synchronisation et associez un groupe à chaque segment, ou cliquez sur **Créer un groupe par segment** pour générer les 11 groupes « RFM - … » nommés dans chaque langue. Un groupe optionnel peut réunir tous les clients au-delà d'un niveau de risque. La synchronisation tourne après chaque calcul complet et chaque mise à jour en temps réel.
Utilisez des groupes dédiés : les membres qui ne correspondent plus au segment en sont retirés. Le groupe par défaut du client et les groupes natifs Visiteur, Invité et Client ne sont jamais modifiés. Dans PrestaShop, les prix spécifiques par groupe ne s'appliquent qu'au groupe par défaut : passez par des règles panier pour les remises par segment.
## Brevo et Klaviyo
### Brevo
1. Dans les réglages, section **Synchronisation e-mail marketing**, choisissez Brevo et collez votre clé API (Brevo > SMTP et API > Clés API).
2. Cliquez sur **Tester la connexion** : la liste de vos listes Brevo s'affiche avec leur ID. Saisissez l'ID de la liste qui recevra les contacts.
3. Choisissez les attributs de nom : FIRSTNAME / LASTNAME ou PRENOM / NOM pour les anciens comptes français.
Attributs créés automatiquement : RFM_SEGMENT, RFM_CODE, RFM_CHURN_LEVEL, RFM_REVENUE, RFM_ORDERS, RFM_LAST_ORDER, RFM_PREV_SEGMENT, RFM_CAMPAIGN, RFM_VOUCHER et RFM_VOUCHER_END.
### Klaviyo
Choisissez Klaviyo, collez une clé API privée disposant des droits Profiles et Lists en écriture, et indiquez éventuellement l'ID d'une liste. Propriétés envoyées : rfm_segment, rfm_code, rfm_r, rfm_f, rfm_m, rfm_churn_level, rfm_revenue, rfm_orders, rfm_last_order, rfm_previous_segment, rfm_campaign, rfm_voucher et rfm_voucher_expires.
### Fonctionnement de l'envoi
Seuls les contacts dont les données ont changé depuis le dernier envoi sont transmis. Par défaut, seuls les abonnés à la newsletter partent. Le code promo n'est envoyé que tant qu'il reste utilisable. Créez ensuite des segments dynamiques dans votre outil, par exemple RFM_SEGMENT égal à `at_risk`, ou RFM_CAMPAIGN égal au nom de la campagne. L'envoi se lance depuis le bouton **Envoyer vers** du tableau de bord, à la création d'une campagne, ou automatiquement après chaque cron si l'option est active. Le lien **Renvoyer tous les contacts** force un envoi complet.
## Automatiser le calcul
Programmez un calcul quotidien pour garder les scores à jour et construire l'historique. L'URL de cron, avec son jeton, s'affiche dans le tableau de bord et dans la page de configuration. Elle fonctionne aussi quand la boutique est en maintenance. Exemple de tâche cPanel à 3 h du matin :
```
0 3 * * * curl -s "https://www.votre-boutique.fr/index.php?fc=module&module=dfrfmsegment&controller=cron&token=VOTRE_JETON" > /dev/null
```
En ligne de commande depuis la racine de PrestaShop :
```
php modules/dfrfmsegment/cli.php
php modules/dfrfmsegment/cli.php --esp
php modules/dfrfmsegment/cli.php --esp-force
```
`--esp` envoie les contacts modifiés vers Brevo ou Klaviyo après le calcul, `--esp-force` renvoie tous les contacts.
## Colonnes du fichier CSV
Les colonnes gardent des noms anglais pour être associées une seule fois dans votre outil d'e-mailing : email, firstname, lastname, company, language, newsletter, optin, segment, segment_label, rfm_code, r_score, f_score, m_score, orders_total, orders_period, revenue_period, avg_basket, first_order, last_order, recency_days, churn_level, churn_label, churn_score, previous_segment, segment_changed_at, id_customer, campaign, voucher_code et voucher_expires. Le fichier est encodé en UTF-8 avec BOM pour s'ouvrir correctement dans Excel.
## Questions fréquentes et dépannage
### Un client n'apparaît pas dans les scores
Il n'a aucune commande valide, c'est un compte invité alors que l'option est désactivée, ou le calcul n'a pas été relancé depuis sa commande. Vérifiez aussi le contexte boutique en multiboutique.
### La courbe d'évolution est vide
Elle demande au moins deux calculs faits des jours différents. Programmez le cron quotidien.
### Le test Brevo ou Klaviyo échoue
Vérifiez la clé API et, pour Klaviyo, les droits Profiles et Lists en écriture. L'extension PHP cURL doit être active sur le serveur. Le détail de la dernière erreur s'affiche dans le panneau Intégrations du tableau de bord.
### Les groupes clients ne se remplissent pas
Vérifiez que la synchronisation est activée et que chaque segment est associé à un groupe, puis relancez le calcul. Les groupes Visiteur, Invité et Client sont refusés volontairement.
### Désinstallation
La désinstallation supprime les scores, l'historique et les campagnes. Les groupes clients créés et les règles panier déjà générées restent en place, car elles peuvent servir dans vos règles de prix ou vos commandes.