# Segmentazione Clienti RFM PrestaShop: documentazione
> Il modulo assegna a ogni cliente un punteggio da 1 a 5 su recenza, frequenza e valore dei suoi ordini, lo colloca in uno degli 11 segmenti RFM, calcola il…
- Pagina:
- Lingua: it
- Aggiornato il: 2026-09-24
- Altre lingue: [fr](https://www.datafirefly.com/documentation/dfrfmsegment/index.md), [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), [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)
- Indice:
Il modulo assegna a ogni cliente un punteggio da 1 a 5 su recenza, frequenza e valore dei suoi ordini, lo colloca in uno degli 11 segmenti RFM, calcola il suo rischio di abbandono e permette di lanciare campagne misurate con gruppo di controllo. Questa pagina copre l'installazione, le impostazioni e ogni schermata del modulo.
## Installazione
1. Nel back-office apri **Moduli > Gestione moduli** e clicca su **Carica un modulo**.
2. Carica il file ZIP `dfrfmsegment`. L'installazione crea le tabelle del modulo e tre voci nel menu **Clienti**: **Segmentazione RFM** (dashboard), **Punteggi RFM clienti** (lista) e **Campagne RFM**.
3. Apri **Clienti > Segmentazione RFM** e clicca su **Calcola i punteggi ora**. Il primo calcolo analizza tutto lo storico ordini: qualche secondo, fino a un minuto su basi molto grandi.
Compatibile con PrestaShop da 8.0 a 9.x con lo stesso ZIP. Per aggiornare da una versione precedente, carica semplicemente il nuovo ZIP: gli script di aggiornamento creano le nuove tabelle senza perdere i punteggi.
## Impostazioni
Le impostazioni si aprono dal pulsante **Configura** del modulo o dal pulsante **Impostazioni** della dashboard. I campi non pertinenti vengono nascosti in base alle scelte. Dopo una modifica, rilancia il calcolo per applicare i nuovi parametri.
### Origine dei dati
- **Periodo di analisi**: numero di mesi usati per frequenza e valore (24 di default, 0 per tutto lo storico). La recenza usa sempre l'ultimo ordine valido, anche se più vecchio.
- **Valore**: prodotti IVA esclusa meno sconti (default), totale pagato IVA esclusa o IVA inclusa. Gli importi sono convertiti nella valuta predefinita. Contano solo gli ordini validi.
- **Includi account ospite**: disattivato di default.
- **Aggiornamento in tempo reale**: ricalcola un cliente appena cambia lo stato di uno dei suoi ordini, con le soglie dell'ultimo calcolo completo.
- **Separatore CSV**: punto e virgola per Excel in Europa, virgola o tabulazione.
- **Finestra di monitoraggio campagne**: periodo in cui gli ordini contano nei risultati di una campagna (30 giorni di default).
- **Prefisso dei codici sconto**: ad esempio RFM dà codici come RFM-7KQ2M9XA.
### Punteggio da 1 a 5
Ogni dimensione funziona in modalità **automatica** (i clienti vengono divisi in cinque gruppi della stessa dimensione) o **manuale** (quattro soglie crescenti). Per la recenza, un cliente il cui ultimo ordine rientra nel primo valore ottiene 5. Per frequenza e valore, raggiungere il quarto valore dà 5. La frequenza è manuale di default (2, 3, 5, 10 ordini), perché la maggior parte dei clienti ha un solo ordine e i quintili dicono poco.
### Rischio di abbandono
Il rapporto di rischio divide i giorni dall'ultimo ordine per l'intervallo abituale tra due ordini del cliente. Per chi ha ordinato una sola volta, il modulo usa l'intervallo mediano di riacquisto del negozio. Di default il cliente passa a **Da monitorare** a 1,5, **A rischio di abbandono** a 2,5 e **Critico** a 4.
## Gli 11 segmenti
| Segmento | Profilo | Campagna consigliata |
| --- | --- | --- |
| Campioni | Acquisto recente, frequente, carrello alto | Accesso anticipato, vantaggi VIP, richiesta di recensioni e referral |
| Clienti fedeli | Acquistano regolarmente con un buon carrello | Premi fedeltà, upsell |
| Potenziali fedeli | Recenti, più di un ordine | Programma fedeltà, raccomandazioni personalizzate |
| Nuovi clienti | Primo ordine recente | Sequenza di benvenuto, incentivo al secondo ordine |
| Promettenti | Recenti, carrello piccolo | Contenuti del brand, soglia di spedizione gratuita |
| Da seguire | Clienti medi con ultimo ordine che inizia a essere lontano | Offerta a tempo basata sugli acquisti passati |
| In via di addormentarsi | Basso valore, attività in calo | Prodotti popolari, sconto moderato |
| A rischio | Compravano regolarmente, non tornano più | Email di riconquista personalizzata con offerta forte |
| Da non perdere | Ex migliori clienti che hanno smesso di ordinare | Contatto personale, sondaggio, offerta migliore |
| In letargo | Basso valore, ultimo ordine lontano | Riattivazione a basso costo, novità |
| Persi | Punteggi più bassi ovunque | Ultimo tentativo, poi esclusione dalle campagne a pagamento |
Un cliente con un solo ordine e una recenza di 4 o 5 viene sempre classificato come Nuovo cliente.
## Dashboard
**Clienti > Segmentazione RFM** riunisce lo stato completo della tua base. Una barra di navigazione porta a ogni sezione.
- **Indicatori**: clienti valutati e fatturato del periodo, quota di clienti abituali, fatturato a rischio, intervallo tipico di riacquisto.
- **Segmenti**: numero e quota di clienti, quota di fatturato, carrello medio, giorni medi dall'ultimo ordine, evoluzione della quota a 30 giorni, ingressi in 7 giorni. I pulsanti **Vedi** e **CSV** aprono o esportano il segmento.
- **Evoluzione dei segmenti**: quota di ogni segmento su 30, 90 o 365 giorni. Appare dopo due calcoli effettuati in giorni diversi.
- **Mappa recenza e valore**: righe = punteggio di recenza, colonne = media dei punteggi di frequenza e valore. Clicca su una cella per aprirne i clienti.
- **Rischio di abbandono**: clienti e fatturato per livello, con lista ed export.
- **Movimenti degli ultimi 30 giorni**: passaggi da un segmento all'altro, freccia verde per un miglioramento, rossa per un calo, export CSV per movimento.
- **Integrazioni**: stato dei gruppi clienti e dell'ultimo invio a Brevo o Klaviyo.
- **Buoni clienti abituali in calo**: i 10 clienti a rischio che pesano di più.
## Lista clienti e scheda cliente
**Clienti > Punteggi RFM clienti** mostra tutti i clienti valutati con segmento, segmento precedente, codice RFM, punteggi R e FM, giorni dall'ultimo ordine, ordini e fatturato del periodo, rischio e iscrizione alla newsletter. Ogni colonna si filtra e si ordina. Seleziona i clienti e scegli **Esporta la selezione in CSV** tra le azioni di gruppo.
Nella scheda di un cliente (**Clienti > Clienti > Visualizza**), il riquadro **Profilo RFM** mostra segmento, punteggi, rischio, intervallo abituale tra ordini, segmento precedente, ultima campagna e codice sconto, usato o no.
## Campagne
### Creare una campagna
1. Apri **Clienti > Campagne RFM**.
2. Parti da un modello (Riconquistare i clienti in calo, Secondo ordine dei nuovi clienti, Clienti fedeli in calo, Premiare i campioni, Riattivare i clienti dormienti) o componi il tuo pubblico: segmenti, segmento di provenienza, livello di rischio, cambio recente di segmento, consenso newsletter.
3. Il riepilogo a destra mostra in tempo reale il numero di clienti trovati, target e di controllo.
4. Clicca su **Crea e scarica il CSV**, oppure **Crea e invia a Brevo** o **Klaviyo** se l'integrazione è attiva. Si apre il report della campagna e il file viene scaricato.
Deseleziona **Monitora i risultati** per un semplice export una tantum, senza salvare la lista né misurare nulla.
### Gruppo di controllo
Il cursore **Gruppo di controllo** (da 0 a 50 %, 10 % di default) mette da parte una parte casuale della lista. Questi clienti non compaiono né nel CSV né nell'invio a Brevo o Klaviyo. Confrontare i loro acquisti con quelli dei clienti target dà l'effetto reale della campagna. Punta ad almeno 100 clienti di controllo per una conclusione affidabile.
### Buoni personali
Seleziona **Crea un buono personale per ogni cliente** e scegli il tipo (percentuale o importo), il valore, la validità, l'ordine minimo ed eventualmente la spedizione gratuita. Ogni cliente target riceve una regola carrello monouso riservata al suo account. Il codice è presente nel CSV e negli attributi inviati a Brevo o Klaviyo. Il limite è di 10.000 codici per campagna.
### Report di campagna
Il report confronta i clienti target e il gruppo di controllo sulla finestra di monitoraggio: conversione, ordini, fatturato IVA esclusa, fatturato per cliente, aumento in punti di conversione, fatturato aggiuntivo stimato e buoni usati. Un test su due proporzioni al 95 % indica se la differenza è significativa, e un messaggio riassume la conclusione. Eliminando una campagna si rimuovono i buoni non usati; quelli già usati restano per lo storico degli ordini.
## Gruppi clienti
Nelle impostazioni, sezione **Gruppi clienti**, attiva la sincronizzazione e associa un gruppo a ogni segmento, oppure clicca su **Crea un gruppo per segmento** per generare gli 11 gruppi "RFM - ..." con nome in ogni lingua. Un gruppo facoltativo può raccogliere tutti i clienti oltre un livello di rischio. La sincronizzazione viene eseguita dopo ogni calcolo completo e ogni aggiornamento in tempo reale.
Usa gruppi dedicati: i membri che non corrispondono più al segmento vengono rimossi. Il gruppo predefinito del cliente e i gruppi nativi Visitatore, Ospite e Cliente non vengono mai modificati. In PrestaShop i prezzi specifici per gruppo valgono solo per il gruppo predefinito: usa le regole carrello per gli sconti per segmento.
## Brevo e Klaviyo
### Brevo
1. Nelle impostazioni, sezione **Sincronizzazione email marketing**, scegli Brevo e incolla la tua chiave API (Brevo > SMTP e API > Chiavi API).
2. Clicca su **Verifica connessione**: vengono mostrate le tue liste Brevo con il loro ID. Inserisci l'ID della lista che riceverà i contatti.
3. Scegli gli attributi del nome: FIRSTNAME / LASTNAME, oppure PRENOM / NOM per i vecchi account francesi.
Attributi creati automaticamente: RFM_SEGMENT, RFM_CODE, RFM_CHURN_LEVEL, RFM_REVENUE, RFM_ORDERS, RFM_LAST_ORDER, RFM_PREV_SEGMENT, RFM_CAMPAIGN, RFM_VOUCHER e RFM_VOUCHER_END.
### Klaviyo
Scegli Klaviyo, incolla una chiave API privata con permessi di scrittura su Profiles e Lists e indica eventualmente l'ID di una lista. Proprietà inviate: 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 e rfm_voucher_expires.
### Come funziona l'invio
Vengono trasmessi solo i contatti i cui dati sono cambiati dall'ultimo invio. Di default partono solo gli iscritti alla newsletter. Il codice sconto viene inviato solo finché è utilizzabile. Crea poi segmenti dinamici nel tuo strumento, ad esempio RFM_SEGMENT uguale a `at_risk`, o RFM_CAMPAIGN uguale al nome della campagna. L'invio parte dal pulsante **Invia a** della dashboard, alla creazione di una campagna, o automaticamente dopo ogni cron se l'opzione è attiva. Il link **Reinvia tutti i contatti** forza un invio completo.
## Automatizzare il calcolo
Pianifica un calcolo giornaliero per mantenere aggiornati i punteggi e costruire lo storico. L'URL cron, con il suo token, è mostrato nella dashboard e nella pagina di configurazione. Funziona anche quando il negozio è in manutenzione. Esempio di attività cPanel alle 3 di notte:
```
0 3 * * * curl -s "https://www.il-tuo-negozio.it/index.php?fc=module&module=dfrfmsegment&controller=cron&token=IL_TUO_TOKEN" > /dev/null
```
Da riga di comando, nella radice di PrestaShop:
```
php modules/dfrfmsegment/cli.php
php modules/dfrfmsegment/cli.php --esp
php modules/dfrfmsegment/cli.php --esp-force
```
`--esp` invia i contatti modificati a Brevo o Klaviyo dopo il calcolo, `--esp-force` reinvia tutti i contatti.
## Colonne del file CSV
Le colonne mantengono nomi inglesi per essere associate una sola volta nel tuo strumento email: 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 e voucher_expires. Il file è in UTF-8 con BOM per aprirsi correttamente in Excel.
## Domande frequenti e risoluzione dei problemi
### Un cliente non compare nei punteggi
Non ha alcun ordine valido, è un account ospite con l'opzione disattivata, oppure il calcolo non è stato rilanciato dopo il suo ordine. In multinegozio verifica anche il contesto del negozio.
### Il grafico di evoluzione è vuoto
Servono almeno due calcoli effettuati in giorni diversi. Pianifica il cron giornaliero.
### Il test Brevo o Klaviyo non riesce
Verifica la chiave API e, per Klaviyo, i permessi di scrittura su Profiles e Lists. L'estensione PHP cURL deve essere attiva sul server. Il dettaglio dell'ultimo errore è mostrato nel pannello Integrazioni della dashboard.
### I gruppi clienti restano vuoti
Verifica che la sincronizzazione sia attiva e che ogni segmento abbia un gruppo associato, poi rilancia il calcolo. I gruppi Visitatore, Ospite e Cliente sono rifiutati di proposito.
### Disinstallazione
La disinstallazione elimina punteggi, storico e campagne. I gruppi clienti creati e le regole carrello già generate restano, perché possono essere usati nelle tue regole di prezzo o nei tuoi ordini.