Configurar Google Analytics 4 — Ratos de IA
🐀
Ratos de IA · Ads Ratos
Configurar Google Analytics 4
Progresso
0 de 4

Tu já tem o projeto no Google Cloud Console configurado (do setup do Google Ads). Agora é só ativar a API do GA4, adicionar o escopo e deixar o Claude fazer o resto. Leva uns 5 a 10 minutos.

Antes de começar
1
Passo 1 de 4

Ativar a API do Google Analytics

Volta no mesmo projeto que tu criou pro Google Ads e ativa a API do GA4.

Ativando a API
1
Acessa console.cloud.google.com e seleciona o mesmo projeto que tu criou pro Google Ads (tipo "Google Ads API" ou "Ads Ratos")
2
Vai no menu lateral: APIs e Serviços > Biblioteca
3
Pesquisa "Google Analytics Data API" (cuidado: é "Data API", não "Admin API" nem "Analytics API" genérico)
4
Clica no resultado e depois em "Ativar"
💡 A API do GA4 é separada da do Google Ads. Mesmo projeto, mas precisa ativar cada uma individualmente.
2
Passo 2 de 4

Adicionar o escopo do GA4 no OAuth

Agora tu precisa adicionar a permissão de leitura do GA4 nas credenciais OAuth que tu já criou.

Adicionando o escopo
1
No Google Cloud Console, vai em APIs e Serviços > Tela de consentimento OAuth
2
Clica em "Editar app" (ou "Edit App")
3
Avança até a tela de Escopos (clica "Salvar e continuar" na primeira tela)
4
Clica em "Adicionar ou remover escopos"
5
Busca "Google Analytics" e marca o escopo https://www.googleapis.com/auth/analytics.readonly (somente leitura)
6
Confirma e clica em "Salvar e continuar" até o final
⚠️ Depois de adicionar o escopo, tu precisa gerar um novo refresh token. Não te preocupa, o Claude faz isso automaticamente no próximo passo.
3
Passo 3 de 4

Pegar o Property ID do GA4

Último dado que tu precisa: o ID da propriedade GA4 do teu site.

Copiando o Property ID
1
Acessa analytics.google.com
2
No canto inferior esquerdo, clica em Administrador (ícone de engrenagem)
3
Na coluna Propriedade, o Property ID aparece logo abaixo do nome da propriedade (é um número tipo 123456789)
4
Copia esse número
O que tu conseguiu nesse passo
Credenciais
GA4_PROPERTY_ID="123456789"
💡 Se tu gerencia mais de um site, não te preocupa. Depois tu cadastra todos no contas.yaml conversando com o Claude.
4
Passo 4 de 4

Mandar pro Claude configurar

Volta pro VS Code e manda pro Claude:

Tu: configura a skill de ga4 pra mim. meu property id é [COLA AQUI]

O Claude vai:

O que o Claude faz automaticamente
1
Detectar que tu já tem as credenciais OAuth do Google Ads configuradas
2
Criar o .env do GA4 reaproveitando o Client ID, Client Secret e refresh token existentes
3
Instalar a dependência Python (google-analytics-data)
4
Gerar um novo refresh token (com o escopo do GA4 incluído) se necessário
5
Testar a conexão com a propriedade GA4
6
Cadastrar a propriedade no contas.yaml
💡 Se o refresh token antigo não tiver o escopo do GA4, o Claude vai rodar o OAuth de novo. Abre o browser, tu autoriza, e pronto. Mesma coisa que no Google Ads.

Depois que conectar, tu pode pedir qualquer coisa:

Tu: me mostra o overview do meu site dos últimos 30 dias
Tu: quais são as principais fontes de tráfego?
Tu: quem tá no site agora em tempo real?
Tu: me mostra as landing pages com maior bounce rate
✅ Pronto! A skill tá configurada. O GA4 Ratos é uma skill de consulta: lê tudo, não modifica nada. Relatórios, fontes de tráfego, landing pages, campanhas UTM, dispositivos, geo e tempo real.