5 min de leitura

Importador Fathom

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

O que esta ferramenta faz

Lê 90 dias de agregados diários do Fathom Analytics: visitas, visualizações de página, principais fontes, páginas mais acessadas, principais países, dispositivos, sistemas operacionais e navegadores.
Grava na tabela analytics_daily do Zenovay com imported_from='fathom', para que fiquem claramente distinguíveis dos dados nativos do Zenovay.
Idempotente: reimportar o mesmo período realiza um UPSERT por data e sobrescreve de forma limpa, sem duplicatas.

O que esta ferramenta NÃO faz

Não importa sessões individuais de visitantes.
Não importa eventos personalizados, objetivos ou dados em tempo real.
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 conta do Fathom Analytics com pelo menos um site.
Uma chave de API do Fathom somente leitura (veja abaixo).

Nota de segurança. A chave de API do Fathom concede acesso via Bearer token aos dados da sua conta. O Zenovay usa sua chave apenas durante a requisição de importação e não a armazena permanentemente. Recomendamos criar uma chave de API dedicada para esta importação e revogá-la no Fathom assim que a importação estiver concluída.

Passo a passo

1. Criar uma chave de API somente leitura no Fathom

No Fathom, vá em Configurações → API e crie uma nova chave de API. Dê a ela um nome reconhecível (ex.: zenovay-import-2026-05). Copie a chave — o Fathom a exibe apenas uma vez.

Você não precisa atribuir escopos especiais; as chaves de API do Fathom têm acesso de leitura às estatísticas dos seus sites por padrão.

2. Encontrar o ID do site no Fathom

No Fathom, abra o site que deseja importar e observe a URL — o ID da entidade é o segmento alfanumérico após /sites/, por exemplo ABCDE em https://app.usefathom.com/#/sites/ABCDE/. Alternativamente, vá em Configurações → Sites e copie o ID exibido ao lado do site.

3. Abrir a aba Importar no Zenovay

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

4. Inserir a chave de API e o ID do site

Clique no mosaico Fathom → Conectar via API e insira:

Chave de API — o Bearer token do passo 1.
ID do site — o ID de entidade alfanumérico do passo 2.

5. 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.

6. Conferir

Quando terminar, você verá um resumo: linhas importadas, intervalo de datas e dimensões encontradas. Os dados importados aparecem imediatamente no seu painel com o marcador de origem Fathom.

7. Revogar a chave de API no Fathom

Após confirmar a importação, volte em Configurações → API no Fathom e exclua ou revogue a chave criada no passo 1. O Zenovay não precisa dela novamente para o rastreamento nativo subsequente.

Solução de problemas

"Chave de API inválida"

Verifique se você copiou a chave completa sem espaços no início ou no fim. Regenere a chave em Configurações → API no Fathom e cole-a novamente.

"Site não encontrado"

O ID do site deve ser o ID de entidade alfanumérico exibido na URL do Fathom ou nas configurações — não o nome de exibição nem o domínio do site. Confirme em Configurações → Sites.

"Taxa limitada"

O Fathom limita as requisições de API por chave por minuto. Se você vir este erro, aguarde 60 segundos e tente novamente. O Zenovay tenta automaticamente três vezes com backoff antes de exibir este erro.

"Importação parcial"

Indica que o Fathom retornou menos de 90 dias de dados — normalmente porque o site é mais novo 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 Fathom

O Fathom e o Zenovay contam visitas e filtram bots de formas ligeiramente diferentes. Espere pequenas diferenças. O marcador imported_from='fathom' permite filtrar para comparar dados equivalentes.

Distinguir os dados importados

Cada linha importada carrega imported_from='fathom' 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.

Reimportação e remoção

Repetir a importação para o mesmo período realiza um UPSERT por data, portanto é seguro repeti-la (com uma chave de API válida). Para remover os dados do Fathom importados, abra o mosaico Fathom e use Excluir dados importados — as linhas nativas do Zenovay não são afetadas.

Recursos relacionados

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