Prerequisiti
- Shopware 6.5, 6.6 o 6.7.
- Lo zip del plugin, da scaricare dalla pagina Modules della tua area clienti.
- La chiave di connessione del tuo sito.
Installazione
- Admin Shopware: Extensions > My extensions > Upload extension, poi installa e attiva il plugin.
- Oppure in CLI:
bin/console plugin:install --activate DatafireflyServerSide
Configurazione
- Apri la configurazione del plugin e incolla la chiave di connessione
dfss_.... - Attiva Enable tracking.
Il modulo riconosce da solo gli strumenti di consenso più diffusi (DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron), nel browser e sul server, la stessa lista dei moduli WooCommerce e PrestaShop. Lasci Consent cookie name vuoto per questo rilevamento automatico; lo compili solo per imporre un cookie preciso (per esempio CookieConsent e marketing:true), che diventa allora prioritario.
Verificare
- Lancia
bin/console datafirefly:serverside:test. - L’evento di test deve comparire come Delivered nel Monitoring della tua area clienti.
Coda di reinvio
Vale dalla versione 1.23.0 in poi.
- Un invio non riuscito viene messo in coda e ritrasmesso ogni 5 minuti da un'attività pianificata di Shopware.
- 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 in
var/log/, prefisso[DataFirefly SS]. - Se usi una versione del plugin precedente alla 1.9.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