# Coupon di compleanno: documentazione del modulo PrestaShop > 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… - Pagina: - Lingua: it - Aggiornato il: 2026-09-24 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dfkeydates/index.md), [en](https://www.datafirefly.com/en/documentation/dfkeydates/index.md), [es](https://www.datafirefly.com/es/documentation/dfkeydates/index.md), [de](https://www.datafirefly.com/de/documentation/dfkeydates/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfkeydates/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfkeydates/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfkeydates/index.md) - Indice: ## 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 8.0 a 9.x, multinegozio, 8 lingue (inglese, francese, spagnolo, tedesco, italiano, olandese, polacco, portoghese). ## 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 dalla 1.0.0 alla 1.1.0 basta caricare il nuovo ZIP: lo script di aggiornamento registra i nuovi hook. 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**. ### 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 si aggiorna dal vivo con lo sconto reale. 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 all'indirizzo del dipendente connesso, nella sua lingua. ## 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. I pulsanti **Simula oggi** (elenco dei codici che partirebbero, senza inviare nulla), **Esegui ora**, **Risincronizza i codici utilizzati** e **Nuovo token** si trovano nella stessa pagina. Ogni cliente riceve al massimo un codice per occasione e per anno. Puoi quindi avviare l'attività più volte senza rischio di duplicati. ## 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. ## 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. ## 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. ## 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, il modulo della data di nascita, i regali precedenti e una casella per non ricevere più queste e-mail. Puoi nascondere questa pagina nelle impostazioni. ## 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. ## 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. ## 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 usa **Simula oggi**. 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.