# Ruota della Fortuna e Pop-up Exit-Intent — Guida completa > Panoramica La Ruota della Fortuna e Pop-up Exit-Intent intercetta i visitatori nel momento esatto in cui stanno per abbandonare il tuo negozio e propone loro un gioco: inseriscono la propria… - Pagina: - Lingua: it - Aggiornato il: 2026-06-27 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dfexitwheel/index.md), [en](https://www.datafirefly.com/en/documentation/dfexitwheel/index.md), [es](https://www.datafirefly.com/es/documentation/dfexitwheel/index.md), [de](https://www.datafirefly.com/de/documentation/dfexitwheel/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfexitwheel/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfexitwheel/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfexitwheel/index.md) - Indice: ## Panoramica La **Ruota della Fortuna e Pop-up Exit-Intent** intercetta i visitatori nel momento esatto in cui stanno per abbandonare il tuo negozio e propone loro un gioco: inseriscono la propria email, girano la ruota e se ne vanno con un coupon. Trasformi un abbandono silenzioso in un lead qualificato e, spesso, in un ordine immediato. La particolarità del modulo è che **il premio vincente è determinato lato server** tramite un'estrazione ponderata. Le probabilità non raggiungono mai il browser: la ruota si limita ad animare un risultato già deciso in PHP, il che rende impossibile qualsiasi manipolazione lato client. Il modulo è compatibile con PrestaShop dalla 8.0 alla 9.x, senza Composer né dipendenze esterne. Tutti i testi sono personalizzabili e multilingua. ## Installazione 1. Nel back office, apri **Moduli > Gestione moduli**. 2. Fai clic su **Carica un modulo** e seleziona il file `dfexitwheel.zip`. 3. L'installazione crea automaticamente tre tabelle (segmenti, lead, configurazione), sei segmenti predefiniti e due schede di amministrazione. 4. Il modulo è attivo immediatamente con valori predefiniti funzionali. Non è richiesta alcuna impostazione per iniziare: la ruota funziona subito dopo l'installazione. In seguito puoi rifinire segmenti, testi e trigger. ## Configurazione generale Dalla pagina di configurazione del modulo (**Configura**), imposti: - **Attiva il modulo**: interruttore generale. - **Titolo, sottotitolo, placeholder email, testo del pulsante**: tutte le etichette della pop-up, per lingua. - **Testo di consenso (GDPR)**: la frase mostrata accanto alla casella di consenso obbligatoria. - **Messaggio di vincita / di non vincita**: ciò che viene mostrato dopo l'estrazione. - **Colore principale**: il colore d'accento della pop-up e della ruota. - **Ritardo di idoneità**: tempo minimo sul sito prima che la pop-up possa attivarsi. - **Frequenza (giorni)**: periodo durante il quale un visitatore non rivedrà la pop-up. - **Mostra ai clienti connessi**, **Attiva su mobile**, **Timer mobile**. - **Validità predefinita dei coupon**, **Un solo gioco per email**, **Iscrivi alla newsletter**. I campi di testo sono multilingua: usa il selettore di lingua di ogni campo per inserire una versione per lingua del negozio. ## Gestire i segmenti della ruota La schermata **Segmenti della ruota** elenca gli spicchi visualizzati. Per ciascuno definisci: - **Etichetta**: il testo stampato sullo spicchio (es. "-10%", "Spedizione gratuita", "Peccato!"). - **Colore**: il colore di sfondo dello spicchio. - **Tipo di premio**: sconto percentuale, sconto a importo fisso, spedizione gratuita o nessuno (non vincente). - **Valore**: la percentuale o l'importo a seconda del tipo. - **Peso**: la probabilità relativa di cadere su questo segmento. Un peso alto = segmento frequente. - **Importo minimo**: carrello minimo richiesto perché il coupon si applichi. - **Prefisso del codice** e **validità (giorni)** propri del segmento. - **Posizione** e **attivo**. ### Come funziona la ponderazione L'estrazione somma i pesi di tutti i segmenti attivi e poi seleziona un segmento in proporzione al suo peso. Esempio: con pesi 25, 30, 20, 15, 8 e 2, il segmento di peso 2 (il premio maggiore) esce circa 2 volte su 100. Mantieni così il pieno controllo sulla generosità della ruota. Per una ruota redditizia, mantieni uno o due segmenti "non vincenti" o a sconto basso con un peso alto, e riserva gli sconti elevati a pesi bassi. ## Coupon e regole carrello A ogni vincita, il modulo crea una **regola carrello PrestaShop (CartRule) davvero unica**: - Un solo utilizzo totale e uno per cliente. - Una data di scadenza calcolata dalla validità del segmento (o dalla validità predefinita). - Un importo minimo facoltativo. - Un codice univoco generato per ogni vincitore. Sono possibili tre tipi di ricompensa: **percentuale**, **importo fisso** e **spedizione gratuita**. Il codice viene mostrato al vincitore con un pulsante di copia e un link precompilato verso il negozio. Poiché ogni codice è nominativo e a uso singolo, non può essere condiviso né rivenduto sui siti di offerte, a differenza di un codice generico. ## Lead raccolti ed esportazione CSV La schermata **Lead raccolti** registra ogni partecipazione: email, segmento ottenuto, codice coupon, consenso, data, lingua e negozio. L'elenco è di sola lettura e offre un'**esportazione CSV** per alimentare il tuo strumento di emailing. Se l'opzione **Iscrivi alla newsletter** è attiva, l'email viene aggiunta anche agli iscritti nativi di PrestaShop (tabella di iscrizione alla newsletter) quando viene dato il consenso. ## Attivazione su desktop e mobile Su **desktop**, la pop-up si attiva tramite rilevamento dell'intenzione di uscita: quando il cursore risale rapidamente verso la barra delle schede del browser. Su **mobile**, questo evento non esiste. Il modulo passa allora automaticamente a un **timer configurabile** e al rilevamento di uno scorrimento rapido verso l'alto. Alcuni meccanismi di sicurezza evitano ogni insistenza: un limite di frequenza (la pop-up non riappare per X giorni), un ritardo di idoneità prima del primo attivamento possibile e un arresto definitivo dopo una vincita. ## Conformità GDPR - La cattura dell'email richiede una **casella di consenso esplicito** con un testo che personalizzi. - L'iscrizione alla newsletter è **facoltativa** e legata allo stesso consenso. - I lead sono consultabili ed esportabili, il che facilita le richieste di accesso e cancellazione. ## Compatibilità tecnica - **PrestaShop**: dalla 8.0 alla 9.x. - **Hook**: actionFrontControllerSetMedia (caricamento delle risorse e della configurazione front) e displayFooter (rendering della pop-up). - **Multistore** e **multilingua** supportati. - **Coupon**: regole carrello native, senza tabella parallela. - Nessuna dipendenza da Composer. ## FAQ ### Un cliente può truccare la ruota? No. Il segmento vincente viene calcolato lato server prima dell'animazione. Il browser riceve solo l'indice del risultato e non conosce mai i pesi. ### Che tipo di premi posso distribuire? Sconto percentuale, sconto a importo fisso, spedizione gratuita o un segmento non vincente. Ogni vincita crea una regola carrello unica. ### È compatibile con PrestaShop 9? Sì, il modulo è progettato per PrestaShop dalla 8.0 alla 9.x senza adattamenti. ## Risoluzione dei problemi - **La pop-up non appare**: verifica che il modulo sia attivato, che il ritardo di idoneità sia trascorso e che tu non abbia già giocato (svuota l'archiviazione locale del browser per ripetere il test). - **La pop-up non riappare**: è intenzionale dopo una vincita o durante la finestra di frequenza. Reimposta l'archiviazione locale per forzare una nuova visualizzazione. - **Il coupon non si applica**: controlla l'importo minimo del segmento e la data di scadenza. - **I campi di testo sembrano vuoti nella configurazione**: assicurati di usare l'ultima versione del modulo (la visualizzazione multilingua dei campi è stata corretta nella 1.0.0).