Se você está migrando do Matomo para o Zenovay, o Matomo Importer traz seus agregados diários históricos para o Zenovay para que você mantenha todo o contexto no dia da troca. O Zenovay se conecta à sua API de Relatórios do Matomo usando a URL da sua instância, token_auth e ID do site, depois extrai o histórico diretamente. Sua instância do Matomo precisa ser acessível publicamente (auto-hospedada em um host público ou Matomo Cloud).
O que é importado
- Visualizações de página diárias, visitas e visitantes únicos (no intervalo de datas solicitado)
- Páginas principais, referenciadores principais, países principais
- Detalhamento por navegador, tipo de dispositivo e sistema operacional
O que não é importado
- Sessões individuais de visitantes ou logs de eventos brutos
- Dimensões personalizadas ou relatórios personalizados
- Eventos de e-commerce / receita
- Dados em tempo real (apenas dias finalizados; o dia de hoje é sempre excluído)
- Metas e conversões (apenas totais diários agregados)
O que você precisa
- A URL base da sua instância do Matomo (ex.:
https://analytics.exemplo.com) - Seu
token_auth— encontre-o no Matomo em Administração → Pessoal → Segurança → Tokens de autenticação - O ID do site no Matomo — visível em Administração → Sites → Gerenciar
Se você não quiser usar um token pessoal, crie um token dedicado com acesso de Visualizar ao site que você está importando, e delete-o após a conclusão da importação.
Como importar
- Abra a página de detalhes do seu domínio → aba Import.
- Selecione Matomo, depois mude para o modo Conexão API.
- Insira a URL do Matomo, seu
token_authe o ID do site. - Clique em Conectar e importar e aguarde a barra de progresso.
Por padrão, o Zenovay importa aproximadamente os últimos 90 dias. A importação roda em segundo plano, então você pode sair e voltar; o status estará esperando na aba Import.
Nos bastidores, o Zenovay chama a API de Relatórios do Matomo (VisitsSummary.get e Actions.get para totais diários, mais Actions.getPageUrls, Referrers.getReferrers, UserCountry.getCountry e DevicesDetection.* para os detalhamentos) com suas credenciais. O token_auth é usado apenas para esta importação; você pode revogá-lo no Matomo a qualquer momento.
Após uma importação bem-sucedida, revogue ou rotacione seu token_auth no Matomo — usar um token de curta duração, somente leitura, criado especificamente para a importação é a abordagem mais segura.
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 do Zenovay usa internamente.
- Abra qualquer visualização de analytics no seu painel. Os dados importados aparecem imediatamente, combinados com dados nativos já coletados.
- Confira 3 dias aleatórios contra seu painel do Matomo. Espere ±5% em visualizações de página e ±3% em visitas — o Matomo e o Zenovay deduplicam visitantes de forma diferente, então uma pequena diferença é normal.
- As linhas importadas são marcadas com
imported_from='matomo'no banco de dados, portanto você sempre pode distingui-las dos dados coletados nativamente pelo Zenovay. (Nota: a API de Stats não expõeimported_fromcomo uma chave de filtro consultável — seus filtros cobremcountry,browser,device,os,source, as dimensõesutm_*epage. Consulte 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 por causa da restrição de unicidade no nível do banco de dados.
- Quando estiver satisfeito, remova ou revogue o
token_authque você criou para esta importação.
Se algum desses checks parecer incorreto, escreva para [email protected] com a data em que importou e quais dias parecem errados. Podemos corrigir dias individuais.
Solução de problemas
Mensagem «Disponível no Pro»
O Matomo Importer requer um plano pago. Fazer upgrade →
«Falha na autenticação»
Verifique seu token_auth — ele diferencia maiúsculas de minúsculas. Também confirme que a URL base não tem uma barra final e é acessível publicamente (os servidores do Zenovay não conseguem alcançar endereços de rede privada como http://192.168.1.x). Crie um novo token no Matomo em Administração → Pessoal → Segurança → Tokens de autenticação com pelo menos permissão de Visualizar no site de destino.
«ID do site não encontrado»
Confirme o ID do site em Administração → Sites → Gerenciar no Matomo. É o número exibido ao lado do nome do seu site. Se você tiver múltiplos sites, certifique-se de estar usando o ID que corresponde ao domínio que você está importando no Zenovay.
«Nenhum dado retornado»
Se o Matomo retornar relatórios vazios para seu intervalo de datas, verifique se o rastreamento estava ativo nessas datas e se o ID do site do Matomo corresponde ao domínio. Também verifique que o token_auth tem acesso de Visualizar ao site, não apenas acesso de superusuário à área de administração.
«Importação expirou»
Intervalos de datas muito grandes (vários anos) podem levar tempo para processar. O Zenovay tentará novamente automaticamente. Se a importação continuar expirando, tente dividir o intervalo de datas em partes menores (ex: importar um ano de cada vez) e reimporte — a restrição de idempotência torna a reimportação de intervalos sobrepostos segura.
Perguntas frequentes
Vai sobrescrever meus dados nativos do Zenovay?
Não. Linhas importadas são marcadas com imported_from='matomo'. Elas são armazenadas ao lado (não sobre) dos dados que você coleta nativamente com o script de rastreamento, portanto sempre são distinguíveis no banco de dados.
Posso reimportar? Sim, a qualquer momento. Reimportar sobrescreve o mesmo intervalo de datas de forma limpa — sem duplicatas, sem linhas órfãs.
A importação do Matomo é gratuita? Não. O Matomo Importer (como outros importadores de analytics) requer um plano Pro ou superior.
Qual fuso horário os totais diários importados usam? As linhas importadas usam o fuso horário configurado no seu site do Matomo para a dimensão de data. Se seu site do Matomo está configurado para Europe/London, "2026-05-16" na importação significa um dia completo em horário de Londres.
O Zenovay mantém meu token_auth?
Não. Seu token_auth é enviado com a solicitação de importação, usado apenas para fazer as chamadas da API de Relatórios do Matomo para essa única importação e depois descartado. Ele não é armazenado em um banco de dados do Zenovay ou reutilizado. Mesmo assim, uma vez que a importação esteja completa, você deve revogar ou deletar o token no Matomo como precaução.
O Zenovay vai ver os dados pessoais dos meus visitantes? Não. A API de Relatórios do Matomo retorna apenas estatísticas agregadas (totais, listas Top-N). Nenhum registro de visitante individual, IP ou ID de usuário é transferido para o Zenovay.
Isso afeta meus dados do Matomo? Não. O importador é somente leitura. O Zenovay nunca escreve na sua instância do Matomo.