Prerequisiti
- PrestaShop 1.7.6 o più recente.
- Lo zip del modulo, da scaricare dalla pagina Modules della tua area clienti.
- La chiave di connessione del tuo sito.
Installazione
- Back office PrestaShop: Moduli > Gestione moduli > Carica un modulo.
- Carica lo zip così com’è, senza decomprimerlo.
- Clicca Configura.
Configurazione
- Compila Tenant ID, HMAC secret ed Events endpoint: i tre valori della pagina del tuo sito DataFirefly.
- Opzione Require consent: il modulo lascia partire un evento solo quando il visitatore ha accettato la pubblicità. Riconosce da solo, senza configurazione: tarteaucitron, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, nel browser e sul server, la stessa lista dei moduli WooCommerce e Shopware. Consigliato se il suo negozio ha un banner di consenso.
- Imposta Enable tracking su Yes: è disattivato di default.
- Salva, poi clicca Send test event.
Non hai ancora un banner di consenso sul tuo negozio? Il modulo Cookie Manager per PrestaShop installa tarteaucitron pronto all’uso, con Consent Mode v2.
Verificare
- L’evento di test deve comparire come Delivered nel Monitoring della tua area clienti.
- Effettua un ordine di prova: il modulo invia gli acquisti alla convalida dell’ordine.
Coda di reinvio
Vale dalla versione 1.29.0 in poi.
- Un invio non riuscito viene messo in coda e ritrasmesso man mano che arrivano visite al negozio: al massimo ogni 30 secondi, mai due ritrasmissioni insieme, a blocchi di massimo 20 eventi inviati in parallelo.
- Negozio con poco traffico: un URL di cron facoltativo, protetto da un token e raggiungibile solo in https, avvia la ritrasmissione senza aspettare una visita.
- Acquisti e rimborsi hanno la precedenza, poi gli eventi più recenti.
- Un evento esce dalla coda solo quando ha più di 7 giorni e aspetta da più di 7 giorni. A quel punto viene conteggiato come scaduto: niente sparisce senza lasciare traccia.
- Se DataFirefly non risponde (errore di rete, HTTP 429 o 5xx), il negozio smette di inviare direttamente per 60 secondi e mette subito gli eventi in coda. Così un guasto da parte nostra non rallenta mai il tuo negozio né il checkout. La ritrasmissione continua a provare e, appena riesce, l'invio diretto riprende.
- La pagina del tuo sito nell'area clienti mostra lo stato di questa coda. Gli stati sono spiegati nella pagina Risoluzione dei problemi.
In caso di problemi
- Log: Parametri avanzati > Log, filtra sul prefisso
[DataFirefly SS]. - Se usi una versione del modulo precedente alla 1.8.0, aggiorna: le versioni recenti correggono un possibile doppio conteggio degli acquisti in GA4.
- Le altre cause frequenti sono elencate nella guida alla risoluzione dei problemi.
Aggiornato: 1 settembre 2026