Risoluzione dei problemi

Le cause reali dei guasti, nell’ordine in cui si incontrano. Comincia sempre dal pulsante "Diagnose my connection" della pagina del tuo sito.

"Nulla arriva"

Le tre cause, in ordine di probabilità:

  1. 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.
  2. Il sito non è mai stato attivato. Destinazioni non salvate, o pulsante "Activate my tracking" mai cliccato: il modulo riceve dei 401.
  3. Il tracking è disattivato nel modulo. Su PrestaShop e Shopware, "Enable tracking" è OFF di default.

Gli errori 401

ErroreCausa e rimedio
unknown_tenantSito in attesa di attivazione, o Site ID errato
invalid_signatureIl corpo è stato ricodificato tra la firma e l’invio: firma esattamente i byte inviati
timestamp_out_of_windowTimestamp 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

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

"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.

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.

StatoSignificato
Nessun rapporto per oraIl 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.
OKNiente da segnalare.
In ritardoL'evento più vecchio aspetta da più di un'ora.
SilenziosoC'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