# Installare il plugin WooCommerce

> Installare e configurare il plugin DataFirefly Server-Side su WooCommerce: chiave di connessione dfss\_, funnel completo, deduplicazione degli ordini.

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

---

Funnel completo, dalla vista prodotto all’acquisto, con deduplicazione automatica e coda di reinvio. Compatibile HPOS.

## Prerequisiti

- WordPress 5.8+, WooCommerce 5.0+, PHP 7.4+. Compatibile HPOS.
- 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 WordPress: **Plugins > Add New > Upload Plugin**.
2. Carica lo zip, poi clicca **Activate**.

## Configurazione

1. Apri **Settings > DataFirefly Server-Side**.
2. 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

1. L’evento di test deve comparire come **Delivered** nel Monitoring della tua area clienti.
2. 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](https://server-side.datafirefly.com/it/docs/troubleshooting.html).

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

Aggiornato: 1 settembre 2026
