Skip to main content
O conector Google Analytics ingere relatórios agregados de uma propriedade GA4 na infraestrutura strattum.ai. Os dados aparecem no Data Catalog como séries diárias de sessões, visualizações de página, eventos e aquisição de usuários.

​
Capacidades

  • Extrai relatórios pré-definidos da Google Analytics Data API (GA4).
  • Agrega métricas por dia, com dimensões de origem, mídia, página e evento.
  • Autenticação via Service Account do Google Cloud.

​
Objetos suportados

Cada objeto é um relatório fixo com dimensões e métricas definidas.

​
Pré-requisitos

Propriedade GA4

Uma propriedade Google Analytics 4 e o seu Property ID numérico.

Service Account com acesso ao GA4

Uma Service Account do Google Cloud adicionada como leitora na propriedade. O passo a passo está abaixo.

​
Configuração

1

Crie uma Service Account

No Google Cloud Console, acesse IAM & Admin → Service Accounts → Create Service Account. Dê um nome como strattum-ga-reader.
2

Habilite a Google Analytics Data API

Em APIs & Services → Library, pesquise por Google Analytics Data API e clique em Enable.
3

Gere a chave JSON

Na Service Account, acesse Keys → Add Key → Create new key, selecione JSON e baixe o arquivo.
A chave JSON não expira automaticamente. Trate-a como senha crítica e rotacione periodicamente.
4

Dê acesso à propriedade GA4

No Google Analytics, acesse Admin → Property Access Management e adicione o e-mail da Service Account (nome@projeto.iam.gserviceaccount.com) com o papel Viewer.
5

Descubra o Property ID

Em Admin → Property Settings, copie o Property ID numérico (ex: 123456789). Não use o Measurement ID (G-XXXX).
6

Adicione o conector no Console

No menu lateral do Console, clique em Conectores → + Nova Conexão e selecione Google Analytics. Preencha os campos:
  • Nome do Conector — identificador na lista de conectores (Obrigatório)
  • Property ID — ID numérico da propriedade GA4 (Obrigatório)
  • Service Account JSON — cole o conteúdo do arquivo JSON baixado (Obrigatório)

​
Autenticação e escopos

A autenticação é por Service Account do Google Cloud, com um escopo OAuth de leitura.

​
Frequência de sync

O conector sincroniza uma vez por dia, às 6h. O GA4 consolida os dados do dia anterior, então a série diária fica completa após o fechamento do dia.

​
Limitações conhecidas

  • Os relatórios são fixos (os quatro objetos acima), com dimensões e métricas pré-definidas; não há relatório customizado pela configuração do conector.
  • Os dados são agregados por dia — não há granularidade por sessão ou por usuário individual.
  • Métricas do dia corrente podem estar incompletas até o GA4 consolidar; a série se estabiliza no fechamento do dia.
  • É necessário usar o Property ID numérico, não o Measurement ID (G-XXXX).

​
Troubleshooting

​
Próximos passos

Guia de desenvolvimento local

Configure o ambiente local completo com Prefect, worker e Docker Compose.

Quickstart — Data Pipelines

Ative conectores via Console strattum.ai sem precisar de ambiente local.