Prerequisiti
- WordPress 5.8+, WooCommerce 5.0+, PHP 7.4+. Compatibile HPOS.
- Lo zip del plugin, da scaricare dalla pagina Modules della tua area clienti.
- La chiave di connessione del tuo sito.
Installazione
- Admin WordPress: Plugins > Add New > Upload Plugin.
- Carica lo zip, poi clicca Activate.
Configurazione
- Apri Settings > DataFirefly Server-Side.
- Incolla la chiave di connessione
dfss_...e clicca Connect: il pulsante attiva il tracking completo e l’opzione di consenso, e lancia subito un evento di test.
Il plugin rileva automaticamente i seguenti strumenti di consenso, senza configurazione: WP Consent API, Complianz, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron. I moduli PrestaShop e Shopware usano lo stesso rilevamento: uno strumento riconosciuto qui lo è ovunque.
Cosa copre il plugin
- Tutto il funnel: navigazione, vista prodotto, carrello, checkout, acquisto.
- Deduplicazione per identificativo dell’ordine: nessun doppio conteggio tra browser e server.
- Coda di reinvio automatica: gli invii non riusciti vengono ritrasmessi, a partire dagli acquisti (dettagli più sotto).
- Il pannello DataFirefly Activity nell’admin mostra gli ultimi eventi inviati.
Verificare
- L’evento di test deve comparire come Delivered nel Monitoring della tua area clienti.
- Effettua un ordine di prova e ritrovalo nel pannello DataFirefly Activity.
Coda di reinvio
Vale dalla versione 2.30.0 in poi.
- Un invio non riuscito viene messo in coda e ritrasmesso ogni 5 minuti da WP-Cron.
- 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
- Dopo una modifica della configurazione, svuota la cache del tuo sito: altrimenti LiteSpeed Cache e simili continuano a servire il vecchio JavaScript.
- Se usi una versione del plugin precedente alla 2.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