Se você está migrando do Fathom Analytics para o Zenovay, o Fathom Importer traz seus agregados diários recentes para o Zenovay para que você mantenha todo o contexto no dia da troca. A importação usa a API do Fathom com uma chave de API somente leitura e o ID do seu site no Fathom.
O que é importado
- Visualizações de página e visitantes únicos diários (últimos 90 dias)
- Páginas principais, referenciadores principais, países principais (detalhamento de janela)
- Detalhamento por navegador, tipo de dispositivo e sistema operacional
O que não é importado
- Histórico anterior aos últimos 90 dias
- Sessões individuais de visitantes ou logs de eventos brutos
- Metas do Fathom / conversões (apenas totais agregados)
- Dados de e-commerce / receita
- Dados em tempo real (apenas dias finalizados; o dia de hoje é sempre excluído)
Como importar
Passo 1: Obter sua chave de API do Fathom
- Faça login na sua conta do Fathom em usefathom.com.
- Vá para Conta → API (na barra lateral esquerda).
- Clique em Criar chave de API.
- Dê um nome descritivo (ex.: "Importação Zenovay — junho 2026").
- Defina a permissão como Somente leitura — o Zenovay não precisa de acesso de escrita.
- Copie a chave; ela é exibida apenas uma vez.
Passo 2: Obter o ID do seu site no Fathom
- No Fathom, vá para Sites.
- Encontre o site que deseja importar. O ID é o curto código alfanumérico exibido abaixo do nome do site (ex.:
ABCDE). Você também pode encontrá-lo na URL:app.usefathom.com/sites/ABCDE/...
Passo 3: Importar no Zenovay
- Abra o site que deseja importar, depois abra suas configurações e selecione a aba Import.
- No seletor de origem, escolha o bloco Fathom Analytics.
- Cole sua chave de API e o ID do seu site no Fathom.
- Clique em Conectar e aguarde a barra de progresso ser concluída.
A importação roda em segundo plano. Você pode sair e voltar; o status estará esperando na aba Import, junto com o histórico de importações.
Passo 4: Revogar a chave de API após a importação
Depois que a importação for concluída com sucesso, volte ao Fathom → Conta → API e exclua ou revogue a chave criada. O Zenovay não a necessita após a importação, e revogá-la limita a exposição se a chave fosse comprometida.
Verifique sua importação
Depois que a importação terminar, percorra esta breve checklist para confirmar que os dados chegaram corretamente.
- Abra qualquer visualização de analytics no seu painel (por exemplo, visualizações dos últimos 90 dias). Os dados importados aparecem imediatamente, mesclados com qualquer dado nativo já coletado.
- Confira 3 dias aleatórios contra seu painel do Fathom. Espere ±5% em visualizações e ±3% em visitantes únicos — Fathom e Zenovay deduplicam visitantes de forma diferente, então uma pequena diferença é normal.
- Linhas importadas são marcadas no banco de dados com
imported_from='fathom', portanto ficam ao lado (não sobre) seus dados Zenovay nativos. A aba Import mostra cada importação completada e o intervalo de datas que cobriu. - Reimporte o mesmo período para confirmar a idempotência. A contagem de linhas deve permanecer igual — duplicatas são impossíveis porque cada dia é codificado de forma única por site no nível do banco de dados.
- Depois de satisfeito, revogue a chave de API do Fathom (passo 4 acima) se ainda não o fez.
Se algum desses checks parecer incorreto, escreva para [email protected] com a data em que importou e quais dias se parecem errados. Podemos corrigir manualmente os dias individuais.
Solução de problemas
Mensagem «Disponível no Pro»
O Fathom Importer requer um plano pago. Fazer upgrade →
«Chave de API inválida»
Certifique-se de ter copiado a chave completa do Fathom — ela só é exibida na criação. Se não puder mais vê-la, exclua a antiga e crie uma nova. A chave deve ter permissão de Somente leitura ou superior.
«ID do site não encontrado»
Verifique o ID no Fathom → Sites. É um curto código alfanumérico em maiúsculas. Se estiver usando a URL do painel para encontrá-lo, extraia apenas a parte do código (ex.: ABCDE de app.usefathom.com/sites/ABCDE/). Certifique-se de que a chave de API tem acesso a esse site específico.
«Nenhum dado retornado»
Confirme que:
- Os últimos 90 dias se sobrepõem ao período em que seu site Fathom estava sendo ativamentetriado.
- O ID do site corresponde ao site que você rastreou — não outro site do Fathom em sua conta.
- A retenção de dados da sua conta Fathom inclui os últimos 90 dias.
«Erro de autenticação»
A chave de API criada pode ter sido excluída ou expirado. Crie uma nova chave somente leitura no Fathom e tente novamente.
«Importação expirou»
Janelas muito grandes podem levar tempo. Zenovay tenta novamente automaticamente. Se continuar expirando, tente a importação novamente — reimportar um intervalo sobreposto é seguro porque cada dia é codificado de forma única por site.
Perguntas frequentes
Vai sobrescrever meus dados nativos do Zenovay?
Não. Linhas importadas são marcadas com imported_from='fathom'. Elas são armazenadas ao lado (não sobre) dados nativos, portanto seus dados de analytics coletados pelo Zenovay permanecem intactos.
Posso reimportar? Sim, sempre que quiser. Reimportar sobrescreve o mesmo intervalo de datas de forma limpa — sem duplicatas, sem linhas órfãs.
Por que preciso revogar a chave de API após a importação? As chaves de API do Fathom são persistentes. Como o Zenovay só precisa da chave para a importação única, revogá-la depois é uma boa prática de segurança — você não deve deixar uma chave ativa depois que ela não é mais necessária.
O Zenovay mantém minha chave de API do Fathom? Não. O Zenovay usa a chave apenas durante a solicitação de importação e não a armazena depois. Após a importação, revogue-a no Fathom para que ela não possa ser usada novamente.
Qual fuso horário os totais diários usam? O Fathom armazena dados em UTC. Linhas importadas usam datas UTC, correspondendo ao painel do Fathom.
O Zenovay vai ver os dados pessoais dos meus visitantes? Não. A API do Fathom retorna apenas estatísticas agregadas. Nenhum registro de visitante individual, IP ou ID de usuário é transferido para Zenovay.
Isso afeta meus dados do Fathom? Não. O importador é somente leitura. Zenovay nunca escreve em sua conta Fathom.
Posso importar metas do Fathom? Não em V1. Importamos totais agregados diários para visualizações e visitantes. Dados de metas / conversões estão no roadmap para uma versão futura.