# Installare il plugin Shopware

> Installare e configurare il plugin DataFirefly Server-Side su Shopware 6.5, 6.6 e 6.7: upload dell’estensione, chiave di connessione, cookie di consenso.

- Pagina originale: https://server-side.datafirefly.com/it/docs/shopware.html
- Lingua: it
- Aggiornato il: 2026-09-05
- Editore: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/it/

---

Compatibile con Shopware 6.5, 6.6 e 6.7. Installazione dall’admin o da riga di comando. Una consegna fallita viene messa in coda e riprovata ogni cinque minuti dallo scheduler di Shopware: un'interruzione passeggera non costa nulla.

## Prerequisiti

- Shopware 6.5, 6.6 o 6.7.
- Lo zip del plugin, da scaricare dalla pagina [**Modules**](https://admin.datafirefly.com/app/connectors) della tua area clienti.
- La [chiave di connessione del tuo sito](https://server-side.datafirefly.com/it/docs/connect-your-site.html).

## Installazione

1. Admin Shopware: **Extensions > My extensions > Upload extension**, poi installa e attiva il plugin.
2. Oppure in CLI: `bin/console plugin:install --activate DatafireflyServerSide`

## Configurazione

1. Apri la configurazione del plugin e incolla la chiave di connessione `dfss_...`.
2. 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

1. Lancia `bin/console datafirefly:serverside:test`.
2. 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](https://server-side.datafirefly.com/it/docs/troubleshooting.html).

## 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](https://server-side.datafirefly.com/it/docs/troubleshooting.html).

Aggiornato: 1 settembre 2026
