# Funnel di conversione & Heatmap — Documentazione > Installazione, configurazione e utilizzo del modulo DataFirefly Funnel di conversione & Heatmap per PrestaShop 8 e 9. - Pagina: - Lingua: it - Aggiornato il: 2026-06-27 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dffunnelheatmap/index.md), [en](https://www.datafirefly.com/en/documentation/dffunnelheatmap/index.md), [es](https://www.datafirefly.com/es/documentation/dffunnelheatmap/index.md), [de](https://www.datafirefly.com/de/documentation/dffunnelheatmap/index.md), [pl](https://www.datafirefly.com/pl/documentation/dffunnelheatmap/index.md), [pt](https://www.datafirefly.com/pt/documentation/dffunnelheatmap/index.md), [nl](https://www.datafirefly.com/nl/documentation/dffunnelheatmap/index.md) - Indice: Il modulo **DataFirefly - Funnel di conversione & Heatmap** (`dffunnelheatmap`) riunisce due strumenti di analisi comportamentale per PrestaShop 8 e 9: un **funnel di conversione** in 9 fasi che mostra esattamente dove abbandonano i tuoi visitatori, e una **heatmap** che rivela su cosa cliccano e fin dove scorrono. Tutta la raccolta è 100% first-party, senza servizi di terze parti, senza CDN e senza cookie pubblicitari. ## Installazione 1. Scarica l'archivio `dffunnelheatmap.zip` dal tuo account cliente. 2. Nel back-office, vai su **Moduli > Gestore moduli**, clicca su **Carica un modulo** e seleziona lo ZIP. 3. Durante l'installazione, il modulo crea le sue tabelle, registra i suoi hook e aggiunge una scheda **Funnel & Heatmap** sotto **Statistiche**. Nessuna dipendenza esterna: niente Composer, niente CDN. Il modulo è operativo subito dopo l'installazione, con impostazioni predefinite prudenti (campionamento 100%, conservazione 90 giorni, Do Not Track rispettato). ## Accedere alla dashboard Vai su **Statistiche > Funnel & Heatmap** (oppure clicca su **Configura** dall'elenco dei moduli). L'interfaccia offre quattro viste: **Dashboard**, **Funnel**, **Heatmap** e **Impostazioni**. La dashboard mostra quattro indicatori chiave: numero di visite, numero di ordini, tasso di conversione globale e rilevamento automatico del maggior abbandono del funnel, insieme a un'anteprima visiva del funnel. ## Il funnel di conversione Il funnel segue i tuoi visitatori fase per fase, dalla prima visita fino all'ordine effettuato. Per ogni fase, vedi il numero di sessioni coinvolte e la percentuale di abbandono rispetto alla fase precedente. Le nove fasi sono: 1. **Visita** — qualsiasi pagina vista (rilevamento lato server). 2. **Pagina prodotto** — consultazione di una scheda prodotto (server). 3. **Aggiunta al carrello** — rilevata lato client all'azione «aggiungi al carrello». 4. **Pagina del carrello** — visualizzazione del carrello (server). 5. **Checkout** — ingresso nel checkout (server). 6. **Indirizzo** — fase indirizzo del checkout (client). 7. **Spedizione** — fase corriere (client). 8. **Pagamento** — fase pagamento (client). 9. **Ordine effettuato** — registrato in modo affidabile lato server tramite l'hook di validazione dell'ordine. Le sessioni vengono deduplicate: una stessa sessione viene contata una sola volta per fase, garantendo tassi di passaggio accurati. Il maggior abbandono viene evidenziato automaticamente per indicarti dove concentrare i tuoi sforzi di ottimizzazione. ## La heatmap La heatmap mostra un rendering reale della pagina selezionata, sul quale vengono sovrapposti i dati comportamentali raccolti. ### Mappa dei clic I clic sono rappresentati come una mappa di calore, dal blu (pochi clic) al rosso (alta concentrazione). Ideale per verificare che le tue call to action attirino davvero l'attenzione. ### Profondità di scroll La profondità di scorrimento è mostrata per livelli (25, 50, 75 e 100%), con la quota di visitatori che ha raggiunto ciascun livello. Così individui il contenuto visto da tutti e quello che resta sotto la linea di galleggiamento. ### Elementi più cliccati Un pannello laterale classifica gli elementi più cliccati (per selettore CSS ed etichetta), per identificare con precisione ciò che cattura l'interesse. La heatmap carica la pagina del negozio in un iframe in _same-origin_. Se il tuo server forza l'header `X-Frame-Options: DENY`, consenti `SAMEORIGIN` per il back-office affinché l'anteprima venga visualizzata. ## Filtri Tutte le viste condividono una barra dei filtri: **periodo** (7, 30, 90 o 365 giorni, o un intervallo personalizzato), **dispositivo** (mobile, tablet, desktop) e **negozio** in contesto multinegozio. ## Impostazioni - **Attivazione globale** e attivazione separata del funnel e della heatmap. - **Campionamento** (da 1 a 100%) applicato solo alla heatmap, per limitare il volume sui siti ad alto traffico. Il funnel è sempre tracciato al 100%. - **Conservazione** in giorni, con pulizia automatica opportunistica e pulsanti di pulizia manuale. - **Supporto Do Not Track** (attivo per impostazione predefinita). - **Tracciamento dei dipendenti** connessi al back-office (disattivato per impostazione predefinita). - **Pulizia alla disinstallazione** per eliminare i dati raccolti quando il modulo viene rimosso. ## Privacy (GDPR) Il modulo non raccoglie alcun dato personale: nessun indirizzo IP memorizzato, nessuna email. L'identificativo visitatore è anonimo e casuale (cookie tecnico `dffh_vid`). Il Do Not Track è rispettato per impostazione predefinita e la durata di conservazione è interamente configurabile. L'endpoint di raccolta è protetto da un token validato lato server. ## Risoluzione dei problemi **Le sotto-fasi del checkout (indirizzo, spedizione, pagamento) non vengono registrate.** Si basano sul checkout standard a pagina singola di PrestaShop. Un tema fortemente personalizzato può richiedere un piccolo adattamento dei selettori in `views/js/tracker.js`. **Il conteggio delle conversioni per dispositivo sembra approssimativo.** Il dispositivo non è noto lato server al momento della validazione dell'ordine (fase 9), quindi filtrare le conversioni per dispositivo resta una stima. ## Disinstallazione La disinstallazione rimuove la scheda e gli hook. I dati raccolti vengono conservati per impostazione predefinita; spunta in anticipo l'opzione **Pulizia alla disinstallazione** nelle impostazioni se desideri eliminarli definitivamente.