# Risoluzione dei problemi

> Risolvere i problemi di DataFirefly Server-Side: nulla arriva, errori 401, webhook Shopify scomparso, duplicati GA4, conversioni Unassigned.

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

---

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

| 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 per `transaction_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](https://server-side.datafirefly.com/it/docs/prestashop.html), [WooCommerce](https://server-side.datafirefly.com/it/docs/woocommerce.html) e [Shopware](https://server-side.datafirefly.com/it/docs/shopware.html)). 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: [support@datafirefly.com](https://server-side.datafirefly.com/it/contact.html), allegando il risultato del pulsante "Diagnose my connection". Rispondiamo entro un giorno lavorativo.

Aggiornato: 1 settembre 2026
