Conectando o Google Analytics 4 (GA4)

Puxar o analytics do seu site e aplicativo para o Google Sheets leva apenas alguns cliques. Como a Metric Might se conecta diretamente à Data API do GA4, você pode extrair Sessões (Sessions), Contagens de Eventos (Event Counts) e Receita de E-commerce (E-commerce Revenue) de todas as propriedades dos seus clientes de forma instantânea.


1. Pré-requisitos (Permissões Necessárias)

Antes de poder puxar os dados, você deve ter as permissões corretas dentro da sua conta do Google Analytics.

  • Você deve ter pelo menos acesso de Leitor (Viewer) ou Analista (Analyst) à Propriedade do GA4 (GA4 Property) específica que deseja consultar.
  • Se você gerencia vários clientes, certifique-se de que a sua conta do Google Workspace/Gmail recebeu acesso às Propriedades do Analytics de cada um deles antes de se autenticar na Metric Might.
  • Nota: O Universal Analytics (UA) foi descontinuado pelo Google e não é suportado. Você deve usar uma Propriedade do GA4.

2. Como Conectar

Você pode conectar a sua conta do Google Analytics sem sair do construtor de queries.

  1. Abra o Web App da Metric Might e navegue até a página Queries.
  2. Na seção Data source, clique no menu suspenso e selecione Add Data Source.
  3. Escolha Google Analytics 4.
  4. Um pop-up seguro pedirá que você faça login com o Google. Revise as permissões e clique em Allow.
⚠️ Pop-up bloqueado? Se nada aparecer quando você clicar para conectar, seu navegador pode estar bloqueando o pop-up de autenticação. Libere pop-ups para app.metricmight.com e tente novamente.
💡 Dica para Agências: Quando você autentica sua Conta do Google, a Metric Might detecta automaticamente e libera o acesso a todas as Propriedades do GA4 que o seu endereço de e-mail tem acesso. Você não precisa autenticar cada cliente individualmente.

3. Métricas e Dimensões Disponíveis

Diferente das versões antigas do Google Analytics, o GA4 registra todas as interações — visualizações de página, cliques, compras — como Eventos (Events). Isso afeta como as métricas e dimensões se relacionam umas com as outras.

Ao construir a sua query, clique nos menus suspensos de Metrics ou Dimensions para abrir a sobreposição de pesquisa. Você pode procurar por campos padrão como Sessions, Total Users, Event Count e Total Revenue.

Compatibilidade de Escopo (Scope Compatibility): O GA4 impõe regras rígidas sobre misturar dimensões de “Escopo de Usuário” (User-scoped) com métricas de “Escopo de Evento” (Event-scoped). Na prática, isso significa que algumas dimensões — como aquelas que descrevem a primeira visita de um usuário — não podem ser misturadas com métricas de nível de sessão ou de evento. A matriz de compatibilidade em tempo real da Metric Might cuida disso para você automaticamente. Se você selecionar uma dimensão (como First user medium), a Metric Might desativará automaticamente na pesquisa quaisquer métricas que a API do Google proíbe que sejam consultadas junto com ela.


4. Expiração de Token

Assim como no Google Ads, os tokens de acesso do GA4 raramente expiram.

Uma vez que você autentica o Google Analytics 4 na Metric Might, a conexão permanecerá ativa indefinidamente, a menos que ocorra uma das seguintes situações:

  • Você altera a senha da sua conta do Google.
  • Você revoga manualmente o acesso da Metric Might através das configurações de Segurança da sua Conta do Google.
  • O Google detecta atividade suspeita e força um logout de segurança.

Se uma query do GA4 parar de funcionar inesperadamente com um erro de autenticação, vá para a página Connections, clique no menu de três pontos () ao lado da fonte de dados do GA4 e selecione Sign In Again.


5. Peculiaridades e Pegadinhas Específicas do GA4

A API do GA4 é incrivelmente complexa e prioriza fortemente a privacidade do usuário. Se os seus dados parecerem um pouco diferentes do que você espera, ou se linhas parecerem estar faltando, quase sempre é devido a um dos seguintes motivos.

Limite de Dados - Data Thresholding (Linhas Faltando)

Se você puxar um relatório altamente granular (por exemplo, quebrando o tráfego por City e Device Category), você pode notar que o total de Sessões (Sessions) ou Usuários (Users) no seu Google Sheets está menor que o total no seu dashboard do GA4.

Isso é chamado de Data Thresholding. Para evitar que você consiga identificar usuários individuais, o Google ocultará intencionalmente da API as linhas que contêm contagens de usuários muito baixas.

  • Como resolver: Tente puxar intervalos de datas mais amplos ou remova dimensões muito específicas da sua query para que cada linha tenha uma contagem de usuários grande o suficiente para passar pelos filtros de privacidade do Google.

Atrasos de Processamento - Processing Delays (24–48 Horas)

Diferente de ferramentas de analytics antigas, o GA4 não processa os dados em tempo real. Embora você possa ver uma visão geral em “Tempo Real” no dashboard web do GA4, a Data API oficial do GA4 fornece apenas dados totalmente processados e consolidados. Pode levar de 24 a 48 horas para o Google processar totalmente os eventos diários e transações de e-commerce. Se você consultar dados de “Hoje” (Today) ou “Ontem” (Yesterday), os números provavelmente estarão incompletos.

Amostragem de Dados (Data Sampling)

Para propriedades do GA4 com volumes de eventos muito altos, o Google pode retornar dados amostrados (sampled) via API — o que significa que os resultados são estimados em vez de exatos. Se os seus totais parecem um pouco fora da realidade em propriedades de alto tráfego, essa é a causa provável. As propriedades do Google Analytics 360 (versão paga) possuem limites de amostragem mais altos.

Valores “(not set)”

Se você vir (not set) aparecendo em suas colunas de dimensão (como em Session source / medium), significa que o Google recebeu o evento, mas não conseguiu anexar o contexto necessário. Isso geralmente acontece devido à falta de parâmetros UTM em suas campanhas de anúncios, navegadores focados em privacidade bloqueando dados de referência (referral) ou restrições de rastreamento do iOS 14+.


O que vem a seguir?

Esta página foi útil?