2026-07-30

Perché BigQuery non riceve i dati da GA4 dopo il collegamento

Hai collegato la tua property GA4 a BigQuery, il link risulta attivo nella sezione Collegamenti a prodotti, ma il dataset è vuoto oppure si è fermato dopo il primo giorno. Hai controllato il progetto Google Cloud, hai aspettato più di 24 ore, e le tabelle events_* semplicemente non arrivano o si sono interrotte senza un motivo apparente.

Perché succede

Le cause più frequenti, in ordine di probabilità:

1. Fatturazione non attiva o carta scaduta sul progetto Google Cloud. È la causa numero uno: BigQuery richiede un account di fatturazione valido collegato al progetto, anche se resti nel free tier. Se il pagamento fallisce, l'export si interrompe silenziosamente senza notifiche evidenti in GA4.
2. Ruoli IAM insufficienti sull'account di servizio Google Analytics. L'export automatico richiede che l'account di servizio firebase-measurement@system.gserviceaccount.com abbia almeno il ruolo BigQuery Data Editor e BigQuery Job User sul progetto scelto.
3. Collegamento configurato ma mai "attivato" davvero. A volte il flusso di configurazione viene interrotto prima del salvataggio finale (manca la selezione della location del dataset, o la frequenza di export non è stata confermata), quindi il link risulta parzialmente creato.
4. Il progetto BigQuery selezionato è sbagliato. Capita spesso in agenzia: si collega GA4 al progetto di test invece che a quello di produzione del cliente, e si continua a controllare il dataset sbagliato.
5. Latenza normale non ancora scaduta. L'export streaming (tabelle events_intraday_*) può richiedere alcune ore dal primo collegamento; l'export giornaliero completo (events_YYYYMMDD) arriva tipicamente entro le 24 ore successive alla fine della giornata di dati, ma nei primi giorni può slittare oltre.
6. Limiti di progetto o quota BigQuery esauriti. Su progetti con quota limitata o con altri job pesanti in corso, l'export può fallire per timeout o superamento quota giornaliera.

Fix, passo dopo passo

1. Vai su Google Cloud Console, apri il progetto collegato e controlla in Fatturazione che l'account di fatturazione sia attivo e non sospeso. Se è sospeso, riattivalo e attendi la sincronizzazione (di solito pochi minuti).
2. In IAM e amministrazione > IAM, cerca l'account di servizio firebase-measurement@system.gserviceaccount.com. Se non esiste, il collegamento non è mai stato completato correttamente: vai al punto 4. Se esiste, verifica che abbia i ruoli BigQuery Data Editor e BigQuery Job User.
3. In BigQuery, controlla di essere nel progetto giusto e cerca un dataset con nome nel formato analytics_<property-id>. Se non lo trovi in nessun progetto a cui hai accesso, il link non ha mai creato l'export.
4. In GA4, apri Amministrazione > Collegamenti a prodotti > Collegamenti BigQuery e controlla lo stato del collegamento esistente. Se è presente ma i dati non arrivano, eliminalo e ricrealo da zero: spesso è più veloce che diagnosticare un link corrotto.
5. Durante la ricreazione, seleziona esplicitamente il progetto Cloud corretto, scegli una location del dataset coerente con eventuali altri dataset del cliente (non puoi cambiarla dopo), e conferma sia l'export giornaliero sia, se ti serve, lo streaming.
6. Salva e attendi almeno 24 ore prima di considerare l'export "fermo". Le prime tabelle intraday possono comparire entro poche ore, quella giornaliera completa no.
7. Se dopo 48 ore il dataset è ancora vuoto, controlla in Cloud Logging (filtro per resource.type="bigquery_resource") eventuali errori di job falliti relativi all'export GA4, che spesso indicano quota superata o permessi mancanti.

Checklist copia-incolla per verificare il collegamento

CHECKLIST VERIFICA GA4 → BIGQUERY

[ ] Fatturazione Google Cloud attiva sul progetto corretto
[ ] Account di servizio firebase-measurement@system.gserviceaccount.com presente in IAM
[ ] Ruolo BigQuery Data Editor assegnato all'account di servizio
[ ] Ruolo BigQuery Job User assegnato all'account di servizio
[ ] Progetto Cloud selezionato in GA4 = progetto corretto del cliente
[ ] Dataset "analytics_" visibile in BigQuery
[ ] Location del dataset coerente con altri asset del cliente
[ ] Export giornaliero attivato nel collegamento GA4
[ ] Export streaming attivato (se richiesto dal caso d'uso)
[ ] Attesa minima 24-48h dal salvataggio del collegamento
[ ] Tabella events_intraday_YYYYMMDD presente (streaming)
[ ] Tabella events_YYYYMMDD presente per il giorno precedente completo
[ ] Nessun job fallito in Cloud Logging (resource.type="bigquery_resource")
[ ] Quota BigQuery del progetto non esaurita

Come verificare che funziona

Apri BigQuery, espandi il dataset analytics_<property-id> e controlla che esista una tabella events_YYYYMMDD per ieri (non l'oggi, che compare solo come intraday). Lancia una query semplice, tipo SELECT COUNT(*) FROM `progetto.analytics_XXXX.events_*` WHERE _TABLE_SUFFIX = FORMAT_DATE('%Y%m%d', DATE_SUB(CURRENT_DATE(), INTERVAL 1 DAY)): se restituisce un numero maggiore di zero, l'export sta funzionando.

Una volta che i dati fluiscono stabilmente in BigQuery, il problema successivo è tipicamente trasformare quelle righe grezze in priorità operative senza scrivere query ogni giorno: è esattamente il compito che Next Action Analyst automatizza a valle, trasformando gli export in azioni ordinate per urgenza.