DataFirefly Server-Side — Guida completa
Installa e connetti il plugin gratuito DataFirefly Server-Side, collega il tracking client + server dell'intero funnel WooCommerce, comprendi la deduplicazione per event_id, l'acquisto in server-side impossibile da bloccare, la gestione del consenso (incluso Cookie Consent v2), la coda di ritentativi e l'abbonamento al servizio.
DataFirefly Server-Side è il connettore WooCommerce gratuito del servizio DataFirefly Server-Side Tracking. Il plugin cattura gli eventi del tuo negozio e li firma; il servizio li diffonde in server-side verso le tue piattaforme pubblicitarie e di analisi. Questa guida copre l’installazione, la connessione, il funzionamento del funnel client + server, la deduplicazione, l’acquisto in server-side, la gestione del consenso, l’affidabilità e l’abbonamento.
Modello plugin gratuito + servizio a pagamento. Il plugin non costa nulla e resterà gratuito. Per inviare davvero i tuoi eventi serve un abbonamento al servizio DataFirefly Server-Side (da 39 €/mese), che si occupa dell’ingestione e della diffusione server-side.
Requisiti
- WordPress 5.8 o successivo
- WooCommerce 5.0 o successivo (compatibile con HPOS — High-Performance Order Storage)
- PHP 7.4 o successivo
- Un cron di WordPress funzionante (o un vero cron di sistema) per la coda di ritentativi e l’invio differito
- Un abbonamento a DataFirefly Server-Side per ottenere la tua chiave di connessione
Installazione
- Scarica
datafirefly-serverside-2_0_1.zipdalla tua area cliente DataFirefly. - Nel back-office di WordPress, vai su Plugin → Aggiungi nuovo → Carica plugin, seleziona lo ZIP e fai clic su Installa ora.
- Attiva il plugin. Nella amministrazione compare un nuovo menu DataFirefly Server-Side.
Connessione con una sola chiave
Il plugin si configura con un’unica chiave di connessione che attiva contemporaneamente il tracking lato client e lato server.
- Dalla tua area cliente DataFirefly, copia la chiave di connessione (inizia con
dfss_). - Incollala nel campo previsto della schermata Connessione del plugin.
- Fai clic su Connetti. Il plugin attiva il tracking lato client e lato server, invia un evento di test al dispatcher e imposta i tag client per le destinazioni configurate.
- Verifica che lo stato passi a Connesso ✓ e usa il pulsante Testa l’evento per confermare la consegna.
La chiave dfss_… codifica il tuo tenant, un segreto e l’endpoint del dispatcher. È limitata agli host datafirefly.com in HTTPS: una chiave che punta a un altro dominio viene rifiutata.
Modalità avanzata (inserimento manuale)
Se preferisci non usare la chiave unica, la modalità avanzata consente di inserire manualmente tenant, segreto ed endpoint. Riservala a configurazioni specifiche: la modalità a una chiave copre quasi tutti i casi.
Funnel completo client + server
Il plugin segue tutto il funnel lato browser, mentre la conversione di acquisto parte dal server.
- Lato browser:
page_view,view_content(visualizzazione prodotto),add_to_cart,initiate_checkouteadd_payment_info. - Lato server:
purchase, attivato dagli hook dell’ordine WooCommerce.
Le due parti condividono lo stesso identificatore di evento per permettere la deduplicazione.
Deduplicazione per event_id
Per ogni ordine, l’evento client e l’evento server portano lo stesso event_id, basato sull’identificatore dell’ordine (per esempio order_1042). Meta, GA4 e le altre piattaforme lo usano per contare ogni conversione una sola volta. Recuperi così le conversioni che il browser lascia sfuggire, senza doppio conteggio.
Acquisto in server-side: affidabile e non falsificabile
La conversione di acquisto è attivata dagli hook dell’ordine WooCommerce (pagamento completato, in lavorazione, completato), in modo idempotente: un blocco (_dfss_sent) garantisce che lo stesso acquisto non venga mai inviato due volte, anche se si attivano più hook.
- Poiché l’evento parte dal server, nessun ad-blocker né ITP può impedirlo.
- Al contrario, l’endpoint pubblico di raccolta (beacon) esclude volutamente l’evento
purchase: nessuno può iniettare un acquisto falso dal browser per gonfiare i tuoi ricavi Meta o GA4. - Il contesto dell’evento (valore, valuta, prodotti) è autoritativo lato server: il browser non indovina nulla.
Per mantenere l’attribuzione affidabile anche tramite un gateway di pagamento con reindirizzamento, il plugin cattura al checkout i cookie _fbp, _fbc, _ga, _ttp e li allega all’ordine, e imposta cookie first-party di click-id (90 giorni) per trasportare fbc, ttclid e gclid fino all’acquisto.
Gestione del consenso
Il gate di consenso è attivo per impostazione predefinita: nulla viene inviato finché non viene concesso il consenso marketing.
Compatibilità nativa con Cookie Consent v2
Il plugin rileva in modo nativo il modulo DataFirefly Cookie Consent — GDPR & Google Consent Mode v2 e ne legge il cookie di consenso (dfcc_consent) direttamente lato server. Se la categoria marketing viene rifiutata, l’evento viene scartato, qualunque cosa affermi il browser. È la combinazione consigliata: banner, Consent Mode v2 e tracking server-side parlano la stessa lingua.
Altre soluzioni di consenso
In assenza di Cookie Consent v2, il plugin gestisce anche WP Consent API, Complianz, Cookiebot e IAB TCF v2. Puoi mantenere il tuo banner attuale e agganciarci il tracking.
Affidabilità: coda di ritentativi e registro attività
Un evento che non è stato possibile consegnare non è perso: viene messo in coda e riconsegnato automaticamente da un cron ogni 5 minuti.
Il registro attività mostra in tempo reale, senza gergo, ciò che è stato consegnato, ciò che è in coda e ciò che è stato rifiutato, con il codice HTTP e il numero di tentativi. È il tuo primo riflesso diagnostico.
Il cron di WordPress viene eseguito solo con il traffico. Su un negozio a basso traffico, configura un vero cron di sistema che richiami wp-cron.php affinché la coda di ritentativi si svuoti regolarmente.
Sicurezza
- Nessun segreto nel browser: lato client vengono esposti solo identificatori pubblici (pixel, measurement id).
- Il segreto di firma e le tue credenziali di destinazione restano lato server.
- Ogni evento è firmato con HMAC prima di raggiungere il dispatcher, ospitato nell’UE (Germania).
Abbonamento al servizio DataFirefly Server-Side
Il plugin cattura e firma; il servizio DataFirefly Server-Side Tracking ingerisce e diffonde in server-side verso cinque destinazioni: Meta CAPI, GA4 (Measurement Protocol), TikTok Events API, Pinterest Conversions API e Google Ads. Il dispatcher è ospitato in Germania, l’ingestione è firmata con HMAC, i dati personali sono mascherati e l’attivazione rispetta il consenso. Una sola integrazione, una fattura consolidata, più siti possibili.
Scopri i piani e abbonati su server-side.datafirefly.com:
- Starter — 39 €/mese: 1 sito, fino a 500 K eventi
- Growth — 119 €/mese: 5 siti, fino a 2 M eventi
- Scale — 349 €/mese: 20 siti, fino a 10 M eventi
Risoluzione dei problemi
Lo stato resta su «Non connesso»
Verifica che la chiave inizi con dfss_ e che sia stata copiata per intero. Una chiave che punta a un dominio diverso da datafirefly.com (HTTPS) viene rifiutata. Riprova il pulsante Testa l’evento.
L’acquisto non viene registrato
L’acquisto parte dagli hook dell’ordine: assicurati che l’ordine raggiunga uno stato di pagamento (completato / in lavorazione / concluso). Consulta il registro attività per vedere se l’evento è in coda o rifiutato, e verifica il cron se gli eventi si accumulano.
Conversioni contate due volte
Verifica che nessun altro plugin di tracking invii già un purchase concorrente senza un event_id condiviso. Con il solo DataFirefly Server-Side, l’event_id basato sull’ordine garantisce la deduplicazione.
Non parte nulla anche se il consenso sembra concesso
Il gate è attivo per impostazione predefinita. Verifica che la categoria marketing sia effettivamente accettata nella tua soluzione di consenso, e che tale soluzione venga rilevata (Cookie Consent v2, WP Consent API, Complianz, Cookiebot o IAB TCF v2).
Hai bisogno di aiuto? Contatta il supporto DataFirefly dalla tua area cliente, allegando uno screenshot del registro attività (codice HTTP + numero di tentativi).