# Sondaggio post-acquisto: come ci hai conosciuto? > Il modulo DataFirefly Post-Purchase Survey pone la domanda «Come ci hai conosciuto?» nella pagina di conferma dell'ordine e confronta ogni canale dichiarato con il fatturato che genera. Questa documentazione copre… - Pagina: - Lingua: it - Aggiornato il: 2026-09-24 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dfpostpurchasesurvey/index.md), [en](https://www.datafirefly.com/en/documentation/dfpostpurchasesurvey/index.md), [es](https://www.datafirefly.com/es/documentation/dfpostpurchasesurvey/index.md), [de](https://www.datafirefly.com/de/documentation/dfpostpurchasesurvey/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfpostpurchasesurvey/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfpostpurchasesurvey/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfpostpurchasesurvey/index.md) - Indice: Il modulo **DataFirefly Post-Purchase Survey** pone la domanda «Come ci hai conosciuto?» nella pagina di conferma dell'ordine e confronta ogni canale dichiarato con il fatturato che genera. Questa documentazione copre installazione, impostazioni, sollecito via email e lettura del report. ## Installazione Nel back office vai su **Moduli > Gestione moduli**, clicca su _Carica un modulo_ e invia il file ZIP. All'installazione il modulo crea le sue tabelle, aggiunge undici risposte pronte nelle lingue del negozio e registra la scheda **Ordini > Sondaggio di attribuzione**. Nel report compaiono solo gli ordini effettuati dopo l'installazione: la riga di tracciamento nasce alla convalida dell'ordine. ## Impostazioni del sondaggio Apri la configurazione del modulo (pulsante _Configura_ nella gestione moduli). - **Domanda**: il testo mostrato sopra le risposte, per lingua. - **Messaggio di ringraziamento**: sostituisce il blocco una volta inviata la risposta. - **Chiedere a**: tutti i clienti oppure solo i nuovi clienti (primo ordine). - **Mescola le risposte**: cambia l'ordine a ogni visualizzazione per limitare la preferenza verso le prime opzioni. Le risposte con «Sempre per ultima» restano in fondo. - **Non richiedere per**: giorni durante i quali un cliente che ha già risposto non viene ricontattato. Metti 0 per chiedere a ogni ordine. - **Mostra anche nello storico ordini**: chi non ha risposto ritrova la domanda nel dettaglio ordine del suo account. - **Rileva la fonte di traffico**: vedi la sezione dedicata più sotto. Sotto il modulo di configurazione è mostrata un'anteprima del blocco così come appare in vetrina. ## Gestire le risposte Il pulsante **Gestisci le risposte**, presente nella configurazione e nella barra del report, apre l'elenco delle risposte proposte al cliente. Per ogni risposta: - **Testo** per lingua, fino a 128 caratteri; - **Chiedi dettagli**: apre un campo di testo libero quando il cliente sceglie quella risposta (utile per «Altro»); - **Sempre per ultima**: la risposta resta in fondo anche quando l'ordine viene mescolato; - **Colore**: usato nei grafici del report; - **Attivo** e **posizione** con trascinamento; - **Negozi**: in multinegozio, spunta i negozi in cui la risposta viene proposta. Eliminare una risposta non cancella le risposte già ricevute: restano nel report con la dicitura «Risposta eliminata». ## Sollecito via email Il sollecito invia una sola email ai clienti che non hanno risposto. Ogni risposta è un link: il clic registra la risposta e apre una pagina di ringraziamento, senza modulo e senza login. ### Impostazioni - **Invia un sollecito**: attiva la funzione. - **Oggetto dell'email**: per lingua. - **Invia dopo**: ritardo in ore dopo l'ordine (72 di default). - **Ignora gli ordini più vecchi di**: evita un invio massivo sullo storico alla prima attivazione (30 giorni di default). - **Email per esecuzione**: limite per ogni passaggio del cron. - **Solo ordini pagati**: salta gli ordini non convalidati. ### Attività cron La pagina di configurazione mostra un URL protetto da token. Richiamalo una volta al giorno, per esempio: ``` 0 9 * * * curl -s "https://tuo-negozio.it/module/dfpostpurchasesurvey/cron?token=IL_TUO_TOKEN" >/dev/null ``` La risposta indica quante email sono state inviate, saltate e fallite. Due pulsanti permettono inoltre di inviare un'email di prova al tuo indirizzo di dipendente e di lanciare la coda manualmente. Un carrello diviso in più ordini genera una sola email, e la risposta viene registrata per tutti gli ordini di quel carrello. ## Report di attribuzione Scheda **Ordini > Sondaggio di attribuzione**. Scegli un periodo, il tipo di clienti (tutti, nuovi, abituali) e l'opzione «Solo ordini pagati». ### Indicatori Ordini tracciati, risposte, tasso di risposta, fatturato IVA esclusa e fatturato con risposta, ciascuno confrontato con il periodo precedente di pari durata. ### Tabella per canale - **% delle risposte** e **% del fatturato**: la ripartizione dichiarata e quella del fatturato. - **Indice**: il rapporto tra le due, base 100. Sopra 100 il canale porta carrelli più alti della media. - **Fatturato stimato**: applica la ripartizione osservata a tutti gli ordini tracciati, compresi quelli senza risposta. Gli importi sono IVA esclusa, convertiti nella valuta predefinita del negozio. Il pulsante **Esporta CSV** produce una riga per ordine con il canale dichiarato, i dettagli, il fatturato, la fonte rilevata e il canale di raccolta (pagina di conferma o email). ## Rilevamento della fonte di traffico Opzione disattivata per impostazione predefinita. Una volta attiva, il modulo conserva la prima fonte UTM (`utm_source`, `utm_medium`, `utm_campaign`), i consueti identificativi di clic pubblicitari o il sito di provenienza della visita, e li registra nel cookie di sessione già usato dal negozio. Nessuno script di terze parti viene caricato e nessun dato esce dal negozio. Il report mostra allora una tabella incrociata canale dichiarato contro fonte rilevata e la percentuale di risposte senza fonte rilevabile, cioè le vendite invisibili al tracciamento tramite cookie. Questa opzione scrive un'informazione di provenienza in un cookie di sessione. Indicala nella tua cookie policy prima di attivarla. ## Scheda ordine e dashboard La scheda ordine nel back office mostra un pannello con la risposta del cliente, i dettagli, la dicitura «Primo ordine» quando pertinente e la fonte rilevata. La dashboard PrestaShop mostra i primi 5 canali del periodo selezionato. ## GDPR Il modulo implementa gli hook ufficiali del modulo psgdpr: l'esportazione dei dati di un cliente include le sue risposte, e una richiesta di cancellazione anonimizza le righe interessate (cliente scollegato, testo libero e campagna cancellati) mantenendo la risposta nelle statistiche. ## Aggiornamento Carica il nuovo ZIP dalla gestione moduli. Gli script di aggiornamento aggiungono colonne e tabelle necessarie, registrano i nuovi hook e associano le risposte esistenti a tutti i negozi. Nessun dato viene perso. ## Risoluzione dei problemi ### Il blocco non compare nella pagina di conferma Verifica che il modulo sia agganciato a `displayOrderConfirmation`, che almeno una risposta sia attiva per quel negozio e che il cliente non abbia già risposto o saltato. Se il targeting è su «Solo nuovi clienti», un cliente abituale non vedrà nulla. ### Le email di sollecito non partono Prova prima l'invio con il pulsante di email di prova: usa le impostazioni email del negozio. Poi verifica che il sollecito sia attivo, che il cron richiami l'URL con il token corretto e che esistano ordini che soddisfano le condizioni di ritardo ed età massima. ### Il report è vuoto Vengono contati solo gli ordini successivi all'installazione. Allarga il periodo e togli la spunta da «Solo ordini pagati» se i tuoi ordini sono in attesa di pagamento.