PS PrestaShop Principiante

Coupon di compleanno: documentazione del modulo PrestaShop

Installare il modulo, configurare le campagne di compleanno, pianificare l'invio giornaliero e leggere il fatturato generato.

Aggiornato Versione del modulo 2.0.2

Presentazione

Il modulo invia automaticamente ai tuoi clienti un codice sconto personale in tre occasioni: il loro compleanno, l’anniversario del primo ordine valido e l’anniversario della creazione dell’account. Ogni codice è una regola carrello nativa di PrestaShop, riservata al cliente e utilizzabile una sola volta. Il modulo misura poi il fatturato degli ordini effettuati con questi codici.

Compatibilità: PrestaShop da 1.7.8 a 9.x (PHP da 7.4 a 8.5), temi Classic e Hummingbird, multinegozio, 8 lingue (inglese, francese, spagnolo, tedesco, italiano, olandese, polacco, portoghese).

Novità della versione 2.0.2: messaggio delle e-mail formattato con l’editor di PrestaShop, o scritto direttamente in HTML.

Novità della versione 2.0.1: scelta dei prodotti interessati da ogni campagna (tutto il catalogo, solo alcuni prodotti e categorie, oppure tutto tranne alcuni), indicata al cliente nell’e-mail.

Novità della versione 2.0.0: procedura guidata, calendario delle date speciali, anteprima reale delle e-mail (computer e mobile), simulazione di un giorno a scelta, pausa degli invii, indirizzo delle e-mail di prova a scelta, link di disiscrizione senza accesso in ogni e-mail, eliminazione della data di nascita da parte del cliente, date scritte per esteso nella lingua del cliente, compatibilità con PrestaShop 1.7.8 e Hummingbird. La 2.0.0 corregge anche il salvataggio delle impostazioni del back office e i filtri su PrestaShop 9.

Installazione

  1. In Moduli > Gestione moduli, clicca su Carica un modulo e invia il file ZIP.
  2. Il modulo crea due tabelle, registra i suoi hook, genera il token dell’attività pianificata e copia i modelli e-mail per ogni lingua installata.
  3. Nel menu Clienti compare la nuova scheda Compleanni e date speciali. Anche il pulsante Configura del modulo porta lì.

Per passare da una versione 1.x alla 2.0.2 basta caricare il nuovo ZIP. Campagne, testi, storico dei codici e statistiche vengono conservati; un negozio che non aveva mai salvato le campagne mantiene attive le campagne compleanno e primo ordine, come nella 1.x.

La procedura guidata

In una nuova installazione nessuna campagna è attiva: ai tuoi clienti non viene inviato nulla finché non clicchi su Attiva le mie campagne. La dashboard mostra una procedura in tre passaggi: scegliere le ricorrenze e il relativo sconto, scegliere l’automazione (attività pianificata e riserva sulle visite, richiesta della data di nascita dopo l’ordine), poi indicare l’indirizzo delle e-mail di prova e attivare. Il link Salta, configurerò manualmente porta direttamente alla scheda Campagne.

Procedura guidata: scelta delle ricorrenze e delle offerte, automazione, test e attivazione
Procedura guidata: scelta delle ricorrenze e delle offerte, automazione, test e attivazione

In seguito, la dashboard mostra la checklist «Per iniziare» finché non sono completati i quattro passaggi essenziali: attivare una campagna, inviarti un’e-mail di prova, pianificare l’attività giornaliera e raccogliere le date di nascita.

Configurare le campagne

La scheda Campagne contiene una scheda per occasione. Attivala con l’interruttore in alto a destra: compaiono le impostazioni e l’anteprima dell’e-mail.

L’offerta

  • Tipo di sconto: percentuale, importo fisso (nella valuta predefinita) o spedizione gratuita.
  • Valore e Offri anche la spedizione gratuita in aggiunta a una percentuale o a un importo.
  • Ordine minimo (IVA incl.): 0 per nessun minimo.
  • Validità dopo la data: giorni di validità del codice dalla data dell’occasione.
  • Invia in anticipo: numero di giorni prima della data. 0 invia il giorno stesso.
  • Aumento per ogni anno in più e Valore massimo (anniversari di ordine e di account): ad esempio 10 % il primo anno, +2 all’anno, fino a un massimo del 20 %.
  • Escludi i prodotti già in saldo e Cumulabile con altri buoni sconto.

Prodotti interessati

Per impostazione predefinita il codice vale su Tutto il catalogo. Scegli Solo alcuni prodotti o Tutto tranne alcuni prodotti, poi aggiungi categorie (sottocategorie incluse) e prodotti cercandoli per nome, riferimento o ID. Il numero di prodotti interessati compare sotto la selezione, e l’e-mail indica al cliente su quali prodotti il codice è valido.

  • Percentuale: lo sconto si applica solo ai prodotti interessati; gli altri prodotti del carrello mantengono il loro prezzo.
  • Importo fisso o spedizione gratuita: il codice è accettato appena il carrello contiene almeno un prodotto interessato.
  • Con Tutto tranne alcuni prodotti, o con categorie e prodotti insieme, l’elenco dei prodotti viene fissato all’invio del codice: un prodotto aggiunto in seguito al catalogo non è coperto dai codici già inviati.

Su PrestaShop 1.7 la percentuale di una selezione è calcolata sul prezzo prima degli sconti propri del prodotto. Seleziona Escludi i prodotti già in saldo perché un prodotto in saldo non cumuli i due sconti.

Chi lo riceve

  • Numero minimo di ordini validi: 0 per il compleanno include i clienti che non hanno mai ordinato.
  • Prefisso del codice: ad esempio BDAY genera codici come BDAY-7KQ2M9.
  • Gruppi di clienti: nessuno selezionato significa tutti i gruppi.

L’e-mail

Modifica oggetto, titolo e messaggio per ogni lingua con le schede lingua. L’anteprima a destra mostra il vero modello di e-mail, così come lo riceverà il cliente, con lo sconto reale; si aggiorna durante la digitazione e passa alla larghezza mobile con l’icona del telefono. I pulsanti dei tag inseriscono il tag nella posizione del cursore. Tag disponibili: {firstname}, {lastname}, {discount}, {code}, {expiry_date}, {min_amount}, {years} (tranne il compleanno) e {shop_name}. Un campo vuoto riprende il testo predefinito della lingua.

Il pulsante Salva e invia un test invia l’e-mail, nella lingua del dipendente, all’indirizzo indicato nel campo Le e-mail di prova vengono inviate a in alto nella scheda (per impostazione predefinita quello del dipendente connesso).

Il Messaggio si scrive con l’editor di PrestaShop: grassetto, colori, elenchi, link, tabelle, titoli e immagini del file manager. Il pulsante <> permette di scrivere o incollare HTML. Al salvataggio il modulo rimuove ciò che costituisce un rischio in un’e-mail (script, moduli, frame incorporati, link javascript:), rende assoluti link e immagini e genera la versione testo dell’e-mail. I tag si inseriscono nel punto del cursore e funzionano anche nell’HTML. Un messaggio salvato prima della 2.0.2 resta in testo semplice e viene inviato come prima.

Campagna compleanno: offerta, target per gruppo, testi in 8 lingue e anteprima reale dell'e-mail
Campagna compleanno: offerta, target per gruppo, testi in 8 lingue e anteprima reale dell’e-mail

Il calendario delle date speciali

La scheda Calendario mostra il mese con, per ogni giorno, il numero di clienti che festeggiano un compleanno, un anniversario del primo ordine o un anniversario dell’account. Applica gli stessi filtri dell’invio: gruppi, numero minimo di ordini, ospiti, iscritti alla newsletter e clienti disiscritti. Clicca su un giorno per vedere l’elenco dei clienti con la loro offerta e lo stato del codice: previsto (con la data di invio se l’invio è anticipato), codice inviato, usato o non inviato. Il pulsante Simula avvia la simulazione di quel giorno. Il periodo di attesa dopo una modifica della data di nascita viene verificato il giorno dell’invio.

Calendario delle date speciali: compleanni e anniversari per giorno, clienti del giorno e stato dei codici
Calendario delle date speciali: compleanni e anniversari per giorno, clienti del giorno e stato dei codici

Pianificare l’invio giornaliero

In Automazione e impostazioni, copia l’URL dell’attività pianificata e richiamalo una volta al giorno, idealmente al mattino presto. Esempio di riga cron:

0 7 * * * curl -s "https://tuo-negozio.it/module/dfkeydates/cron?token=IL_TUO_TOKEN" >/dev/null

Ogni esecuzione crea i codici del giorno, invia le e-mail e i promemoria, collega i codici utilizzati al loro ordine ed elimina i codici scaduti non utilizzati.

  • Recupero dei giorni mancati (2 per impostazione predefinita): se l’attività non è stata eseguita, vengono elaborate le date dei giorni precedenti.
  • Codici massimi per esecuzione (200 per impostazione predefinita): il resto viene inviato all’esecuzione successiva.
  • Esegui anche durante le visite: senza cron, il modulo si esegue sulle visite al negozio, al massimo una volta all’ora, dopo l’invio della pagina. Si ferma appena è stato richiamato un cron reale nelle ultime 26 ore.

Nella stessa pagina, Simula mostra i codici che partirebbero nel giorno scelto nel campo Giorno da simulare, senza creare né inviare nulla. I pulsanti Esegui ora, Risincronizza i codici utilizzati e Nuovo token completano la scheda, che indica anche se l’attività pianificata è stata rilevata e il fuso orario del negozio: le date seguono il fuso impostato in Internazionale > Localizzazione, non quello del server.

Sospendi l’invio fino al mette in pausa gli invii durante una chiusura o le ferie. Un avviso lo ricorda in tutte le schede. Le date mancate durante la pausa vengono recuperate entro il limite di recupero.

Ogni cliente riceve al massimo un codice per occasione e per anno. Puoi quindi avviare l’attività più volte senza rischio di duplicati.

Simulazione di un giorno a scelta e attività pianificata: URL cron, ultima esecuzione e fuso orario del negozio
Simulazione di un giorno a scelta e attività pianificata: URL cron, ultima esecuzione e fuso orario del negozio

Anti-abuso e raccolta delle date di nascita

Il periodo di attesa dopo la registrazione o la modifica del compleanno (30 giorni per impostazione predefinita) blocca il codice di compleanno per un account troppo recente o la cui data è appena stata inserita o modificata nel negozio. Le modifiche fatte da un dipendente nel back office non attivano questo periodo.

Le date di nascita provengono dal campo nativo dell’account cliente (Clienti > Impostazioni > Data di nascita). Se il campo è disattivato, il modulo le raccoglie da solo:

  • nella pagina di conferma ordine, quando la data non è nota (opzione Chiedere la data di nascita nella pagina di conferma ordine se non è nota);
  • nella pagina I miei regali e date speciali dell’account cliente.

La dashboard mostra la percentuale di account con data nota. Nella pagina di conferma ordine la data viene salvata senza lasciare la pagina; la richiesta precisa che è facoltativa e serve solo per il regalo di compleanno. Non viene proposta a un cliente che si è disiscritto da queste e-mail.

Conferma d'ordine: richiesta facoltativa della data di nascita, salvata senza lasciare la pagina
Conferma d’ordine: richiesta facoltativa della data di nascita, salvata senza lasciare la pagina

Promemoria prima della scadenza

Attiva il promemoria e scegli quanti giorni prima della scadenza viene inviato. Parte solo se il codice non è stato utilizzato. I testi del promemoria e il testo del pulsante di tutte le e-mail si impostano per lingua. Il pulsante Invia un promemoria di prova salva le impostazioni e ti invia un esempio.

Regole di invio, pausa degli invii e promemoria prima della scadenza con anteprima dell'e-mail
Regole di invio, pausa degli invii e promemoria prima della scadenza con anteprima dell’e-mail

Codice in un clic

Il pulsante di ogni e-mail punta a un link firmato proprio del codice. Il modulo memorizza il codice e lo aggiunge al carrello appena il cliente ha effettuato l’accesso e ha prodotti nel carrello. Se il cliente non ha effettuato l’accesso, viene indirizzato alla pagina di login. Se l’ordine minimo non è raggiunto, il codice resta in attesa e si applica appena lo è. Un codice scaduto, già utilizzato o destinato a un altro cliente viene rifiutato con un messaggio.

Le date delle e-mail sono scritte per esteso nella lingua del cliente (ad esempio «4 dicembre 2026»). Ogni e-mail contiene un link Gestisci le mie offerte per le date speciali e un link Non ricevere più queste e-mail regalo, utilizzabile senza accedere.

E-mail di compleanno ricevuta: codice personale, sconto, data di validità, pulsante di applicazione in un clic e disiscrizione
E-mail di compleanno ricevuta: codice personale, sconto, data di validità, pulsante di applicazione in un clic e disiscrizione

La pagina cliente «I miei regali e date speciali»

Accessibile da Il mio account, mostra i codici attivi con un pulsante per copiarli e un pulsante Usalo nel mio carrello, le prossime date speciali del cliente con un conto alla rovescia, il modulo della data di nascita con un link Elimina la mia data di nascita, i regali precedenti e un interruttore per ricevere o meno queste e-mail. Un codice che scade tra meno di 3 giorni viene segnalato. La pagina si adatta ai temi Classic e Hummingbird e al mobile. Puoi nasconderla nelle impostazioni; il link compare in Il mio account solo se almeno una campagna è attiva.

Area cliente: link «I miei regali e date speciali» nel menu dell'account
Area cliente: link «I miei regali e date speciali» nel menu dell’account
Pagina cliente: conto alla rovescia alla prossima data, codice attivo da copiare o applicare, data di nascita e preferenze
Pagina cliente: conto alla rovescia alla prossima data, codice attivo da copiare o applicare, data di nascita e preferenze
Pagina «I miei regali e date speciali» su mobile
Pagina «I miei regali e date speciali» su mobile

Statistiche e monitoraggio del fatturato

La scheda Dashboard mostra, per il periodo scelto:

  • il fatturato generato IVA esclusa e inclusa, calcolato sugli ordini validi che hanno usato un codice e convertito nella valuta predefinita;
  • i codici inviati e utilizzati, il tasso di conversione e il carrello medio;
  • lo sconto concesso e il ritorno (fatturato diviso per lo sconto);
  • gli ordini senza il codice effettuati mentre un codice era valido;
  • un grafico a 12 mesi, il rendimento per occasione, gli invii dei prossimi 30 giorni e gli ultimi ordini con un codice.

Il fatturato è attribuito al periodo di invio del codice. La scheda Codici inviati elenca tutti i codici con ricerca, filtri per occasione, stato e data, nuovo invio dell’e-mail per un codice attivo ed esportazione CSV. Anche la scheda cliente del back office mostra i codici inviati a quel cliente.

La dashboard mostra anche i prossimi 7 giorni: ogni giorno indica il numero di clienti interessati per ricorrenza e porta al calendario. Nella scheda Codici inviati, i filtri rapidi per stato (attivo, usato, scaduto) mostrano il loro numero di codici.

Dashboard: prossimi 7 giorni, fatturato generato, tasso di conversione e grafico su 12 mesi
Dashboard: prossimi 7 giorni, fatturato generato, tasso di conversione e grafico su 12 mesi
Codici inviati: stato attivo, usato o scaduto, promemoria, ordine collegato ed esportazione CSV
Codici inviati: stato attivo, usato o scaduto, promemoria, ordine collegato ed esportazione CSV
Scheda cliente del back-office: codici per le date speciali inviati, stato e link a tutti i codici
Scheda cliente del back-office: codici per le date speciali inviati, stato e link a tutti i codici

Pulizia dei codici scaduti

L’impostazione Eliminare i codici scaduti non utilizzati dopo (30 giorni per impostazione predefinita) elimina le regole carrello corrispondenti per mantenere leggibile Catalogo > Sconti. Lo storico e le statistiche del modulo vengono conservati. Imposta 0 per non eliminare mai.

GDPR

Il modulo si registra presso il modulo GDPR ufficiale di PrestaShop. L’esportazione dei dati di un cliente include i suoi codici e le sue preferenze, l’eliminazione cancella lo storico del modulo per quel cliente. Ogni cliente può disiscriversi da queste e-mail dal proprio account oppure, senza accedere, con il link presente in ogni e-mail: il link apre una pagina di conferma, così un software che segue i link delle e-mail non disiscrive nessuno. Il cliente può anche eliminare la propria data di nascita dalla pagina «I miei regali e date speciali».

Disiscrizione dalle e-mail regalo in un clic, senza accesso, con conferma
Disiscrizione dalle e-mail regalo in un clic, senza accesso, con conferma

Multinegozio

Campagne e impostazioni sono proprie di ogni negozio. Seleziona un negozio nel menu multinegozio per modificarle. I codici creati sono limitati al negozio interessato.

Domande frequenti e risoluzione dei problemi

Non viene inviato alcun codice

Verifica che almeno una campagna sia attiva e che non sia in corso una pausa, poi apri il Calendario o usa Simula. Se l’elenco è vuoto, nessun cliente soddisfa i criteri del giorno: data sconosciuta, periodo di attesa in corso, gruppo non selezionato, ordini insufficienti o cliente disiscritto.

Le e-mail non arrivano

Invia un’e-mail di prova da una campagna. Se non arriva, controlla la configurazione e-mail di PrestaShop in Parametri avanzati > E-mail. Un codice la cui e-mail non è partita viene segnalato nell’elenco dei codici e può essere inviato di nuovo.

Un ordine non compare nelle statistiche

Vengono conteggiati solo gli ordini validi. Se un dipendente senza autorizzazione sul modulo ha creato un ordine nel back office, clicca su Risincronizza i codici utilizzati; anche l’attività giornaliera lo fa automaticamente.

Questa pagina ti è stata utile?

Ancora bloccato? Contatta l'assistenza