Se você está migrando do Google Analytics 4 para o Zenovay, o GA4 Importer traz seus últimos 90 dias de agregados diários para o Zenovay em um clique, para que você mantenha o contexto no dia da troca.
O importador GA4 com um clique está sendo implantado e está pendente de revisão de verificação de marca do Google. Até que isso seja concluído, o bloco Google Analytics 4 na aba Import mostra um badge «Em breve» e ainda não está conectável. Se você precisar mover o histórico do GA4 mais rapidamente, exporte-o para CSV e use a importação de CSV no formato Plausible, ou envie um email para [email protected]. Os passos abaixo descrevem o fluxo OAuth conforme funcionará uma vez que o bloco esteja habilitado.
O que é importado
- Visualizações de página, sessões e usuários diários (últimos 90 dias)
- Páginas principais, fontes principais, países principais (detalhamento diário)
- Avisos de amostragem, caso o GA4 tenha amostrado o relatório
O que não é importado
- Sessões individuais de visitantes (apenas agregados diários)
- Eventos personalizados do GA4 (apenas métricas padrão)
- Eventos de e-commerce / receita
- Dados em tempo real (apenas dias finalizados; o dia de hoje é sempre excluído)
- Dados do Universal Analytics (o Google deletou todos os dados UA em 1º de julho de 2025)
Como importar
- Abra a página de detalhes do seu domínio → aba Import
- Clique no bloco Google Analytics 4 → Conectar Google Analytics
- Faça login no Google e conceda o escopo
analytics.readonly - Escolha a propriedade GA4 da qual deseja importar
- Clique em Importar últimos 90 dias
- Aguarde 30 a 60 segundos — a barra de progresso atualiza conforme os dados chegam
A importação roda em segundo plano. Você pode sair e voltar; o status estará esperando na aba Import.
Verifique sua importação
Depois que a importação terminar, percorra esta breve checklist para confirmar que os dados chegaram corretamente. É o mesmo runbook que a equipe da Zenovay usa internamente.
- Abra qualquer visualização de analytics no seu painel (por exemplo, visualizações dos últimos 90 dias). Os dados importados aparecem imediatamente, combinados com quaisquer dados nativos já coletados.
- Confira 3 dias aleatórios contra seu painel do GA4. Espere ±5 % em visualizações, ±3 % em sessões, ±2 % em usuários únicos — Zenovay e GA4 deduplificam visitantes de formas diferentes, então uma pequena diferença é normal.
- As linhas importadas são marcadas com
imported_from='ga4'no banco de dados, portanto você sempre consegue diferenciá-las dos dados coletados nativamente pelo Zenovay. (Nota: a Stats API não expõeimported_fromcomo uma chave de filtro consultável — seus filtros cobremcountry,browser,device,os,source, as dimensõesutm_*epage. Veja Stats API para a sintaxe de filtro completa.) - Reimporte o mesmo período para confirmar a idempotência. A contagem de linhas deve permanecer igual — duplicatas são impossíveis devido à restrição de unicidade no banco de dados.
- Quando estiver satisfeito, desconecte na aba Import. O Zenovay revoga o refresh token OAuth no lado do Google. Os dados importados permanecem no seu painel, a menos que você marque também «Excluir também os dados importados» no modal de desconexão.
Se algum desses checks parecer incorreto, escreva para [email protected] com a data da importação e os dias afetados. Conseguimos corrigir dias individuais.
Solução de problemas
Mensagem «Disponível no Pro»
O GA4 Importer requer um plano pago. Importações Plausible via CSV continuam gratuitas; apenas o caminho GA4 baseado em OAuth é restrito. Fazer upgrade →
«Escopo negado»
Quando a tela de consentimento do Google aparecer, certifique-se de que a caixa analytics.readonly está marcada. Clique novamente em Conectar Google Analytics para tentar de novo — é o único escopo que o Zenovay solicita.
«Propriedade não encontrada»
A conta Google com a qual você se autenticou precisa ter pelo menos o papel Leitor na propriedade GA4 de destino. Abra analytics.google.com → Administrador → Gerenciamento de acesso à propriedade e verifique. Se precisar trocar de conta Google, desconecte primeiro e reconecte com a conta correta.
«Limite de taxa atingido»
O GA4 limita chamadas de API por propriedade por hora (1.250 tokens). Para uma importação de 90 dias isso costuma ser suficiente, mas se você reimportar várias vezes em sequência pode atingir o limite. Aguarde 10 minutos e tente novamente. O Zenovay tenta automaticamente três vezes com backoff exponencial antes de mostrar este erro.
«Amostrado pelo GA4»
Para propriedades com tráfego muito alto, o GA4 retorna agregados amostrados (estimados) em vez de números precisos. A importação é concluída mesmo assim, mas as linhas afetadas são aproximadas. Seu painel mostra um indicador «GA4 amostrado» nos dias afetados para você notar imediatamente.
«Token revogado»
Se você revogar o acesso do Zenovay em myaccount.google.com, a próxima importação falhará com este erro. Clique novamente em Conectar Google Analytics para reautorizar.
Perguntas frequentes
Vai sobrescrever meus dados nativos do Zenovay?
Não. Linhas importadas são marcadas com imported_from='ga4'. São armazenadas ao lado (e não por cima) dos dados que você coleta nativamente com o script de tracking. Você pode filtrá-las para dentro ou para fora a qualquer momento.
Posso reimportar? Sim, sempre que quiser. Reimportar sobrescreve o mesmo intervalo de datas de forma limpa — sem duplicatas, sem linhas órfãs.
Posso importar mais de 90 dias? Em V1, não. Estamos avaliando um add-on pago para o histórico completo da conta. Escreva para nós se isso for relevante para você.
E quanto ao Universal Analytics? Os dados do Universal Analytics se foram. O Google deletou todos os dados UA em 1º de julho de 2025. O Zenovay suporta apenas GA4. Se você exportou seu histórico UA antes da exclusão para um CSV ou BigQuery, entre em contato com o suporte — podemos discutir uma ingestão sob medida.
O Zenovay vai ver os dados pessoais dos meus visitantes? Não. O importer lê apenas agregados diários (totais, listas top-N). Nenhum registro individual de visitante, IP ou User-ID atravessa do GA4 para o Zenovay. Os dados pessoais dos seus visitantes permanecem na sua conta do GA4.
Isso afeta meus dados do GA4? Não. O importer é somente leitura. O Zenovay nunca grava na sua propriedade GA4 — a desconexão apenas revoga o token OAuth no lado do Google.
Qual fuso horário os dados diários usam? As linhas importadas usam o fuso horário da sua propriedade GA4 para a dimensão de data, não o do Zenovay. Se sua propriedade GA4 estiver configurada para America/Sao_Paulo, «2026-05-13» na importação corresponde a um dia completo no horário de São Paulo. Isso bate com o que você vê no painel do GA4 para uma comparação ponto a ponto.