Agente IA per GA4: Google Analytics risponde a parole

Un agente IA per GA4 è un software che ha accesso alla tua proprietà Google Analytics, trasforma una domanda in linguaggio naturale nelle metriche, dimensioni e intervalli di date giusti, esegue il report tramite la Data API e ti risponde a parole. Smetti di costruire report e inizi a fare domande.

Il fascino è evidente per chiunque abbia passato venti minuti a costruire un'esplorazione per rispondere a qualcosa che avrebbe potuto dire ad alta voce in sei secondi. Il rischio è altrettanto reale, ma se ne parla molto meno: un agente che sceglie la dimensione sbagliata restituisce una risposta sicura, ben scritta e sbagliata, e nulla nell'output la distingue da una corretta.

In questa guida vediamo come funziona davvero il collegamento, cosa chiedere, gli errori tipici che gli agenti commettono con GA4 e quanto costa.

Cos'è un agente IA per GA4?

È fatto di tre parti. Il collegamento, cioè un accesso OAuth alla tua proprietà con ambito di sola lettura. Lo strato di traduzione, che converte «com'è andata la conversione da mobile lo scorso trimestre» in una richiesta alla Data API con i nomi di metriche, dimensioni e l'intervallo di date che Google si aspetta. E il ciclo, che permette all'agente di guardare cosa è tornato indietro e decidere se serve una seconda query prima di rispondere.

È proprio questa terza parte a distinguere un agente da una semplice casella di ricerca in linguaggio naturale. Chiedi «perché sono calate le conversioni?» e la casella di ricerca ti restituisce un grafico delle conversioni. Un agente, invece, estrae le conversioni, nota che il calo è concentrato in un solo canale, analizza quel canale per pagina di destinazione, trova le due pagine che pesano di più e risponde alla domanda che volevi fare, non a quella che hai scritto alla lettera.

Come collegare un agente IA a Google Analytics 4

Le strade sono due, e quale scegliere dipende dal fatto che tu sia un marketer o uno sviluppatore.

Strada 1: un collegamento OAuth gestito

È la strada del marketer. Autorizzi il prodotto con il tuo account Google, scegli la proprietà, e il collegamento viene salvato lato server e riutilizzato a ogni query. Nella nostra implementazione l'agente verifica che ci sia un collegamento ad Analytics attivo alla prima chiamata a uno strumento GA4; se non c'è, non va in errore e non tira a indovinare: ti mostra un invito interattivo a collegarti, con un link diretto alla schermata delle integrazioni, e poi riprende la conversazione da dove l'aveva lasciata. La proprietà viene presa dalle impostazioni del tuo workspace, se ne hai impostata una; altrimenti si usa la prima proprietà del collegamento.

La configurazione richiede un paio di minuti e non c'è nulla da installare. Il compromesso è che usi il catalogo di strumenti costruito dal fornitore.

Strada 2: MCP

È la strada dello sviluppatore. Google pubblica un proprio server MCP di Google Analytics, che espone GA4 a qualsiasi client compatibile con MCP. Mette a disposizione run_report, run_realtime_report, run_funnel_report, get_account_summaries, get_property_details, get_custom_dimensions_and_metrics e list_google_ads_links. L'autenticazione avviene tramite Application Default Credentials con l'ambito Analytics di sola lettura, il che in pratica significa abilitare la Admin API e la Data API in un progetto Google Cloud ed eseguire gcloud auth application-default login.

Due avvertenze prima di costruirci sopra. Google etichetta il server come sperimentale. E MCP dà al tuo agente gli strumenti, non il giudizio su quale usare: la qualità del ragionamento dipende comunque dal modello e dal prompt.

Quali domande su GA4 puoi fare in linguaggio naturale

Quelle che funzionano bene hanno la stessa struttura: un confronto, un segmento e un intervallo di date assoluto.

Compare organic search conversions for [date range A] against [date range B],
broken down by landing page. Show the 10 pages with the largest absolute change.
Flag any row where sessions are low enough that the rate change may be noise.

Which acquisition channels improved and which declined over [date range],
measured by conversions rather than sessions? Name the conversion event you used.

Where do users drop off before completing [goal] over [date range]?
Give raw counts alongside percentages.

Is the gap between mobile and desktop conversion rate widening or narrowing
versus the previous equivalent period? Show both periods.

Le domande che funzionano male sono quelle aperte. «Come sta andando il sito?» produce un riassunto di tutto e una conclusione su niente, e costa pure di più, perché un obiettivo vago si allarga su molte più query di uno preciso.

Quali metriche GA4 conviene automatizzare

Automatizza le metriche i cui movimenti richiedono sempre una spiegazione, e lascia il resto per quando lo chiedi tu.

Metrica	Perché automatizzarla	Attenzione a
Conversioni per canale	È il numero che interessa davvero al business	Quale evento di conversione è impostato come principale
Tasso di conversione per pagina di destinazione	Separa i problemi di pagina dai problemi di traffico	Denominatori piccoli che producono percentuali eclatanti
Tasso di coinvolgimento per sorgente	Intercetta i cambi di qualità prima che si muovano le conversioni	La definizione è diversa dalla frequenza di rimbalzo di Universal Analytics
Entrate per canale	Collega il lavoro ai soldi	Il modello di attribuzione in uso
Sessioni per dispositivo e paese	Spiega i cambi di composizione dietro una variazione di tasso	La cardinalità che fa confluire le righe in (other)

Gli errori di analisi che gli agenti IA commettono con i dati GA4

Questa è la sezione da leggere due volte. Ognuno degli errori qui sotto produce un output che sembra del tutto normale.

Considerare clic e sessioni la stessa cosa. Search Console conta i clic su un risultato di ricerca; GA4 conta le sessioni dopo il caricamento di una pagina. Non coincideranno mai, e un agente che li confronta senza dirlo «scoprirà» una discrepanza che è solo una questione di definizioni.

Mescolare metriche a livello di utente e a livello di sessione. Dividere una metrica a livello di utente per una a livello di sessione produce un numero privo di significato. Che però sarà comunque formattato con due decimali.

Ignorare (not set) e (other). Le dimensioni ad alta cardinalità vengono compresse in un contenitore (other), e il traffico non attribuito finisce in (not set). Un agente che somma le righe visibili e riporta un totale li sta escludendo entrambi senza dirlo.

Leggere variazioni percentuali su denominatori minuscoli. Passare da due a tre conversioni è un miglioramento del 50%, ed è anche niente. Chiedi sempre all'agente di mostrare i valori assoluti accanto ai tassi.

Ambiguità sull'evento di conversione. La maggior parte delle proprietà ha diversi eventi chiave configurati. Se il prompt non ne indica uno, sceglie l'agente, e la scelta può cambiare da un'esecuzione all'altra.

Intervalli di date relativi. «Il mese scorso» viene interpretato in modo diverso a seconda del fuso orario della proprietà e del momento in cui gira la query. Usa date assolute per tutto ciò su cui dovrai agire.

La contromisura è una riga da aggiungere a qualsiasi prompt in cui i numeri contano:

Every figure must come from the connected property.
Where a figure is unavailable, write "not available" - never estimate.
State the metric, dimension and date range you used for each number.

L'ultima frase è quella che conta. Costringe l'agente a mostrare la sua query, e così un'affermazione di cui dovresti fidarti diventa un'affermazione che puoi verificare in trenta secondi.

I limiti dell'API di GA4 con cui un agente deve fare i conti

Non sono dettagli da addetti ai lavori. Stabiliscono quali domande hanno una risposta possibile.

Secondo la documentazione sulle quote della Data API di Google, una proprietà standard dispone di 200.000 token core per proprietà al giorno, 40.000 all'ora, 14.000 per progetto per proprietà all'ora e 10 richieste core simultanee. Le proprietà Analytics 360 arrivano a 2.000.000 al giorno e 50 richieste simultanee. Il punto chiave: è la complessità della richiesta a determinare il costo in token. Più dimensioni, intervalli più lunghi e cardinalità più alta consumano tutti più quota. Aggiungendo returnPropertyQuota a una richiesta vedi il consumo in tempo reale.

La conseguenza pratica è che un agente lasciato libero di esplorare una proprietà grande può esaurire la quota di un giorno in un pomeriggio, e tutti i report a valle falliscono finché la finestra non si azzera. I prompt che indicano un set ristretto di dimensioni e un intervallo preciso non sono solo più chiari: sono più economici in una valuta di cui non puoi comprare altre scorte.

A cosa un agente non può rispondere con GA4

Alcune domande non hanno risposta nella tua proprietà, e la differenza tra un buon agente e uno scadente è se te lo dice o no.

Tutto ciò che va oltre il periodo di conservazione, in un'esplorazione. La documentazione di Google sulla conservazione dei dati fissa la conservazione dei dati a livello di utente e di evento a 2 o 14 mesi sulle proprietà standard, con 14 mesi come massimo a meno che tu non abbia 360. I dati di Google Signals sono limitati a 26 mesi indipendentemente dall'impostazione. La sfumatura importante: la conservazione incide sulle esplorazioni e sui report sulle canalizzazioni, non sui report aggregati standard. Quindi un agente può legittimamente rispondere a una domanda sull'andamento per canale su un lungo periodo e non riuscire invece a rispondere a una domanda sui percorsi degli utenti nello stesso periodo. Se non distingue i due casi, qualcosa te lo tirerà fuori comunque.

Tutto ciò che è soggetto a soglie. Quando il numero di utenti è così basso da rendere identificabili i singoli, GA4 nasconde le righe. Un agente che somma ciò che vede e presenta un totale sta riportando un dato sottostimato senza saperlo.

Tutto ciò che riguarda chi non ha dato il consenso. A seconda di come hai configurato il consenso, una parte del comportamento è modellata o assente. Questo vuoto non compare come errore: compare come numeri più piccoli.

Chiedilo direttamente al tuo agente: «quale parte di questa analisi è influenzata dai limiti di conservazione, dalle soglie o dai vuoti di consenso?». Un agente che risponde onestamente a questa domanda è uno che vale la pena tenere.

È sicuro dare a un agente IA l'accesso a Google Analytics?

L'accesso a GA4 è una delle integrazioni più sicure che puoi concedere, per tre motivi strutturali: l'ambito è di sola lettura, quindi nulla può essere modificato; l'accesso è revocabile in qualsiasi momento dal tuo account Google; e il caso peggiore è una conclusione sbagliata, che puoi verificare tu stesso sulla proprietà.

Due aspetti meritano comunque attenzione. Primo, a seconda della configurazione, i dati GA4 possono contenere dati personali, quindi informati su dove il fornitore dell'agente elabora e conserva i risultati delle query. Secondo, se lo stesso agente può anche scaricare pagine web qualsiasi, può portare testo scritto da terzi nello stesso contesto delle tue istruzioni: è il problema della prompt injection. Il nostro runtime lo gestisce etichettando ogni strumento come lettura, generazione o scrittura, isolando il contenuto scaricato come non affidabile e rifiutando gli strumenti etichettati come scrittura per il resto di qualsiasi turno in cui sia arrivato contenuto non affidabile. Le query su GA4 sono etichettate come lettura, quindi non ne sono toccate in nessun caso.

Quanto costa una query di un agente su GA4

Le voci sono due. Le chiamate agli strumenti: nel nostro catalogo una query GA4 costa 50 crediti per chiamata, e un'analisi vera richiede diverse chiamate, perché l'agente estrae, guarda ed estrae di nuovo. I token del modello: fatturati a 300 crediti per milione su tutte le chiamate al modello in un turno, crescono con la quantità di dati che entra nel contesto. Ecco perché ragionare su una query che restituisce 50 righe costa sensibilmente meno che su una che ne restituisce 5.000.

La regola che ne deriva è la stessa che governa le quote: la precisione costa meno dell'ampiezza. «Come sta andando il sito?» è la domanda più cara che tu possa fare, in crediti e in quota, e restituisce la risposta meno utilizzabile.

Un agente può sostituire Looker Studio?

No, e il motivo è la riproducibilità, non le capacità. Una dashboard mostra le stesse metriche con lo stesso layout ogni volta, ed è esattamente ciò che vuoi per il monitoraggio e per tutto ciò che un cliente vede a scadenza fissa. Un agente, invece, può affrontare la stessa domanda seguendo un percorso diverso in due giorni diversi.

La divisione dei compiti che funziona: le dashboard rispondono al cosa, gli agenti al perché. Tieni la dashboard per la vista fissa e chiedi all'agente quando la dashboard mostra qualcosa che non sai spiegare. Per i deliverable ricorrenti in particolare, leggi report GA4 automatizzati, dove il determinismo conta più della flessibilità.

Da dove cominciare

Collega una proprietà in sola lettura e fai all'agente una domanda a cui hai già risposto a mano in questo trimestre. Confronta i risultati. Poi chiedigli di mostrare la metrica, la dimensione e l'intervallo di date dietro ogni dato, e verificane uno nell'interfaccia di GA4. Due prove così ti diranno se puoi fidarti dello strumento più di qualsiasi materiale del fornitore.

Autopilot implementa il flusso OAuth, l'invito al collegamento e il ciclo di query descritti sopra, direttamente sulla tua proprietà.