Come collegare Google Analytics a Google Sheets - Interrogare le analisi web con SQL

Collega · GA4 a Fogli Google

Ottieni i dati da GA4 in Fogli di Google

Importa i dati in tempo reale dal tuo account GA4 in Fogli Google e aggiornali quando vuoi. Nessun caricamento di file CSV, nessun Apps Script, nessun copia-incolla. La prima volta ci vogliono circa dieci minuti, ed è incluso nel piano gratuito.

Circa 10 minuti Non è necessaria alcuna programmazione. Le credenziali restano con te Qualsiasi browser, qualsiasi dispositivo

Quello che otterrai alla fine

Un foglio Google che mostra i risultati in tempo reale di una query SQL sul tuo account GA4, con un pulsante che visualizza le righe più recenti ogni volta che i dati cambiano. Ad esempio:

Vendite Salvato su Drive

FileModificareVisualizzazioneInserisciFormatoDatiUtensiliEstensioniAiuto

	A	B	C	D	E
1	ID cliente	nome di battesimo	cognome	Paese	totale
2	1042	Maria	Alvarez	U.S.A.	1,284.50
3	1043	Daniel	Okafor	U.S.A.	612.00
4	1047	Priya	Nair	U.S.A.	2,090.75
5	1051	Tommaso	Berg	U.S.A.	338.20
6	1056	Lucia	Ferreira	U.S.A.	1,455.00
7	1060	Kenji	Sato	U.S.A.	874.10
8

+ clienti Foglio1 In diretta da GA4

Google Analytics 4 protegge i tuoi dati tramite la sua API. Importarli in Fogli Google di solito significa esportare un file CSV dalla dashboard di GA4 ogni volta che hai bisogno di dati aggiornati. Query Streams elimina questo passaggio: un piccolo programma di supporto chiamato Agent esegue la query direttamente dove si trovano i tuoi dati e un componente aggiuntivo per Fogli Google richiede le righe desiderate. Solo i risultati vengono trasmessi, tramite un link crittografato, e Fogli Google può essere consultato ovunque: su qualsiasi browser e dispositivo.

Cosa ti servirà

Un account Query Streams

Il piano gratuito è sufficiente per questa guida. Registrati su my.querystreams.com.

L'agente su qualsiasi computer sempre acceso

Un piccolo programma che viene eseguito in background e richiama GA4 quando Google Sheets lo richiede. Richiede solo una connessione a Internet.

Le tue credenziali di accesso GA4

Dovrai accedere a GA4 una sola volta e consentire l'accesso in lettura. Non è necessario inserire password in Query Streams.

Collegalo in cinque passaggi

1. Crea il tuo account

   Vai a my.querystreams.com e iscriviti. Scegli il Gratuito piano. Si tratta di un piano reale, non di una versione di prova, che include la connessione al tuo account GA4 e l'esecuzione di query da Fogli Google.

2. Installa l'agente su qualsiasi computer sempre acceso.

   Accedi, apri Scaricamentoe installa l'agente su qualsiasi computer o server sempre acceso con accesso a Internet. L'operazione richiede un minuto e da quel momento in poi si avvia automaticamente.

   Perché un piccolo programma invece di un driver? L'Agent è un'unica installazione per Windows, Mac o Linux (circa 85 MB su Windows, poco più di 100 MB su Mac e Linux) che funziona silenziosamente in background. Stabilisce una connessione in uscita crittografata con Query Streams, nello stesso modo di un browser, quindi non è necessario aprire porte del firewall né configurare una VPN. Le chiavi rimangono sul computer e le righe vengono inviate ovunque vi troviate, anche tramite Internet se necessario. L'unico componente aggiuntivo di cui dovrete occuparvi è l'Agent stesso.

   La pagina di download mostra La tua chiave di accesso. Incollalo nell'Agente quando richiesto e attendi che il badge venga letto Connesso ai flussi di queryQuesta è l'unica operazione che si esegue sull'agente stesso.

   Se volete, potete trovare le guide complete: Finestre, Mac, Linux.

3. Collegalo al tuo account GA4

   Torna al tuo browser, apri Agenti dati (Sotto Dati nel menu in alto). Il tuo agente è elencato lì. Fai clic Aggiungi connettore e scegliere Google Analytics 4Hai bisogno prima delle tue credenziali GA4? Apri la procedura guidata, quindi inseriscile:

   Crea le tue credenziali GA4 (circa 15 minuti)

   Continuate a seguire questi passaggi con Google Analytics 4 aperto in un'altra scheda. Query Streams conserva i dati che create qui, in modo che il vostro agente possa utilizzarli, e legge esclusivamente da Google Analytics 4.

   Chi può farlo?

   Google Analytics: Amministratore sulla proprietà GA4 o sul relativo account (necessario per aggiungere l'account di servizio). Google Cloud: Proprietario del progetto (sei il proprietario di qualsiasi progetto che crei) oppure i ruoli Crea account di servizio, Amministratore chiave account di servizio e Amministratore utilizzo servizio su di esso.

   Raccomandato

   Chiave JSON dell'account di servizio Google Cloud (un file .json di tipo service_account), con l'account di servizio aggiunto come Viewer sulla proprietà GA4

   Prima di iniziare

   • Una proprietà GA4. Il suo ID proprietà è un semplice numero. Un ID di monitoraggio UA- indica una vecchia proprietà di Universal Analytics, che l'API di Google non è in grado di leggere.
   • È necessario un account Google con il ruolo di amministratore per quella proprietà GA4. Se non lo si possiede, è possibile eseguire la parte relativa a Google Cloud (passaggi da 1 a 13) e chiedere a un amministratore di eseguire i passaggi da 14 a 19.
   • Un progetto Google Cloud che puoi gestire o l'autorizzazione per crearne uno. Se l'organizzazione Google Cloud della tua azienda è stata creata a partire dal 3 maggio 2024, Google blocca per impostazione predefinita il download delle chiavi e potrebbe essere necessario autorizzarlo da parte dell'amministratore di Google Cloud (vedi Problemi comuni).
   • La procedura guidata Query Streams si apre in un'altra scheda (Agenti dati → Aggiungi connettore → Google Analytics 4) con il tuo agente online.

   Passaggi

   1. Apri la pagina Nuovo progetto in Google Cloud

      Accedi con il tuo account Google e apri la pagina Nuovo progetto di Google Cloud.

      Hai già un progetto Google Cloud che desideri utilizzare? Passa direttamente al passaggio 3 e selezionalo da lì. La prima volta che apri Google Cloud, Google potrebbe chiederti di specificare il tuo Paese e di accettare i Termini di servizio prima di visualizzare la pagina.

   2. Assegna un nome e crea il progetto

      Nel campo "Nome progetto", digita un nome come "Query Streams GA4". Lascia il campo "Organizzazione" o "Posizione" così come viene compilato da Google (non inserire alcuna organizzazione va bene). Fai clic su "Crea".

      Google non richiede un account di fatturazione per creare il progetto. La creazione richiede da pochi secondi a un minuto.

   3. Seleziona il progetto

      Fai clic sul selettore del progetto nella parte superiore della pagina, accanto al logo di Google Cloud, e fai clic sul nome del tuo progetto. Tutti i passaggi di Google Cloud descritti di seguito vengono eseguiti all'interno di questo progetto.

      L'errore più comune è quello di abilitare l'API in un progetto e creare la chiave in un altro. Verifica il nome del progetto nella parte superiore della pagina prima di ogni passaggio in Google Cloud.

   4. Abilita l'API di Google Analytics

      Apri la pagina dell'API di Google Analytics nella Libreria API. Verifica che il nome del tuo progetto venga visualizzato in alto, quindi fai clic su Abilita.

      Seleziona l'API Google Analytics Data, non l'API Google Analytics Reporting, che funziona solo con le vecchie proprietà di Universal Analytics. Se il pulsante mostra "Gestisci" anziché "Abilita", l'API è già attiva. Questa API fornisce anche il report in tempo reale di GA4, quindi non è necessario abilitare nulla di aggiuntivo per la tabella realtime_active_users.

   5. Abilita l'API di amministrazione di Google Analytics (consigliato)

      Apri la pagina dell'API di amministrazione di Google Analytics nella Libreria API e fai clic su Abilita.

      La sincronizzazione non richiede questa API. Essa alimenta il pulsante Rileva accanto a ID proprietà GA4 nella procedura guidata Query Streams, che elenca le proprietà che l'account di servizio può visualizzare. Saltare questo passaggio se si intende inserire manualmente l'ID proprietà.

   6. Apri un account di servizio

      Apri la pagina degli account di servizio. In alternativa, dall'interno di Google Cloud puoi aprire il menu di navigazione (tre linee in alto a sinistra) e selezionare IAM e amministrazione → Account di servizio. Fai clic su + Crea account di servizio.

      Hai già creato un account di servizio per il connettore di Google Search Console di Query Streams? Puoi usarlo anche qui: segui i passaggi 4 e 5 del relativo progetto, quindi vai al passaggio 14 con l'indirizzo email e la chiave forniti.

   7. Assegna un nome all'account di servizio

      Nel campo "Nome account di servizio", digita query-streams-ga4. Google compilerà automaticamente il campo "ID account di servizio" a partire da questo. La descrizione è facoltativa. Fai clic su "Crea e continua".

      L'ID non può essere modificato in seguito. Diventa la prima parte dell'indirizzo email dell'account di servizio.

   8. Salta i ruoli del progetto

      La sezione successiva propone i ruoli disponibili nel progetto. Lascia vuoto il campo relativo al ruolo e fai clic su Continua.

      Non assegnare qui i ruoli di Proprietario, Editor o Visualizzatore all'account di servizio. L'accesso a Google Analytics viene concesso all'interno di Google Analytics al passaggio 18. Un ruolo di progetto non ha alcun effetto su Google Analytics e amplia solo le funzionalità della chiave in Google Cloud.

   9. Completare la creazione dell'account di servizio

      Lascia vuota l'ultima sezione (persone che possono utilizzare o gestire l'account di servizio) e fai clic su Fine. Tornerai all'elenco degli account di servizio.

   10. Copia l'email dell'account di servizio

       Nell'elenco, individua il nuovo account. Il suo indirizzo email ha un formato simile a [email protected]. Copialo e conservalo per il passaggio 17.

       Copia l'intero indirizzo, fino a .iam.gserviceaccount.com. La creazione di un nuovo account di servizio potrebbe richiedere un minuto o più prima di essere utilizzabile.

   11. Apri la scheda Tasti

       Fai clic sull'indirizzo e-mail dell'account di servizio, quindi fai clic sulla scheda Chiavi.

   12. Avvia una nuova chiave

       Fai clic su Aggiungi chiave, quindi scegli Crea nuova chiave.

       Se Google segnala che la creazione della chiave dell'account di servizio è disabilitata, la tua organizzazione blocca il download della chiave. Consulta la sezione Problemi comuni.

   13. Scarica la chiave JSON

       Seleziona JSON come tipo di chiave e fai clic su Crea. Il tuo browser scaricherà un file .json con il nome del tuo progetto, solitamente nella cartella Download.

       Questo download avviene una sola volta: Google non conserva alcuna copia e non è possibile scaricare nuovamente il file. Se lo perdi, crea una nuova chiave ed elimina quella vecchia. Non scegliere P12. Mantieni il file privato. Non inviarlo via email né inserirlo in una cartella condivisa, perché chiunque lo possieda può leggere i tuoi dati di Analytics. Query Streams lo memorizza per il tuo agente e lo legge solo tramite esso.

   14. Apri la sezione Amministrazione di Google Analytics

       Apri Google Analytics e fai clic su Amministrazione (l'icona a forma di ingranaggio in basso a sinistra). Nella parte superiore della pagina, verifica che il selettore di account e proprietà mostri la proprietà GA4 che desideri leggere.

       Per aggiungere utenti è necessario disporre del ruolo di Amministratore su questa struttura o sul relativo account. Se non lo possiedi, invia l'e-mail del passaggio 10 a qualcuno che lo detiene e chiedigli di eseguire i passaggi da 15 a 19.

   15. Gestione degli accessi alla proprietà aperta

       Nella sezione Impostazioni proprietà, nel gruppo Proprietà, fare clic su Gestione accesso proprietà.

       Utilizza la gestione degli accessi alle proprietà, non la gestione degli accessi agli account. Gli accessi aggiunti a livello di account si applicano a tutte le proprietà dell'account.

   16. Aggiungi un utente

       Fai clic sul pulsante blu + in alto a destra e scegli Aggiungi utenti.

   17. Inserisci l'indirizzo email dell'account di servizio

       Incolla l'indirizzo email dell'account di servizio dal passaggio 10 nella casella email. Deseleziona "Notifica i nuovi utenti tramite email".

       Nessuno legge la casella di posta di quell'indirizzo, quindi non ha senso inviare una notifica. Se GA4 risponde con "Questo indirizzo email non corrisponde a un account Google" o "Impossibile aggiungere l'utente: indirizzo email non trovato", consulta la sezione "Problemi comuni". Google ha riscontrato un problema noto con gli account di servizio appena creati da aprile 2026 e, per molti utenti, attendere qualche ora ha risolto il problema.

   18. Scegli il ruolo di spettatore

       Nell'elenco dei ruoli, scegli Visualizzatore. Lascia deselezionate le restrizioni sui dati "Nessuna metrica di costo" e "Nessuna metrica di ricavo".

       È sufficiente la modalità Viewer, poiché Query Streams legge solo i report. Senza l'opzione "Nessuna metrica di ricavo" selezionata, Google restituisce 0 in ogni colonna relativa ai ricavi delle tabelle ecommerce_overview e transactions.

   19. Aggiungi l'account di servizio

       Fai clic su Aggiungi in alto a destra. L'account di servizio ora appare nell'elenco degli utenti della struttura con il ruolo Visualizzatore.

       Su alcune schermate questo pulsante è etichettato come Crea.

   20. Copia l'ID della proprietà

       Torna alla schermata Amministrazione. Nella sezione Impostazioni proprietà, nel gruppo Proprietà, fai clic su Dettagli proprietà. In alto a destra, ID PROPRIETÀ mostra un numero come 486480978. Fai clic sull'icona di copia accanto ad esso.

       Utilizza questo numero, non l'ID della misurazione (che inizia con G-) e non l'ID dell'account. Lo stesso numero appare nella barra degli indirizzi di GA4 dopo la lettera p, ad esempio …/p486480978/….

   21. Copia l'intero file chiave

       Apri il file .json del passaggio 13 in un editor di testo semplice. Su Windows, fai clic con il pulsante destro del mouse sul file e scegli Apri con → Blocco note. Su Mac, fai clic tenendo premuto il tasto Control e scegli Apri con → TextEdit. Premi Ctrl+A, quindi Ctrl+C (Cmd+A, quindi Cmd+C su Mac).

       Copia tutto dalla prima { all'ultima }. Non riscrivere né modificare alcuna parte. La riga private_key deve rimanere esattamente come l'ha scritta Google.

   Autorizzazioni a concedere

   Risorsa	Accesso	Utilizzato per
   Ruolo della proprietà in Google Analytics: Visualizzatore (Gestione dell'accesso alla proprietà)	Spettatore	Ogni tabella ga4: traffic_overview, traffic_sources, geographic_data, page_views, user_engagement, events, ecommerce_overview, transactions e realtime_active_users. Il test di connessione legge anche l'elenco dei campi della proprietà.
   Restrizione dei dati: nessuna metrica di fatturato	Non selezionato	Colonne relative ai ricavi in ecommerce_overview (purchase_revenue, total_revenue, average_purchase_revenue) e transactions (item_revenue). Se selezionata, Google restituisce 0 in questi campi.
   Restrizione dei dati: metriche di costo nulle	Non selezionato (consigliato)	Attualmente, nessuna tabella di Query Streams legge le metriche di costo, quindi questa opzione non crea problemi al momento. Lasciandola deselezionata, tutti i dati relativi ai costi rimangono leggibili.
   API di Google Cloud: API di Google Analytics per i dati	Abilitato	Ogni tabella ga4 e connessione di test. Il report in tempo reale dietro realtime_active_users fa parte della stessa API.
   API di Google Cloud: API di amministrazione di Google Analytics	Abilitato (facoltativo)	Solo il pulsante Rileva accanto a ID proprietà GA4, che elenca le proprietà che l'account di servizio può visualizzare. Nessuna tabella può leggerlo.
   Ruolo di progetto Google Cloud per l'account di servizio	Nessuno	Non necessario per alcuna tabella. L'accesso a Google Analytics è consentito solo al ruolo Visualizzatore sopra indicato.
   Ambito OAuth https://www.googleapis.com/auth/analytics.readonly	Richiesto dall'agente (non devi impostare nulla)	Ogni tabella ga4, Test connessione e Rileva. Si tratta dell'ambito di sola lettura di Google Analytics, quindi la chiave non può modificare nulla in Google Analytics.

   Incolla nei flussi di query

   Chiave JSON dell'account di servizio

   L'intero contenuto del file .json che hai copiato al passaggio 21, dalla prima { all'ultima }. Quando modifichi un connettore in seguito, lascia questa casella vuota per mantenere la chiave memorizzata oppure incolla un file completamente nuovo per sostituirla.

   ID proprietà GA4

   Il numero che hai copiato al passaggio 20, solo cifre (ad esempio 486480978). Oppure fai clic su Rileva accanto alla casella e seleziona la tua proprietà dall'elenco. La funzione Rileva richiede l'API di amministrazione del passaggio 5 e un agente online.

   Problemi comuni

   Il test di connessione non riesce con l'errore "Tipo di chiave non valido. Previsto 'service_account'".

   Perché: Il file incollato non è una chiave di account di servizio. Solitamente si tratta di un file client OAuth (denominato come client_secret_….json) o di una chiave API che si trova in API e servizi → Credenziali.

   Aggiustare: Crea una chiave JSON sull'account di servizio (passaggi da 11 a 13) e incolla il file. Una chiave dell'account di servizio contiene la riga "type": "service_account".

   Il test di connessione fallisce a causa di un formato JSON non valido o di un campo 'private_key' mancante o vuoto.

   Perché: È stata copiata solo una parte del file oppure il testo è stato modificato durante la copia.

   Aggiustare: Apri nuovamente il file in Blocco note o TextEdit, premi Ctrl+A (Cmd+A su Mac), copia e incolla il contenuto in Service Account JSON Key senza inserire nulla prima o dopo.

   Il test di connessione non riesce con l'errore "Accesso negato - L'utente non dispone di autorizzazioni sufficienti per questa proprietà".

   Perché: L'account di servizio non è stato aggiunto a questa struttura, è stato aggiunto a una struttura diversa oppure l'ID della struttura appartiene a un'altra struttura. Questo problema si verifica anche per alcuni minuti subito dopo l'aggiunta dell'account di servizio.

   Aggiustare: Apri la proprietà i cui dettagli mostrano lo stesso ID proprietà e verifica che l'indirizzo email dell'account di servizio sia presente nell'elenco della gestione degli accessi alla proprietà con Viewer (passaggi da 14 a 19). Attendi da 5 a 10 minuti, quindi fai clic di nuovo su Test.

   Il test di connessione fallisce con un messaggio di errore "Forbidden" che indica che l'API di Google Analytics Data non è stata utilizzata nel progetto in precedenza o è disabilitata.

   Perché: L'API Data non è abilitata nel progetto Google Cloud a cui appartiene la chiave. Il progetto è specificato nella riga project_id del file della chiave.

   Aggiustare: Seleziona quel progetto in Google Cloud, abilita l'API di Google Analytics (passaggio 4), attendi qualche minuto e fai di nuovo clic su Test.

   Il test di connessione fallisce con il seguente errore: Formato ID proprietà non valido: 'G-…'. Dovrebbe essere numerico, oppure la proprietà '…' non è stata trovata.

   Perché: Al posto dell'ID della proprietà è stato inserito l'ID della misurazione (G-…), un vecchio ID di tracciamento UA o un numero digitato in modo errato.

   Aggiustare: Copia il numero visualizzato sotto ID PROPRIETÀ nella pagina dei dettagli della proprietà (passaggio 20) e incollalo in GA4 ID proprietà.

   Google Analytics non accetta l'indirizzo email dell'account di servizio: questo indirizzo email non corrisponde a un account Google oppure Impossibile aggiungere l'utente: indirizzo email non trovato.

   Perché: Un problema noto di Google: dalla fine di aprile 2026, GA4 e Search Console a volte non riconoscono gli account di servizio appena creati per un certo periodo. Le segnalazioni sono continuate fino a settembre 2026. Un errore di battitura o uno spazio nell'indirizzo causano lo stesso messaggio.

   Aggiustare: Incolla nuovamente l'indirizzo senza spazi. Se viene ancora rifiutato, attendi qualche ora e riprova. Un account di servizio creato in precedenza di solito funziona, quindi se ne possiedi uno, crea una nuova chiave per esso (passaggi da 11 a 13) e aggiungi quell'indirizzo email. Un amministratore che ha familiarità con Google API Explorer può anche aggiungere l'account di servizio tramite il metodo accessBindings.create dell'API di amministrazione e il ruolo predefinedRoles/viewer.

   Google Cloud mostra che la creazione della chiave dell'account di servizio è disabilitata quando si fa clic su Crea nuova chiave.

   Perché: La tua organizzazione applica la policy iam.disableServiceAccountKeyCreation. Google la attiva per impostazione predefinita per le organizzazioni create a partire dal 3 maggio 2024.

   Aggiustare: Chiedi al tuo amministratore di Google Cloud (una persona con il ruolo di Amministratore delle politiche dell'organizzazione) di autorizzare la creazione di chiavi per questo progetto o account di servizio. Google documenta un'esenzione basata su tag per un progetto o account di servizio. Quindi ripeti i passaggi 12 e 13.

   Detect segnala che non sono state trovate proprietà GA4 oppure indica che l'API di amministrazione di Google Analytics non è stata utilizzata nel progetto.

   Perché: L'API di amministrazione non è abilitata (passaggio 5) oppure l'account di servizio non è stato ancora aggiunto ad alcuna proprietà.

   Aggiustare: Abilita l'API di amministrazione e completa i passaggi da 14 a 19, quindi fai di nuovo clic su Rileva. In alternativa, puoi sempre digitare manualmente l'ID proprietà.

   Le tabelle ecommerce_overview e transactions sono sincronizzate, ma tutte le colonne relative ai ricavi sono pari a 0.

   Perché: L'account di servizio è stato aggiunto con la restrizione "Nessun dato sulle metriche di fatturato".

   Aggiustare: Nella sezione Gestione accessi alla proprietà, apri la voce relativa all'account di servizio, deseleziona "Nessuna metrica di ricavo" e salva. La sincronizzazione successiva leggerà i valori effettivi.

   Un connettore che prima funzionava smette di sincronizzarsi, con un errore che menziona invalid_grant o Invalid JWT Signature.

   Perché: La chiave è stata eliminata o disabilitata in Google Cloud. Google disabilita anche le chiavi che trova esposte pubblicamente.

   Aggiustare: Crea una nuova chiave (passaggi da 11 a 13). In Query Streams, apri il connettore in Data Agents, fai clic su Modifica, incolla l'intero nuovo file in Chiave JSON dell'account di servizio, fai clic su Verifica connessione, quindi fai clic su Salva modifiche. Elimina la vecchia chiave in Google Cloud.

   La sincronizzazione fallisce con l'errore 429 o RESOURCE_EXHAUSTED.

   Perché: La proprietà ha esaurito la sua quota API di Google Analytics. Ogni app che legge questa proprietà tramite l'API utilizza la stessa quota per proprietà.

   Aggiustare: Attendi: la quota oraria si ricarica entro un'ora, mentre la quota giornaliera si azzera a mezzanotte (ora del Pacifico). Disattiva i tavoli che non utilizzi o sincronizzali meno frequentemente.

   Desideri che Query Streams smetta di leggere questa proprietà.

   Perché: L'eliminazione del connettore non revoca l'accesso a Google. L'account di servizio rimane un utente Viewer e la chiave rimane valida.

   Aggiustare: Nella gestione degli accessi alla proprietà, rimuovi l'account di servizio. In Google Cloud, apri la scheda Chiavi dell'account di servizio ed elimina la chiave. Infine, elimina il connettore in Data Agents.

   Limiti da conoscere

   • Aggiornamento dei dati: l'elaborazione giornaliera di GA4 può richiedere dalle 24 alle 48 ore e i dati relativi ai giorni più recenti potrebbero subire variazioni. Ogni sincronizzazione delle tabelle giornaliere rilegge i dati degli ultimi 3 giorni, pertanto i numeri meno recenti vengono aggiornati automaticamente. I dati in tempo reale arrivano in pochi minuti.
   • Finestra in tempo reale: il report in tempo reale di GA4 copre solo gli ultimi 30 minuti (60 minuti su Analytics 360). La tabella realtime_active_users è un'istantanea che viene sostituita a ogni aggiornamento (ogni 5 minuti per impostazione predefinita), non una cronologia. Utilizza la stessa API, chiave e accesso Viewer delle altre tabelle, con una propria quota in tempo reale separata.
   • Quota API per una proprietà standard: 200.000 token al giorno e 40.000 all'ora per l'intera proprietà, 14.000 all'ora da un singolo progetto Google Cloud e 10 richieste alla volta. La maggior parte delle richieste costa 10 token o meno. Le proprietà di Analytics 360 hanno un limite 10 volte superiore. La quota giornaliera si azzera a mezzanotte, ora del Pacifico.
   • Cronologia: la prima sincronizzazione richiede tutti i dati a partire da ottobre 2020, data di lancio di GA4. Google restituisce i dati solo a partire dalla data di inizio della raccolta dati per la tua proprietà. Le proprietà di Universal Analytics (UA-) non possono essere lette tramite questa API.
   • Una proprietà per connettore: l'ID proprietà seleziona una proprietà GA4. Per leggere un'altra proprietà, aggiungi lo stesso account di servizio utilizzato per il visualizzatore e crea un secondo connettore. La stessa chiave funziona per entrambi.
   • Chiavi: la chiave di un account di servizio non scade mai, a meno che la tua organizzazione non imposti una durata massima. Ogni account di servizio può avere fino a 10 chiavi e il file della chiave può essere scaricato una sola volta.
   • Restrizioni sui dati: se l'account di servizio non ha metriche di ricavo o metriche di costo, Google restituisce 0 per tali metriche anziché un errore.

   Passaggi verificati l'8 ottobre 2026. Fonti: developers.google.com/analytics/devguides/reporting/data/v1, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/config/admin/v1…, developers.google.com/analytics/devguides/config/admin/v1…, developers.google.com/analytics/devguides/config/admin/v1…, developers.google.com/workspace/guides/create-project, docs.cloud.google.com/resource-manager/docs/creating-mana…, docs.cloud.google.com/service-usage/docs/enable-disable, docs.cloud.google.com/iam/docs/service-accounts-create, docs.cloud.google.com/iam/docs/keys-create-delete, docs.cloud.google.com/iam/docs/service-account-creds, docs.cloud.google.com/iam/docs/troubleshoot-org-policies, docs.cloud.google.com/iam/docs/best-practices-for-managin…, support.google.com/googleapi/answer/6158841?hl=en, support.google.com/analytics/answer/9305788?hl=en, support.google.com/analytics/answer/9305587?hl=en, support.google.com/analytics/answer/9304776?hl=en, support.google.com/analytics/answer/11198161?hl=en, docs.ovhcloud.com/en/guides/public-cloud/data-platform/co…, windsor.ai/documentation/how-to-connect-ga4-to-windsor-ai…, seopress.org/support/guides/find-my-google-analytics-4-pr…, analytify.io/add-user-to-google-analytics, optimizesmart.com/blog/google-analytics-4-measurement-id-…, discuss.google.dev/t/problem-with-new-service-accounts/36…, piunikaweb.com/2026/05/01/google-service-account-email-no…, sanj.dev/post/google-analytics-search-console-service-acc…, oneuptime.com/blog/post/2026-01-24-gcp-service-account-ke…, help.genesys.cloud/articles/data-action-returns-a-400-error.

   Nome della società

   Un nome che riconoscerai in seguito, come ad esempio "Database delle vendite".

   Chiave JSON dell'account di servizio

   Incolla il contenuto del file chiave per un account di servizio Google che è stato aggiunto come visualizzatore sulla tua proprietà GA4.

   ID proprietà GA4

   Il numero che identifica la tua proprietà GA4, che si trova nell'area di amministrazione di GA4 alla voce Impostazioni proprietà, ad esempio 486480978.

   Cliccare Verifica la connessioneQuando legge Collegato, clicca RisparmiareLa connessione raggiunge il tuo agente in pochi secondi.

   Agenti di dati aperti

   Test fallito? Solitamente si tratta di un'autorizzazione mancante o di credenziali provenienti dall'account GA4 sbagliato. La procedura guidata sopra elenca problemi comuni e le relative soluzioni.

4. See your data in Query Builder Opzionale

   You can look at your GA4 account before Google Sheets is involved at all. Open Generatore di query in the portal and pick the connection you just made. The Schema tab lists your tables and columns, and clicking one puts its name in the editor, so you can write a query without remembering exact names. Click Correre and the rows appear under Risultati. Query Builder is on every plan, Free included.

   On Business plans you can also ask Nova in plain English (“show me customers in the USA”) and it writes the SQL for you. When the query looks right, save it: from Personal Core up it shows in the add-on’s Saved Queries list, and on any plan you can copy the SQL into the next step.

5. Aggiungere Query Streams a Fogli Google

   Apri un qualsiasi foglio Google, vai a Estensioni → Componenti aggiuntivi → Ottieni componenti aggiuntivi, cerca Flussi di querye clicca InstallareOppure installalo direttamente da Query Streams sul Google Workspace MarketplaceGoogle ti chiederà di autorizzare l'installazione del componente aggiuntivo; è normale.

   Successivamente è presente in ogni Foglio Google che apri: un'icona di Query Streams nel pannello laterale a destra, elencata anche sotto EstensioniNon è necessario effettuare un accesso separato. Il sistema riconosce l'account Google che già utilizzi, quindi l'indirizzo email deve essere lo stesso associato al tuo account Query Streams.

6. Porta il tuo primo tavolo

   Fai clic sull'icona Query Streams nel pannello laterale a destra del foglio (oppure trovala sotto Estensioni). Scegliere Streamer di query e seleziona la connessione appena stabilita.

   Digita la query che vuoi eseguire. Questa estrae alcune colonne da un ga4_traffic_overview tavolo:

   Esempio · SQL

   SELECT date, sessions, total_users, screen_page_views FROM ga4.traffic_overview ORDER BY date DESC LIMIT 100;

   Sotto Scheda di destinazione seleziona la scheda in cui devono finire le righe, quindi fai clic Eseguire la queryLe righe vengono visualizzate in quella scheda in uno o due secondi. Fai clic su "Esegui query" ogni volta che i dati sono cambiati e la scheda si aggiornerà automaticamente.

   Non conosci SQL? Build it in Generatore di query first and paste it here, or pick it from Saved Queries if you saved it.

Buone mosse successive

• Salva la query nel portale, così puoi eseguirlo di nuovo con un solo clic, da Fogli Google o Excel.
• Aggiungi un filtro come ad esempio un intervallo di date, in modo che la stessa query possa rispondere "questo mese" senza modifiche.
• Condividi i risultati con un collega. Loro vedono le righe, non le tue credenziali.

Domande che le persone si pongono

Guide correlate

• Da Google Analytics 4 a Microsoft Excel
• Stripe su Fogli Google
• Da HubSpot a Fogli Google
• Da Shopify a Fogli Google
• Power Query per Google Sheets
• Tutte le guide