Analytics GA4

O que faz

O Analytics GA4 conecta o Claude Code ao Google Analytics 4 para gerar

relatórios de tráfego e conversão em português, sem você precisar navegar pela

interface (muitas vezes confusa) do GA4. Você pergunta "quantas sessões tive na semana

passada por canal?" ou "quais páginas mais converteram no mês?" e o plugin consulta a

Google Analytics Data API (GA4), organiza os números e entrega uma análise clara,

com comparações e insights acionáveis.

O GA4 organiza tudo em dimensões (origem/mídia, página, dispositivo, país…) e

métricas (sessões, usuários ativos, conversões, receita…). Este plugin sabe montar

consultas válidas à Data API, escolher dimensões e métricas adequadas à sua pergunta e

traduzir o JSON de resposta em tabelas e conclusões.

Casos de uso típicos:

• Resumo semanal/mensal de tráfego por canal de aquisição.
• Páginas mais visitadas e páginas com melhor taxa de conversão.
• Comparação de períodos (este mês vs. mês anterior).
• Funil simples: visitas → eventos-chave → conversões.

Instalação

1. Copie a pasta analytics-ga4/ para o diretório de plugins do Claude Code.
2. No Google Cloud, habilite a Google Analytics Data API e crie uma **conta de

serviço**; baixe o JSON de credenciais.

1. No GA4, conceda à conta de serviço acesso de leitura à propriedade.
2. Defina as variáveis de ambiente (veja Configuração) e reinicie o Claude Code.

O plugin usa a conta de serviço apenas para ler dados de relatório — ele não

altera configurações do GA4.

Comandos disponíveis

• /ga4-resumo — gera um resumo de tráfego de um período (sessões, usuários,

canais, dispositivos) com comparação ao período anterior.

• /ga4-conversoes — analisa conversões/eventos-chave: quais páginas e canais mais

convertem, com taxa de conversão e recomendações.

Configuração

Sempre por nome de variável de ambiente — nunca cole o JSON de credenciais nem IDs

sensíveis no código compartilhado.

• GA4_PROPERTY_ID — obrigatória. ID numérico da propriedade GA4 (ex.: 123456789).
• GOOGLE_APPLICATION_CREDENTIALS — obrigatória. Caminho do arquivo JSON da conta

de serviço com acesso de leitura ao GA4.

• GA4_DEFAULT_RANGE — opcional; período padrão quando não especificado

(ex.: 28daysAgo).

• GA4_TIMEZONE — opcional; fuso para interpretar datas (padrão: America/Sao_Paulo).

Exemplo de uso

/ga4-resumo Últimos 7 dias, por canal de aquisição, comparado à semana anterior.

O Claude consulta a Data API, devolve uma tabela com sessões e usuários por canal,

calcula a variação percentual frente à semana anterior e destaca o que cresceu e o que

caiu. Para conversões:

/ga4-conversoes Quais páginas geraram mais o evento "purchase" no último mês?

Segurança e limites

• Acesso somente leitura. Conceda à conta de serviço apenas permissão de leitura

no GA4. O plugin não altera a propriedade.

• Proteja as credenciais. O JSON apontado por GOOGLE_APPLICATION_CREDENTIALS é

um segredo: mantenha-o fora do controle de versão e com permissões restritas.

• Limites da API. A Data API tem cotas diárias e por minuto. Para muitos

relatórios, agrupe consultas e evite repetições desnecessárias.

• Amostragem e atraso de dados. Dados muito recentes podem estar incompletos

(processamento do GA4) e relatórios grandes podem sofrer amostragem; o plugin

sinaliza quando isso ocorre.

• Privacidade: relatórios agregam dados, mas evite cruzar dimensões a ponto de

identificar usuários individuais (boas práticas de LGPD/GDPR).