Se você está migrando do Simple Analytics para o Zenovay, o Simple Analytics Importer traz seus agregados diários históricos para o Zenovay para que você mantenha todo o contexto no dia da troca. Há três caminhos de importação dependendo do seu plano do Simple Analytics e das suas configurações de privacidade:
- Estatísticas de domínio público — sem credenciais; funciona se seu painel do Simple Analytics estiver como público.
- Exportação CSV — baixe do Simple Analytics e envie para o Zenovay.
- Chave de API — busque os dados diretamente se o seu site estiver em um plano pago do Simple Analytics.
O que é importado
- Visualizações de página e visitantes únicos diários (intervalo completo da exportação, por dia)
- Páginas principais, referenciadores principais, países principais (totais da janela importada — Simple Analytics retorna esses dados como agregados de janela, não por dia, portanto o mesmo detalhamento é aplicado nos dias importados)
- Detalhamento por navegador e tipo de dispositivo (se disponível na exportação, também como totais de janela)
O que não é importado
- Sessões individuais de visitantes ou logs de eventos brutos
- Eventos personalizados (apenas totais diários agregados, onde disponíveis)
- Dados de e-commerce / receita
- Dados em tempo real (apenas dias finalizados; o dia de hoje é sempre excluído)
Opção A — Domínio público (sem credenciais)
Se seu painel do Simple Analytics é público, o Zenovay pode buscar suas estatísticas diretamente — sem chave de API ou CSV necessária.
- Abra a página de detalhes do seu domínio no Zenovay → aba Import.
- Clique no bloco Simple Analytics e escolha o modo Público.
- Insira o domínio do seu site como aparece no Simple Analytics (ex.:
exemplo.com). - Clique em Buscar estatísticas. A importação é executada em segundo plano — você pode navegar e voltar depois; o status e o histórico o esperam na aba Import.
Opção B — Exportação CSV
Passo 1: Exportar do Simple Analytics
- Faça login em simpleanalytics.com e abra seu site.
- Clique em Exportar na navegação superior.
- Escolha CSV e selecione o intervalo de datas.
- Baixe o arquivo.
Passo 2: Importar no Zenovay
- Abra a página de detalhes do seu domínio → aba Import.
- Clique no bloco Simple Analytics e escolha o modo Enviar.
- Arraste seu arquivo
.csvpara a área de envio ou clique para navegar (máx. 50 MB). - Clique em Importar e aguarde. A importação é executada em segundo plano; o progresso e o histórico aparecem na aba Import.
Opção C — Chave de API
O que você precisa
- Uma chave de API do Simple Analytics — gere uma no Simple Analytics em Conta → Chaves de API → Adicionar chave de API com apenas a permissão Leitura de estatísticas.
- O nome do host do seu site no Simple Analytics (ex.:
exemplo.com).
Passos
- Abra a página de detalhes do seu domínio → aba Import.
- Clique no bloco Simple Analytics e escolha o modo API.
- Insira o nome do host do seu site e sua chave de API do Simple Analytics.
- Clique em Conectar. A importação é executada em segundo plano; o progresso e o histórico aparecem na aba Import.
Após a importação ser concluída, revogue a chave de API no Simple Analytics — o Zenovay não a necessita depois da importação, e limitar a vida útil da chave reduz a exposição.
Verifique sua importação
Depois que a importação terminar, percorra esta breve checklist para confirmar que os dados chegaram corretamente.
- Verifique o histórico na aba Import — cada importação concluída mostra seu status e o intervalo de datas que cobriu.
- Abra qualquer visualização de analytics no seu painel. Os dados importados aparecem imediatamente. Cada dia é armazenado como uma única linha diária, portanto os dias importados preenchem seu histórico junto com os dias que o Zenovay já rastreia. Para dias em que você já possui dados nativos do Zenovay, os números importados substituem esse dia (veja a FAQ abaixo), portanto o uso típico é importar o histórico de antes de você mudar para o Zenovay.
- Confira 3 dias aleatórios contra seu painel do Simple Analytics. Espere ±5% em visualizações de página e ±3% em visitantes únicos — Simple Analytics e Zenovay deduplicam visitantes de maneira diferente, portanto um pequeno desvio é normal.
- Reimporte o mesmo período para confirmar a idempotência. A contagem de linhas deve permanecer igual — duplicatas são impossíveis porque as linhas importadas são atualizadas em uma chave única.
- Quando estiver satisfeito, revogue a chave de API que você criou no Simple Analytics (se usou a Opção C).
Se algum desses testes parecer incorreto, escreva para [email protected] com a data da importação e quais dias parecem errados. Podemos corrigir manualmente os dias individuais.
Solução de problemas
Mensagem «Disponível no Pro»
O Simple Analytics Importer requer um plano pago. Fazer upgrade →
«Domínio não público»
Se escolheu o caminho de domínio público mas recebe este erro, seu painel do Simple Analytics está em modo privado. Mude para o método CSV ou chave de API, ou torne temporariamente seu painel público nas configurações do Simple Analytics, importe, depois o configure como privado novamente.
«Formato CSV inválido»
Zenovay espera o formato CSV de exportação padrão do Simple Analytics. Não modifique os cabeçalhos de coluna ou o formato de data. Se você exportou da página de exportação de dados do Simple Analytics (não a exportação de estatísticas), o formato de coluna é diferente — use a opção Exportar → CSV do painel de estatísticas.
«Falha na autenticação» (chave de API)
Verifique que a chave de API foi criada com a permissão Leitura de estatísticas. Chaves com apenas permissões Exportação de dados ou Conta não funcionarão. Gere uma nova chave no Simple Analytics em Conta → Chaves de API e tente novamente.
«Nenhum dado para este período»
O Simple Analytics retém dados apenas conforme a janela de retenção do seu plano. Se você estiver tentando importar um intervalo de datas mais antigo do que seu plano permite, a API retorna resultados vazios. Tente um intervalo de datas mais recente ou atualize seu plano do Simple Analytics antes de exportar.
«Importação expirou»
Intervalos de datas muito grandes podem levar tempo. Divida em intervalos menores e reimporte — a condição de idempotência torna a reimportação de intervalos sobrepostos segura.
Perguntas frequentes
Vai sobrescrever meus dados nativos do Zenovay?
Zenovay armazena uma única linha de totais diários por dia, portanto uma importação só afeta os dias que ela cobre. Para os dias que você ainda não rastreou com o Zenovay, o dia importado simplesmente preenche a lacuna. Para os dias que você já rastreou nativamente, os números importados substituem os totais desse dia (e o dia é marcado imported_from='simpleanalytics'). Como o caso usual é importar o histórico de antes de começar a rastrear com o Zenovay, normalmente não há sobreposição. Se você precisar manter dados nativos para um determinado dia, importe um intervalo de datas que termine antes de seu rastreamento do Zenovay ter começado. O histórico da aba Import mostra cada importação concluída e o intervalo de datas que ela cobriu.
Posso reimportar? Sim, sempre que quiser. A reimportação sobrescreve o mesmo intervalo de datas de forma limpa — sem duplicatas, sem linhas órfãs.
O Zenovay mantém minha chave de API do Simple Analytics?
Não. A chave é usada apenas como cabeçalho Api-Key nas solicitações de importação para o Simple Analytics e não é salva no banco de dados. Por precaução, você ainda pode revogá-la no Simple Analytics uma vez que a importação esteja completa.
Qual fuso horário os totais diários usam? O Simple Analytics armazena dados em UTC. Linhas importadas usam datas UTC, que correspondem ao próprio painel do Simple Analytics.
O Zenovay vai ver os dados pessoais dos meus visitantes? Não. A API do Simple Analytics retorna apenas estatísticas agregadas. Nenhum registro de visitante individual, IP ou ID de usuário é transferido para o Zenovay.
Isso afeta meus dados do Simple Analytics? Não. O importador é somente leitura. Zenovay nunca escreve em sua conta do Simple Analytics.
Meu site usa o plano gratuito do Simple Analytics — posso importar assim mesmo? Sim, via exportação CSV (Opção B) ou domínio público (Opção A) se seu painel for público. O caminho de chave de API (Opção C) requer um plano pago do Simple Analytics que forneça acesso à API.