DataFirefly Fedeltà e Presenta un amico: raccolta punti, livelli e inviti per PrestaShop

Installazione

Installa il modulo da Moduli > Gestione moduli > Carica un modulo inviando il file ZIP, oppure copia la cartella dfloyalty nella directory /modules/ del negozio e clicca su Installa.

All’installazione il modulo crea le sue tabelle, salva le impostazioni predefinite, crea quattro livelli di status (Bronzo, Argento, Oro, Platino) e aggiunge la scheda Clienti > Fedeltà e Presenta un amico. Il pulsante Configura di Gestione moduli apre direttamente le impostazioni.

Prime impostazioni

Le impostazioni sono raggruppate in sezioni, raggiungibili dal menu a sinistra. Prima di aprire il programma ai clienti, controlla almeno:

• Punti per unità di valuta spesa: 1 per impostazione predefinita, cioè 1 punto per euro. Sono ammessi i decimali (0,5 = 1 punto ogni 2 euro).
• Stati dell’ordine che confermano i punti: per impostazione predefinita pagamento accettato, spedito e consegnato.
• Tasso di conversione: 100 punti = 5 € per impostazione predefinita. Il riquadro a sinistra calcola in tempo reale la percentuale restituita ai clienti una volta convertiti i punti.
• Premi per gli inviti: 10 € all’amico e 500 punti a chi invita per impostazione predefinita.

Accumulo dei punti

Calcolo

I punti sono calcolati sulle righe prodotto dell’ordine, nella valuta del cliente e poi convertiti nella valuta predefinita. Le spese di spedizione non generano mai punti. Tre opzioni regolano la base:

• Calcola sui prezzi IVA inclusa: disattivala per calcolare sui prezzi IVA esclusa.
• Sottrai buoni e sconti: le regole carrello dell’ordine (esclusa la spedizione gratuita) vengono tolte dalla base in proporzione.
• Nessun punto sui prodotti già in promozione: i prodotti venduti con una riduzione sono esclusi.

Poi si applicano il moltiplicatore del livello del cliente e i punti bonus del prodotto. Il risultato è arrotondato per difetto.

Ciclo di vita dei punti

• Alla convalida dell’ordine i punti vengono registrati in attesa. Il cliente li vede nell’account ma non può usarli.
• Quando l’ordine raggiunge uno degli stati che confermano i punti, diventano disponibili.
• Quando l’ordine passa a uno degli stati che annullano i punti, vengono tolti, in attesa o disponibili che siano.
• Una nota di credito parziale toglie la quota di punti corrispondente all’importo dei prodotti rimborsati.
• Se un ordine annullato torna a uno stato di conferma, i punti tornano.

Ogni movimento è registrato in uno storico che non viene mai riscritto: si aggiunge una riga di correzione invece di modificarne una esistente.

Punti alla registrazione

L’impostazione Punti offerti alla registrazione accredita un numero fisso di punti a ogni creazione di account cliente (non agli ordini come ospite). Lascia 0 per disattivarla.

Livelli di status

La scheda Livelli elenca i livelli in ordine di soglia. Ogni livello ha un nome e un testo dei vantaggi traducibili, una soglia in punti status, un moltiplicatore di punti e un colore, usato per la carta membro del cliente.

I punti status sono i punti guadagnati meno annullamenti e rimborsi. Convertire i punti in buoni o lasciarli scadere non abbassa lo status. L’impostazione Periodo dello status limita il calcolo agli ultimi N mesi; lascia 0 per contare dalla registrazione.

Il primo livello deve avere soglia 0, così ogni cliente ha uno status fin dal primo ordine. Quando un cliente raggiunge un nuovo livello, vede un messaggio di congratulazioni alla visita successiva della pagina fedeltà.

Gruppo clienti del livello

Nella scheda di un livello, il campo Gruppo clienti di questo livello collega il livello a un gruppo PrestaShop. Il modulo aggiunge a quel gruppo i clienti che raggiungono il livello e li rimuove quando lo lasciano. Configura sul gruppo una riduzione (Clienti > Gruppi), una regola carrello di spedizione gratuita riservata al gruppo o prezzi specifici: il vantaggio si applica senza interventi.

• Crea un gruppo dedicato a ogni livello. Un cliente inserito a mano in quel gruppo verrebbe rimosso se non ha il livello.
• Il gruppo predefinito del cliente non viene mai modificato.
• La sincronizzazione avviene a ogni movimento di punti, al salvataggio di un livello e ogni giorno con l’attività pianificata.

Punti bonus sui prodotti

La scheda Prodotti bonus permette di dare più punti su prodotti specifici. Cerca il prodotto per nome o riferimento e scegli:

• Moltiplicatore: 2 raddoppia i punti di questo prodotto.
• Punti fissi per articolo: un numero di punti aggiunto per ogni unità, oltre ai punti standard.

Le date di inizio e fine sono facoltative. Senza date il bonus è permanente. La scheda prodotto mostra un badge (x2, +50) e i punti da guadagnare, ricalcolati quando il cliente cambia la quantità. Il bonus si somma al moltiplicatore del livello.

Conversione in buoni sconto

Dall’account cliente

Nella scheda Premi della pagina fedeltà, il cliente sceglie con un cursore quanti punti convertire, per multipli del numero di punti del tasso di conversione. Ottiene un buono personale con codice DFPTS-XXXXXXXX, mostrato in una finestra con pulsante di copia e, se l’opzione è attiva, inviato via e-mail.

Direttamente nel carrello

Se l’opzione Permetti ai clienti di usare i punti direttamente nel carrello è attiva, il blocco fedeltà del carrello mostra un cursore. Il buono viene creato e applicato con un clic, senza superare il totale dei prodotti. Da questo blocco si può applicare un solo buono punti per carrello. Anche i buoni già generati e non usati compaiono con un pulsante Applica.

Impostazioni dei buoni

• Punti minimi da convertire: sotto questa soglia il cliente vede una barra di avanzamento verso il primo buono.
• Validità del buono: in giorni, 365 per impostazione predefinita.
• Carrello minimo per usarlo: 0 per nessun minimo.
• Cumulabilità con altre regole carrello: disattivala se i buoni fedeltà non devono sommarsi ai tuoi codici promozionali.

I buoni sono regole carrello standard di PrestaShop, visibili in Catalogo > Sconti, assegnate al cliente e monouso.

Presenta un amico

Il link di chi invita

Ogni cliente ha un codice e un link di invito (parametro ?dfref=CODICE sulla home page), visibili nella scheda Presenta un amico della pagina fedeltà. Può copiare il link, condividerlo via WhatsApp, e-mail, Facebook o X o con la condivisione nativa del telefono, e inviare inviti via e-mail dal modulo apposito.

L’arrivo dell’amico

Il visitatore che clicca sul link viene memorizzato per la durata impostata in Memoria del link (30 giorni per impostazione predefinita). Un banner discreto gli presenta il regalo e un messaggio lo accompagna nel modulo di registrazione. Alla creazione dell’account, anche durante il checkout:

• se il premio dell’amico è un importo o una percentuale, viene creato un buono senza codice e aggiunto automaticamente al carrello, con l’acquisto minimo e la validità impostati;
• se è un numero di punti, vengono accreditati alla convalida del primo ordine.

Codice inserito alla registrazione

Con l’opzione Aggiungi un campo facoltativo «Codice invito» al modulo di registrazione, un amico che ha ricevuto il codice a voce può inserirlo quando crea l’account. Un codice sconosciuto viene rifiutato con un messaggio di errore. Il campo non compare se il visitatore è già arrivato da un link di invito.

Il premio di chi invita

Chi invita viene premiato quando il primo ordine dell’amico raggiunge uno stato che conferma i punti e il totale prodotti IVA inclusa raggiunge il Primo ordine minimo dell’amico. Riceve punti o un buono con codice DFREF-XXXXXXXX, più un’e-mail di ringraziamento.

Protezioni

• Un cliente non può presentare sé stesso, nemmeno con lo stesso indirizzo e-mail.
• Un indirizzo e-mail che ha già ordinato nel negozio non viene collegato a chi invita.
• Conta solo il primo ordine convalidato dell’amico. Se è sotto il minimo, l’invito diventa Non idoneo.
• Gli inviti via e-mail hanno un limite giornaliero per cliente e lo stesso indirizzo non può essere invitato due volte in 7 giorni.

Stati di un invito

Invitato: e-mail inviata dal cliente. Registrato: account creato con il link. Ricompensato: primo ordine convalidato, premi assegnati. Non idoneo: primo ordine sotto il minimo.

Scadenza e attività pianificata

L’impostazione Scadenza dopo inattività fa scadere il saldo di un cliente quando non ha guadagnato punti per il numero di mesi indicato. Ogni ordine sposta la scadenza e il cliente la vede nel suo account. Lascia 0 perché i punti non scadano mai.

La scadenza viene applicata quando il cliente apre la pagina fedeltà e dall’attività giornaliera il cui URL si trova in Impostazioni > Manutenzione. Pianificala una volta al giorno nel tuo gestore cron o in un modulo cron di PrestaShop. Invia anche i promemoria di scadenza, accredita i punti compleanno e aggiorna i gruppi dei livelli. Il pulsante Esegui ora l’attività giornaliera nella scheda Manutenzione fa la stessa cosa.

L’impostazione Promemoria prima della scadenza (30 giorni per impostazione predefinita) invia al cliente un’e-mail con il saldo, il suo valore e la data di scadenza. Viene inviato un solo promemoria per scadenza; se nel frattempo il cliente ordina, la data cambia e un nuovo promemoria partirà al momento giusto.

Aggiungi &resync=1 all’URL per rielaborare anche gli stati degli ordini degli ultimi 7 giorni.

Compleanno, newsletter e campagne

Punti compleanno

L’impostazione Punti compleanno accredita punti una volta all’anno nella data di nascita indicata nell’account cliente, con un’e-mail di auguri. L’accredito avviene con l’attività giornaliera e anche al login del cliente o all’apertura della sua pagina fedeltà. I clienti nati il 29 febbraio li ricevono il 28 negli anni non bisestili. Per impostazione predefinita ne beneficiano solo i clienti con un ordine convalidato, per evitare account creati solo per il regalo.

Punti per l’iscrizione alla newsletter

L’impostazione Punti per l’iscrizione alla newsletter accredita punti una sola volta per cliente: alla registrazione se la casella newsletter è selezionata, con un’iscrizione successiva dall’account, oppure dal blocco newsletter del piè di pagina per un indirizzo che corrisponde a un account cliente. Gli iscritti precedenti all’attivazione dell’opzione non ricevono accrediti retroattivi.

Campagne punti

La sezione Campagna punti moltiplica tutti i punti guadagnati tra due date: 2 per punti doppi. Il moltiplicatore si aggiunge a quello del livello e ai bonus prodotto. Durante la campagna un badge compare nelle schede prodotto, nel blocco carrello e nella pagina fedeltà. Fa fede la data dell’ordine: un ordine effettuato durante la campagna mantiene i punti maggiorati anche se viene convalidato dopo la fine.

Escludere gruppi di clienti

In Impostazioni > Generale, seleziona i gruppi di clienti esclusi dal programma, per esempio account professionali o personale. Un cliente di uno di questi gruppi non guadagna punti, non vede né il riquadro, né la pagina fedeltà, né i blocchi prodotto e carrello, e il suo link di invito non genera premi.

Cosa vede il cliente

• Il mio account: un riquadro con il nome del programma e il saldo, e un link nel blocco Il mio account del footer.
• Pagina fedeltà: carta membro nei colori del livello, avanzamento, schede Premi, Presenta un amico, Storico e Status.
• Scheda prodotto: punti da guadagnare, valore in euro, badge bonus. Opzione Mostra i punti da guadagnare nelle schede prodotto.
• Carrello: punti dell’ordine, saldo, uso dei punti e buoni disponibili. Opzione Mostra il blocco punti nel carrello. Il blocco si aggiorna a ogni modifica del carrello.
• Conferma d’ordine: punti guadagnati, in attesa o già accreditati.

Back office

Dashboard

Punti in circolazione e il loro valore (la passività rappresentata dai saldi), punti in attesa, numero di membri, punti guadagnati e convertiti negli ultimi 30 giorni con grafico, membri per livello, buoni creati e usati, funnel degli inviti, migliori presentatori e attività recente.

Membri e scheda membro

La scheda Membri elenca i clienti con punti, ordinati per saldo. La ricerca copre nome, e-mail, ID cliente o codice invito e include i clienti senza punti, così puoi accreditarli. La scheda membro mostra saldo, livello, storico, buoni e amici presentati, e consente una rettifica manuale: inserisci un numero positivo o negativo e un motivo, che il cliente vedrà nel suo storico.

Anche la scheda cliente nativa di PrestaShop mostra un riquadro con saldo, livello, codice invito e un link alla scheda membro.

Pagina ordine ed esportazioni

Nella pagina di un ordine del back office, un riquadro mostra i punti dell’ordine e il loro stato, i bonus e i moltiplicatori applicati, i buoni fedeltà usati e se si tratta del primo ordine di un cliente presentato. La scheda Membri offre due esportazioni CSV: l’elenco dei membri (saldo, livello, punti status, codice invito) e tutti i movimenti di punti. I file si aprono direttamente in Excel o LibreOffice.

E-mail

Il modulo invia sei e-mail nella lingua del destinatario: l’invito di un amico, il regalo di benvenuto dell’amico, il premio di chi invita, il buono creato dai punti, gli auguri di compleanno e il promemoria di scadenza. Usano un unico modello nel colore principale con il logo del negozio. I testi provengono dalle traduzioni del modulo, il modello si trova in mails/.

Dati e disinstallazione

Per impostazione predefinita l’opzione Conserva saldi e impostazioni alla disinstallazione del modulo è attiva: disinstallare e reinstallare non fa perdere nulla. Disattivala prima di disinstallare se vuoi eliminare tutti i dati. Quando un cliente viene eliminato in PrestaShop, i suoi punti, buoni registrati e inviti vengono eliminati con lui.

Il modulo è compatibile con il modulo GDPR ufficiale di PrestaShop: l’esportazione dei dati di un cliente include lo storico punti e il codice invito, e la cancellazione di un cliente da quel modulo elimina i suoi dati fedeltà.

Risoluzione dei problemi

I punti restano in attesa

Verifica che lo stato attuale dell’ordine sia selezionato in Stati dell’ordine che confermano i punti. Se un dipendente ha cambiato lo stato e il suo profilo non ha il permesso Visualizza sul modulo (Parametri avanzati > Team > Permessi), PrestaShop non ha eseguito il modulo: usa Risincronizza gli ordini degli ultimi 90 giorni in Impostazioni > Manutenzione. L’operazione si può ripetere senza rischio di doppio accredito.

Il blocco fedeltà non compare nel carrello

Il blocco è visualizzato tramite l’hook displayShoppingCart, presente nel tema Classic. Se il tuo tema non lo richiama, aggiungi {hook h='displayShoppingCart'} al template del carrello, oppure contattaci indicando il tema.

Il banner degli inviti non compare

Viene mostrato solo ai visitatori non connessi arrivati da un link valido e resta nascosto per 3 giorni dopo la chiusura. Prova in una finestra di navigazione privata.

Alcuni testi restano in inglese

Il modulo è fornito in 8 lingue. Per un’altra lingua, o per modificare un testo, usa Internazionale > Traduzioni > Traduzioni dei moduli installati.

Compatibilità

• PrestaShop da 8.0 a 9.x, lo stesso ZIP copre entrambe le versioni.
• Multilingua e multivaluta. In multinegozio il saldo di un cliente è comune a tutti i negozi.
• Architettura ModuleAdminController, senza dipendenze Composer.
• Modulo ed e-mail tradotti in inglese, francese, spagnolo, tedesco, italiano, olandese, polacco e portoghese.