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 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.

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

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.

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.

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.