Agente de IA para GA4: pergunte ao Google Analytics em português

Um agente de IA para GA4 é um software que tem acesso à sua propriedade do Google Analytics, transforma uma pergunta em linguagem natural nas métricas, dimensões e períodos certos, roda o relatório pela Data API e responde em frases. Você para de montar relatórios e passa a fazer perguntas.

A vantagem é óbvia para quem já gastou vinte minutos montando uma exploração para responder algo que daria para falar em voz alta em seis segundos. O risco é igualmente real e bem menos discutido: um agente que escolhe a dimensão errada devolve uma resposta confiante, bem escrita e errada, e nada no resultado parece diferente de uma resposta certa.

Aqui você vai ver como a conexão funciona na prática, o que perguntar, os erros específicos de GA4 que os agentes cometem e quanto isso custa.

O que é um agente de IA para GA4?

São três partes. A conexão, que é o acesso OAuth à sua propriedade com escopo somente leitura. A camada de tradução, que converte "como foi a conversão no mobile no último trimestre" em uma requisição à Data API com os nomes de métricas, de dimensões e o período que o Google espera. E o loop, que permite ao agente olhar o que voltou e decidir se precisa de uma segunda consulta antes de responder.

É essa terceira parte que separa um agente de uma simples caixa de busca em linguagem natural. Pergunte "por que as conversões caíram" e a caixa de busca devolve um gráfico de conversões. Um agente puxa as conversões, percebe que a queda está concentrada em um canal, puxa esse canal por página de destino, encontra duas páginas responsáveis e responde à pergunta que você quis fazer, não à que você digitou ao pé da letra.

Como conectar um agente de IA ao Google Analytics 4

São dois caminhos, e o certo para você depende de você ser profissional de marketing ou desenvolvedor.

Caminho 1: uma conexão OAuth hospedada

O caminho de quem é do marketing. Você autoriza o produto na sua conta Google, escolhe a propriedade, e a conexão fica salva no servidor e é reutilizada em cada consulta. Na nossa própria implementação, o agente verifica se existe uma conexão ativa com o Analytics na primeira chamada de ferramenta de GA4; se não houver, ele não falha nem chuta - mostra um aviso interativo pedindo que você conecte, com link direto para a tela de integrações, e retoma a conversa depois. A propriedade vem das configurações do seu workspace, se você tiver definido uma; caso contrário, é usada a primeira propriedade da conexão.

A configuração leva uns dois minutos e não há nada para instalar. A contrapartida é que você usa o catálogo de ferramentas que o fornecedor construiu.

Caminho 2: MCP

O caminho de quem desenvolve. O Google publica o próprio servidor MCP do Google Analytics, que expõe o GA4 a qualquer cliente compatível com MCP. Ele oferece run_report, run_realtime_report, run_funnel_report, get_account_summaries, get_property_details, get_custom_dimensions_and_metrics e list_google_ads_links. A autenticação é feita com Application Default Credentials no escopo somente leitura do Analytics, o que, na prática, significa ativar as APIs Admin e Data em um projeto do Google Cloud e rodar gcloud auth application-default login.

Duas ressalvas antes de construir em cima disso. O Google classifica o servidor como experimental. E o MCP dá as ferramentas ao seu agente, não o discernimento sobre qual delas chamar - a qualidade do raciocínio continua vindo do modelo e do prompt.

Que perguntas sobre o GA4 você pode fazer em linguagem natural

As que funcionam bem têm o mesmo formato: uma comparação, um segmento e um período com datas fixas.

Compare as conversões da busca orgânica de [período A] com [período B],
divididas por página de destino. Mostre as 10 páginas com a maior variação absoluta.
Sinalize qualquer linha em que as sessões sejam tão poucas que a variação da taxa possa ser ruído.

Quais canais de aquisição melhoraram e quais pioraram em [período],
medindo por conversões, não por sessões? Diga qual evento de conversão você usou.

Em que ponto os usuários desistem antes de concluir [meta] em [período]?
Mostre os números absolutos ao lado das porcentagens.

A diferença entre a taxa de conversão no mobile e no desktop está aumentando ou diminuindo
em relação ao período equivalente anterior? Mostre os dois períodos.

As perguntas que funcionam mal são as abertas demais. "Como o site está indo" gera um resumo de tudo e uma conclusão sobre nada, e ainda sai mais caro, porque um objetivo vago se desdobra em mais consultas do que um preciso.

Quais métricas do GA4 vale a pena automatizar

Automatize as métricas cuja variação sempre exige uma explicação e deixe o resto para quando você perguntar.

Métrica	Por que automatizar	Fique de olho em
Conversões por canal	O número que realmente importa para o negócio	Qual evento de conversão está configurado como principal
Taxa de conversão por página de destino	Separa problemas da página de problemas de tráfego	Denominadores pequenos gerando porcentagens dramáticas
Taxa de engajamento por origem	Pega mudanças de qualidade antes de as conversões se moverem	A definição é diferente da taxa de rejeição do Universal Analytics
Receita por canal	Liga o trabalho ao dinheiro	Modelo de atribuição em uso
Sessões por dispositivo e país	Explica mudanças de composição por trás de uma variação de taxa	Cardinalidade jogando linhas em (other)

Que erros de análise os agentes de IA cometem com dados do GA4

Esta é a seção para ler duas vezes. Cada erro abaixo gera um resultado com cara de totalmente normal.

Tratar cliques e sessões como a mesma coisa. O Search Console conta cliques em um resultado de busca; o GA4 conta sessões depois que a página carrega. Os números nunca vão bater, e um agente que os compara sem avisar vai "descobrir" uma discrepância que é só de definição.

Misturar métricas de escopo de usuário e de escopo de sessão. Dividir uma métrica de escopo de usuário por uma de escopo de sessão gera um número sem significado. Mesmo assim, ele vem formatado com duas casas decimais.

Ignorar (not set) e (other). Dimensões de alta cardinalidade são agrupadas em um balde (other), e o tráfego sem atribuição cai em (not set). Um agente que soma as linhas visíveis e informa um total está excluindo os dois sem dizer nada.

Ler variações percentuais sobre denominadores minúsculos. Duas conversões virando três é uma melhora de 50% e, ao mesmo tempo, não é nada. Sempre peça ao agente para mostrar os números absolutos ao lado das taxas.

Ambiguidade sobre qual evento de conversão. A maioria das propriedades tem vários eventos principais configurados. Se o prompt não nomear um, o agente escolhe, e essa escolha pode mudar de uma execução para outra.

Períodos relativos. "Mês passado" é interpretado de forma diferente dependendo do fuso horário da propriedade e de quando a consulta rodou. Use datas fixas para tudo em que você vai agir.

A defesa é um trecho curto adicionado a qualquer prompt em que os números importam:

Todos os números devem vir da propriedade conectada.
Quando um número não estiver disponível, escreva "não disponível" - nunca estime.
Informe a métrica, a dimensão e o período que você usou para cada número.

A última frase é a mais importante. Ela obriga o agente a mostrar a consulta, o que transforma uma afirmação em que você precisa confiar em uma que você confere em trinta segundos.

Os limites da API do GA4 com que um agente precisa trabalhar

Isso não é curiosidade. Esses limites determinam quais perguntas dá para responder.

Segundo a documentação de cotas da Data API do Google, uma propriedade padrão tem 200.000 tokens principais por propriedade por dia, 40.000 por hora, 14.000 por projeto por propriedade por hora e 10 requisições principais simultâneas. Propriedades do Analytics 360 têm 2.000.000 por dia e 50 requisições simultâneas. O ponto crucial: a complexidade da requisição define o custo em tokens. Mais dimensões, períodos mais longos e cardinalidade mais alta consomem mais cota. Adicionar returnPropertyQuota a uma requisição mostra o consumo em tempo real.

Na prática, um agente solto para explorar à vontade uma propriedade grande pode esgotar a cota do dia em uma tarde, e todos os relatórios que dependem dela falham até a janela reiniciar. Prompts que definem um conjunto enxuto de dimensões e um período específico não são só mais claros - são mais baratos em uma moeda que você não tem como comprar mais.

O que um agente não consegue responder com o GA4

Algumas perguntas não têm resposta na sua propriedade, e a diferença entre um bom agente e um ruim é se ele admite isso.

Qualquer coisa além da sua janela de retenção, em uma exploração. A documentação de retenção de dados do Google define a retenção no nível do usuário e do evento em 2 ou 14 meses nas propriedades padrão, com 14 meses como máximo, a menos que você use o 360. Os dados do Google Signals ficam limitados a 26 meses, independentemente da configuração. O detalhe importante: a retenção afeta explorações e relatórios de funil, não os relatórios agregados padrão - então um agente pode responder legitimamente a uma pergunta sobre a tendência de um canal num período longo e, ao mesmo tempo, não conseguir responder a uma pergunta sobre o caminho do usuário no mesmo período. Se ele não distinguir os dois casos, vai entregar alguma coisa mesmo assim.

Qualquer coisa com limite de dados aplicado. Quando o número de usuários é baixo o bastante para que pessoas possam ser identificadas, o GA4 oculta as linhas. Um agente que soma o que consegue ver e apresenta um total está informando um número abaixo do real sem saber.

Qualquer coisa sobre pessoas que não deram consentimento. Dependendo da sua configuração de consentimento, parte do comportamento é modelada ou simplesmente não existe. Essa lacuna não aparece como erro; aparece como números menores.

Pergunte diretamente ao seu agente: "que parte desta análise é afetada por limites de retenção, limites de dados ou lacunas de consentimento?" Um agente que responde a isso com honestidade é um agente que vale a pena manter.

É seguro dar a um agente de IA acesso ao Google Analytics?

O acesso ao GA4 é uma das integrações mais seguras que você pode liberar, por três motivos estruturais: o escopo é somente leitura, então nada pode ser alterado; o acesso pode ser revogado na sua conta Google a qualquer momento; e o pior resultado possível é uma conclusão errada, que você mesmo pode conferir na propriedade.

Duas coisas ainda merecem atenção. Primeiro, dependendo da sua configuração, os dados do GA4 podem conter dados pessoais, então saiba onde o fornecedor do seu agente processa e armazena os resultados das consultas. Segundo, se o mesmo agente também consegue buscar páginas da web quaisquer, ele pode trazer texto escrito por terceiros para o mesmo contexto das suas instruções - o problema da injeção de prompt. Nosso runtime resolve isso marcando cada ferramenta como leitura, geração ou escrita, isolando o conteúdo buscado como não confiável e recusando ferramentas de escrita pelo resto de qualquer turno em que tenha chegado conteúdo não confiável. Consultas ao GA4 são marcadas como leitura, então não são afetadas de qualquer forma.

Quanto custa uma consulta de um agente ao GA4

São dois componentes. Chamadas de ferramenta: no nosso catálogo, uma consulta ao GA4 custa 50 créditos por chamada, e uma investigação de verdade são várias chamadas, porque o agente puxa, olha e puxa de novo. Tokens do modelo: cobrados a 300 créditos por milhão em todas as chamadas de modelo de um turno, crescendo conforme a quantidade de dados que entra no contexto - é por isso que raciocinar sobre uma consulta que retorna 50 linhas custa bem menos do que sobre uma que retorna 5.000.

A regra que vem daí é a mesma que vale para a cota: precisão sai mais barato que amplitude. "Como o site está indo" é a pergunta mais cara que você pode fazer, em créditos e em cota, e é a que devolve a resposta menos útil.

Um agente pode substituir o Looker Studio?

Não, e o motivo é a reprodutibilidade, não a capacidade. Um dashboard mostra as mesmas métricas no mesmo layout toda vez, que é exatamente o que você quer para monitoramento e para qualquer coisa que um cliente vê com frequência fixa. Um agente pode seguir um caminho diferente para a mesma pergunta em dois dias diferentes.

A divisão que funciona: dashboards respondem o quê e agentes respondem por quê. Você mantém o dashboard para a visão fixa e pergunta ao agente quando o dashboard mostra algo que você não consegue explicar. Para entregas recorrentes especificamente, veja relatórios automatizados de GA4, onde o determinismo importa mais do que a flexibilidade.

Por onde começar

Conecte uma propriedade no modo somente leitura e faça ao agente uma pergunta que você já respondeu manualmente neste trimestre. Compare. Depois peça para ele mostrar a métrica, a dimensão e o período por trás de cada número e confira um deles na interface do GA4. Duas rodadas disso vão dizer mais sobre se dá para confiar na ferramenta do que qualquer material de fornecedor.

O Autopilot implementa o fluxo OAuth, o aviso de conexão e o loop de consultas descritos acima na sua própria propriedade.