"Nulla arriva"
Le tre cause, in ordine di probabilità:
- Il consenso. Se l’opzione "Require consent" è attiva e il tuo sito non ha un banner CMP, o il visitatore non ha dato il consenso, nessun evento parte: è il comportamento previsto, non un guasto. L’indizio che non inganna: il pulsante Send test event funziona (ignora il consenso) ma non arriva nient’altro.
- Il sito non è mai stato attivato. Destinazioni non salvate, o pulsante "Activate my tracking" mai cliccato: il modulo riceve dei 401.
- Il tracking è disattivato nel modulo. Su PrestaShop e Shopware, "Enable tracking" è OFF di default.
Gli errori 401
| Errore | Causa e rimedio |
|---|---|
unknown_tenant | Sito in attesa di attivazione, o Site ID errato |
invalid_signature | Il corpo è stato ricodificato tra la firma e l’invio: firma esattamente i byte inviati |
timestamp_out_of_window | Timestamp in millisecondi invece che in secondi, o orologio del server non sincronizzato (NTP) |
Dopo una rotazione della chiave HMAC
La raccolta resta interrotta finché la nuova chiave non viene incollata nel modulo. È voluto: la rotazione serve precisamente a invalidare la vecchia chiave.
Shopify
- Webhook scomparso: eliminato da Shopify dopo circa 48 ore di fallimenti. Verifica il Site ID nell’URL, ricrea il webhook.
- Ordini duplicati: un webhook "Order creation" è rimasto accanto all’"Order payment". Eliminalo.
WordPress / WooCommerce
Dopo ogni modifica della configurazione, svuota la cache del sito: altrimenti LiteSpeed Cache e le altre estensioni di cache continuano a servire il vecchio JavaScript.
GA4
- Acquisti duplicati: aggiorna il modulo (PrestaShop 1.8.0+, WooCommerce 2.8.0+, Shopware 1.9.0+). GA4 deduplica solo
purchase, e unicamente pertransaction_id: le versioni recenti non inviano più l’acquisto lato browser. - Conversioni "Unassigned": gli eventi inviati portano l’identificativo di sessione e il referrer, il che ricollega le conversioni al loro canale. Lo storico già registrato da GA4 non viene riclassificato: il ricollegamento vale per il traffico futuro.
"Delivered" ma poca attribuzione
Un evento consegnato non è necessariamente attribuito: l’attribuzione dipende dalla qualità della corrispondenza. Arricchisci i dati utente inviati: email, telefono, IP e user agent, cookie fbp e gclid. I moduli DataFirefly li trasmettono automaticamente quando sono disponibili e il consenso lo permette.
Finestre di recupero
Prima di inviare un evento a una piattaforma, DataFirefly ne controlla l'età. La regola è la stessa per un evento in tempo reale, per uno ritrasmesso da un modulo e per uno sbloccato dopo una pausa di quota del piano gratuito.
- Meta, ChatGPT Ads (OpenAI) e Microsoft Advertising: 7 giorni.
- GA4: nessun limite da parte nostra. GA4 accetta gli eventi più vecchi e assegna loro una nuova data; è una scelta deliberata.
- Google Ads, TikTok e Pinterest: nessun limite da parte nostra, decide la piattaforma.
Un evento che ha superato la finestra di una destinazione non viene inviato a quella destinazione. L'Inspector lo mostra come Not sent: too late: al momento dell'invio l'evento era già più vecchio della finestra di accettazione di quella piattaforma.
La coda del modulo
Quando il negozio non riesce a raggiungere DataFirefly, il modulo mette gli eventi in coda e li ritrasmette (vedi le guide PrestaShop, WooCommerce e Shopware). La pagina del tuo sito nell'area clienti mostra questa coda: eventi in attesa, età del più vecchio, ora dell'ultimo rapporto del modulo.
| Stato | Significato |
|---|---|
| Nessun rapporto per ora | Il modulo non ha ancora segnalato nulla. Le versioni precedenti a PrestaShop 1.29.0, WooCommerce 2.30.0 e Shopware 1.23.0 restano in questo stato: aggiorna per vedere la coda. |
| OK | Niente da segnalare. |
| In ritardo | L'evento più vecchio aspetta da più di un'ora. |
| Silenzioso | C'erano eventi in attesa e il modulo non invia rapporti da 2 ore. |
Quando la coda richiede attenzione ricevi un'email, al massimo una ogni 24 ore. Se molti siti vanno in ritardo nello stesso momento, il problema è probabilmente da parte di DataFirefly: le email ai clienti vengono trattenute e viene avvisato solo il nostro team operativo.
Ancora bloccato?
Scrivici: [email protected], allegando il risultato del pulsante "Diagnose my connection". Rispondiamo entro un giorno lavorativo.
Aggiornato: 1 settembre 2026