Pular para o conteúdo principal
4 min de leitura

Importador GA4

Disponível no Pro e superior. O importador GA4 é uma ferramenta de uso único para trazer seus últimos 90 dias de agregados diários do Google Analytics 4 para o Zenovay, de modo que você não perca o contexto ao migrar.

O que esta ferramenta faz

  • 90 dias de agregados diários da sua propriedade GA4: visualizações de página, sessões, usuários, páginas mais acessadas, principais fontes, principais países.
  • Grava na tabela analytics_daily do Zenovay com imported_from='ga4', para que fiquem claramente distinguíveis dos dados nativos do Zenovay.
  • Idempotente: reimportar o mesmo período sobrescreve de forma limpa, sem duplicatas.

O que esta ferramenta NÃO faz

  • Não importa sessões individuais de visitantes, eventos personalizados, dados de e-commerce/receita ou dados em tempo real.
  • Não mapeia eventos personalizados do GA4 para os tipos de evento do Zenovay (planejado para a V2).
  • Não sincroniza continuamente — a V1 é de uso único. A sincronização recorrente está no roadmap.

Pré-requisitos

  • Uma conta Zenovay no plano Pro ou superior.
  • Uma propriedade Google Analytics 4 na qual a conta Google que você for usar tenha pelo menos o papel Leitor.

Passo a passo

1. Abrir a aba Importar

Acesse a página de detalhe do seu domínio → aba Importar. Você verá os mosaicos de fonte para Plausible (já existente) e Google Analytics 4 (novo).

2. Conectar o Google Analytics

Clique no mosaico Google Analytics 4Conectar Google Analytics. Você será redirecionado ao Google, onde concederá ao Zenovay acesso somente leitura aos seus dados do GA4 (scope: analytics.readonly).

3. Escolher uma propriedade

Após o consentimento, você verá a lista de propriedades GA4 da sua conta Google. Escolha aquela que corresponde ao site que está importando.

4. Iniciar a importação

Clique em Importar últimos 90 dias. A importação roda em segundo plano; a interface consulta o status a cada dois segundos e exibe uma barra de progresso. Uma importação de 90 dias costuma levar de 30 a 60 segundos.

5. Conferir

Quando terminar, você verá um resumo: linhas importadas, intervalo de datas, status de amostragem (se o GA4 amostrou seus dados). Os dados importados aparecem imediatamente no seu painel com o marcador de origem GA4.

Uma nota sobre o Universal Analytics

O Google excluiu todos os dados do Universal Analytics em 1º de julho de 2025. Os dados de UA não são mais recuperáveis nos sistemas do Google. O importador GA4 suporta apenas propriedades GA4 — propriedades UA não podem ser migradas.

Solução de problemas

"Scope negado"

Você precisa conceder o scope analytics.readonly. Refaça o fluxo Conectar e marque todas as caixas de escopo solicitadas pelo Google.

"Propriedade não encontrada"

Verifique se a conta Google com a qual você se autenticou tem pelo menos o papel Leitor na propriedade GA4. Se trocou de conta Google entre Conectar e Escolher, desconecte e reconecte.

"Taxa limitada"

O GA4 limita as requisições à API por propriedade por hora. Se isso ocorrer, espere 10 minutos e tente de novo. O Zenovay tenta automaticamente três vezes com backoff antes de exibir esse erro.

"Importação parcial"

Indica que o GA4 retornou menos de 90 dias de dados — normalmente porque a propriedade é mais nova que 90 dias, ou alguns dias não tiveram tráfego. Confira por amostragem o intervalo importado no seu painel.

Os dados divergem levemente do painel do GA4

O GA4 deduplica e amostra de forma diferente da ingestão nativa do Zenovay. Espere ±5% em visualizações de página, ±3% em sessões e ±2% em usuários únicos. O marcador imported_from='ga4' permite filtrar para comparar dados equivalentes.

Distinguir os dados importados

Cada linha importada carrega imported_from='ga4' em analytics_daily. Na Public Stats API do Zenovay (Pro+), você pode filtrar pelo mesmo campo. Os dados nativos do Zenovay têm imported_from=NULL.

Desconectar

Abra o mosaico GA4 → Desconectar. O Zenovay revoga o token OAuth no endpoint de revogação do Google e remove suas credenciais armazenadas. Os dados importados são preservados por padrão; marque a caixa "Excluir também os dados importados" se quiser uma limpeza completa.


Recursos relacionados


Precisa de ajuda? Entre em contato com [email protected] ou visite nossa Central de ajuda.

Esta página foi útil?