Funnel di conversione e heatmap: documentazione del modulo PrestaShop 8 e 9
Funnel in 9 step, acquisizione, prodotti, heatmap con clic di rabbia e report settimanale via e-mail per PrestaShop 8 e 9.
Il modulo DataFirefly – Funnel di conversione & Heatmap (dffunnelheatmap) mostra dove abbandonano i tuoi visitatori, da dove arrivano gli acquirenti e cosa li blocca sulle tue pagine. Riunisce un funnel di conversione in 9 step, un report di acquisizione, statistiche prodotti, una heatmap con rilevamento dei clic di rabbia e un report settimanale via e-mail. Tutta la raccolta dati è first-party: nulla lascia il tuo server.
Questa documentazione riguarda la versione 1.3.2, compatibile con PrestaShop dalla 8.0 alla 9.x (PHP 7.2 o superiore).
Installazione e aggiornamento
- Scarica l’archivio
dffunnelheatmap.zipdal tuo account cliente. - Nel back office, apri Moduli > Gestione moduli, clicca su Carica un modulo e seleziona lo ZIP.
- Il modulo crea le sue 6 tabelle e aggiunge la scheda Statistiche > Funnel e heatmap.
Per aggiornare da una versione precedente, carica il nuovo ZIP sopra il modulo installato. Gli script di aggiornamento partono da soli: dati e impostazioni vengono conservati.
Nessuna dipendenza esterna: niente Composer, niente CDN. Le impostazioni predefinite vanno bene per la maggior parte dei negozi: heatmap sul 100% delle sessioni, conservazione di 90 giorni, Do Not Track rispettato, dipendenti esclusi.
Per iniziare
Finché non arriva la prima visita, la dashboard mostra una checklist: tracciamento attivo, funnel o heatmap attivi, prima visita ricevuta. I browser connessi al back office non vengono contati: per verificare la raccolta, apri il negozio in una finestra di navigazione privata o su un altro dispositivo.
La dashboard
L’interfaccia ha sei schede: Dashboard, Funnel di conversione, Acquisizione, Prodotti, Heatmap e Impostazioni.
- Indicatori: sessioni, visitatori unici, ordini effettuati, tasso di aggiunta al carrello, tasso di conversione, fatturato tracciato IVA inclusa, ordine medio e abbandono maggiore del funnel. Ogni indicatore è confrontato con il periodo precedente della stessa durata.
- Giorno per giorno: grafico di sessioni, ordini o tasso di conversione. I pulsanti sopra il grafico cambiano l’indicatore senza ricaricare la pagina, e il link Mostra i dati apre la tabella dei valori.
- Raccomandazioni: fino a 6 constatazioni suddivise in Da correggere, Da verificare e Buona notizia, ognuna con un link al report corrispondente.
- In questo momento: visitatori degli ultimi 5 minuti, pagine visualizzate e ripartizione per dispositivo, aggiornato ogni 30 secondi.
Una scheda riepilogativa (sessioni, ordini e conversione degli ultimi 7 giorni, visitatori in questo momento) compare anche nella dashboard iniziale di PrestaShop.
Le raccomandazioni
Compaiono solo oltre un volume minimo, circa 30 sessioni per dispositivo o canale, per evitare conclusioni tratte da tre visite. Il modulo verifica:
- la perdita maggiore del funnel tra due step;
- la quota di sessioni che entrano nel checkout ed effettuano un ordine;
- lo scarto di conversione tra mobile e desktop;
- i canali che portano traffico senza alcun ordine, e il canale che converte meglio;
- il prodotto più visto tra quelli poco aggiunti al carrello;
- la pagina con più clic di rabbia e clic a vuoto;
- un aumento o un calo del traffico di almeno il 20%.
Il funnel di conversione
Il funnel conta le sessioni. Una sessione termina dopo 30 minuti di inattività. Ogni sessione è contata allo step più avanzato che raggiunge, e in tutti gli step precedenti: il funnel si restringe sempre.
- Visita: qualsiasi pagina vista.
- Pagina prodotto: visualizzazione di una scheda prodotto.
- Aggiunta al carrello: rilevata lato server, da qualunque pagina avvenga.
- Pagina del carrello: visualizzazione del carrello.
- Checkout: ingresso nel processo d’ordine.
- Indirizzo: step indirizzo del checkout standard, rilevato nel browser.
- Spedizione: scelta del corriere, rilevata nel browser.
- Pagamento: step di pagamento, rilevato nel browser.
- Ordine effettuato: registrato lato server alla convalida dell’ordine, poi confermato dalla pagina di conferma.
La tabella dettagliata indica per ogni step le sessioni che lo raggiungono, la loro quota, le sessioni perse rispetto allo step precedente, il tasso di abbandono e le sessioni che hanno attivato lo step stesso. Un’aggiunta al carrello da una pagina categoria, per esempio, salta la pagina prodotto. Le righe con un abbandono oltre il 30% o il 50% sono evidenziate.
La colonna vs periodo precedente indica la variazione della quota di sessioni, in punti. La tabella Conversione per dispositivo confronta desktop, tablet e mobile. Il pulsante Esporta CSV scarica il funnel con i filtri attivi.
Acquisizione
Ogni sessione è collegata a un canale in base al dominio del sito di provenienza (viene salvato solo il dominio), ai parametri UTM e agli identificativi di clic pubblicitari.
- Diretto: nessun sito di provenienza e nessun parametro UTM.
- Ricerca organica: motori di ricerca (Google, Bing, Qwant, DuckDuckGo, Ecosia…).
- Annunci a pagamento: identificativo di clic Google Ads o Microsoft Ads (
gclid,msclkid), oppure unutm_mediumcome cpc, ppc, paid o display. - Social network: Facebook, Instagram, TikTok, LinkedIn, Pinterest, X, YouTube…, oppure un link con
fbclidottclid. - Email:
utm_medium=emailo una webmail (Gmail, Outlook…). - Siti di riferimento: qualsiasi altro sito.
- Altre campagne: un parametro UTM che non corrisponde a nessuno dei casi precedenti.
I ritorni da una pagina di pagamento (PayPal, Stripe…) non contano come sorgente: non sostituiscono mai l’origine reale della visita.
La scheda mostra i canali (sessioni, quota, rimbalzo, aggiunta al carrello, conversione, ordini e fatturato), poi le sorgenti, le campagne utm_campaign, le pagine di destinazione con un link alla loro heatmap e la ripartizione tra visitatori nuovi e di ritorno. Clicca su un canale per aprire il funnel filtrato su quel canale.
Prodotti
Per ogni prodotto: visualizzazioni (una per sessione), prime aggiunte al carrello, ordini, quantità vendute, tasso di aggiunta al carrello e tasso visualizzazione-ordine. Sono disponibili quattro ordinamenti: Più visti, Più aggiunti al carrello, Più ordinati e Opportunità.
L’ordinamento Opportunità elenca i prodotti visti almeno 20 volte il cui tasso di aggiunta al carrello è inferiore alla metà della media del negozio. Attirano visitatori, ma qualcosa li blocca: prezzo, foto, descrizione, disponibilità o tempi di spedizione.
La heatmap
Scegliere una pagina
Le pagine sono raggruppate per tipo (home, prodotti, categorie, carrello e checkout…) e ordinate per numero di visualizzazioni. Il campo di ricerca filtra per titolo o indirizzo. La pagina più vista si carica automaticamente. Il blocco Pagine da tenere d’occhio, in cima alla scheda, elenca le pagine con più clic di rabbia e clic a vuoto.
La pagina viene mostrata in un’anteprima alla dimensione dello schermo più frequente dei suoi visitatori, per il dispositivo scelto (desktop, tablet o mobile). Scorri l’anteprima: il livello di calore la segue.
Ogni clic viene riposizionato sull’elemento cliccato dal visitatore, nella stessa posizione al suo interno, qualunque sia la larghezza del suo schermo, l’altezza della sua pagina al momento del clic o un’intestazione fissa. I clic su un elemento fisso (barra di aggiunta al carrello in fondo allo schermo) restano su di esso durante lo scorrimento. Se l’elemento non esiste o è nascosto nell’anteprima (menu chiuso, finestra chiusa), il clic torna alle sue coordinate originali. Nell’anteprima i banner di consenso sono nascosti e vengono eseguiti solo gli script del negozio: gli script di terze parti (tag, chat) sono bloccati.
Le tre modalità
- Clic: heatmap dei clic, dal giallo (pochi clic) al rosso scuro (molti).
- Scroll: quota di visitatori che raggiungono ogni altezza della pagina, con la linea di piega media.
- Frustrazione: indicatori dei clic di rabbia (rossi) e dei clic a vuoto (grigi). I clic vicini vengono raggruppati e il loro numero viene mostrato.
Un clic di rabbia è una serie di 3 clic in meno di un secondo nello stesso punto. Un clic a vuoto è un clic su un’immagine o un elemento che sembra cliccabile, senza alcuna reazione della pagina.
Segmenti ed elementi cliccati
Il selettore di segmento mostra Tutti i visitatori, solo acquirenti (sessioni con ordine) o solo non acquirenti. Il pannello laterale classifica gli elementi più cliccati con i loro clic di rabbia e a vuoto. Passa il mouse su un elemento per individuarlo nell’anteprima.
L’anteprima carica la pagina del negozio all’interno del back office. Negozio e back office devono stare sullo stesso dominio, e il server non deve inviare X-Frame-Options: DENY: usa SAMEORIGIN.
Report settimanale via e-mail
Ogni lunedì, un’e-mail riassume la settimana passata (da lunedì a domenica) rispetto alla precedente:
- sessioni, ordini effettuati, tasso di conversione e fatturato tracciato, con la loro variazione;
- fino a 4 punti da guardare per primi, tratti dalle raccomandazioni;
- il funnel in 5 step chiave (visita, pagina prodotto, aggiunta al carrello, checkout, ordine effettuato);
- i primi 5 canali di acquisizione con conversione e fatturato;
- un pulsante che apre la dashboard su quella settimana.
Impostazioni del report
In Impostazioni > Report settimanale via e-mail:
- Invia un report ogni lunedì: attivo per impostazione predefinita.
- Destinatari: un indirizzo per riga. Se il campo è vuoto, il report va all’e-mail del negozio.
- Lingua del report: per impostazione predefinita la lingua del negozio. Il report esiste in francese, inglese, spagnolo, tedesco, italiano, olandese, polacco e portoghese.
- Salva e invia un test: invia subito ai destinatari il report della settimana scorsa.
- Anteprima della settimana scorsa: apre il report in una nuova scheda, esattamente come lo riceveranno i destinatari.
Quando parte il report?
Non serve nessun cron. La prima visita registrata il lunedì avvia l’invio, dopo la risposta al visitatore, che quindi non aspetta. Un blocco impedisce due invii per la stessa settimana. Nessuna e-mail viene inviata dopo una settimana senza visite. Dopo l’installazione o l’aggiornamento, il primo report parte il lunedì successivo.
Il report usa la configurazione e-mail di PrestaShop. Se le e-mail sono disattivate in Parametri avanzati > E-mail, nelle impostazioni compare un avviso. I link del report aprono il back office senza token di sicurezza: PrestaShop chiede una conferma prima di mostrare la pagina, è normale.
Filtri
I report condividono una barra di filtri: periodo (7, 30, 90 o 365 giorni, o date personalizzate), dispositivo, canale (dashboard e funnel) e negozio in multinegozio. I filtri restano attivi passando da una scheda all’altra.
Impostazioni
Tracciamento
- Attiva il tracciamento, poi attiva separatamente il funnel di conversione e la heatmap.
- Campionamento heatmap (da 1 a 100%): quota di sessioni registrate per la heatmap. Il funnel registra sempre tutte le sessioni.
Privacy
- Rispetta Do Not Track e Global Privacy Control: attivo per impostazione predefinita.
- Modalità senza cookie: la sessione vive nella scheda del browser. I visitatori unici non vengono più contati.
- Conservazione dei dati in giorni (90 per impostazione predefinita). Gli eventi più vecchi vengono eliminati automaticamente, al massimo una volta all’ora.
Esclusioni
- Traccia i dipendenti connessi: disattivato per impostazione predefinita, i browser connessi al back office non vengono contati.
- Indirizzi IP esclusi: uno per riga, indirizzo esatto, intervallo CIDR (
192.168.1.0/24) o prefisso (10.0.*). Il tuo indirizzo attuale viene mostrato. - Escludi questo browser: imposta un cookie di esclusione, comodo su uno smartphone o un computer non connesso al back office.
Manutenzione
Il blocco Manutenzione dei dati mostra il volume salvato e propone tre azioni: eliminare oltre la conservazione, generare una nuova chiave di tracciamento ed eliminare tutti i dati.
Privacy e GDPR
- Nessun indirizzo IP, nessuna e-mail e nessun valore dei campi dei moduli viene salvato.
- Vengono conservati solo i testi degli elementi cliccabili (pulsanti, link), e nessun testo sulle pagine account e ordine. E-mail e lunghe sequenze di cifre sono mascherate nel browser e poi sul server.
- Cookie tecnici first-party:
dffh_sid(sessione, 30 minuti),dffh_vid(visitatore anonimo, 13 mesi) edffh_optout(esclusione). La modalità senza cookie li elimina. - Bot e strumenti di audit (Lighthouse, PageSpeed…) vengono ignorati.
- L’indirizzo di raccolta accetta solo richieste POST firmate con una chiave di tracciamento, e vengono salvati solo indirizzi del tuo negozio.
In base alla tua valutazione e a quella del tuo DPO, puoi citare questo tracciamento nella tua informativa privacy o attivare la modalità senza cookie.
Risoluzione dei problemi
Non compare nessun dato. Verifica di non testare da un browser connesso al back office o da un IP escluso, e che Do Not Track non sia attivo nel tuo browser. Svuota la cache di PrestaShop dopo l’installazione se usi una cache di pagina completa.
Gli step indirizzo, spedizione e pagamento restano a zero. Si basano sul checkout standard di PrestaShop (temi Classic e Hummingbird). Un modulo di checkout di terze parti potrebbe non esporli. Gli altri step, compreso l’ordine effettuato, restano tracciati lato server.
L’anteprima della heatmap resta vuota. Negozio e back office devono stare sullo stesso dominio, senza intestazione X-Frame-Options: DENY.
Il report settimanale non arriva. Usa Salva e invia un test: un messaggio indica se l’invio è fallito, se le e-mail sono disattivate o se manca un destinatario. Controlla anche la cartella spam.
Disinstallazione
La disinstallazione rimuove la scheda, gli hook e le impostazioni. I dati raccolti vengono conservati per impostazione predefinita. Per eliminarli, attiva Elimina i dati alla disinstallazione nelle impostazioni prima di disinstallare: le 6 tabelle del modulo vengono allora eliminate.