6 min de leitura

Importador Matomo

Disponível no Pro e superior. O importador Matomo é uma ferramenta de uso único para trazer seus últimos 90 dias de agregados diários do Matomo 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 Matomo: 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='matomo', para que fiquem claramente distinguíveis dos dados nativos do Zenovay.
Idempotente: reimportar o mesmo período faz um UPSERT por data e sobrescreve de forma limpa, sem duplicatas.
Normaliza automaticamente a taxonomia do Matomo para os nomes canônicos do Zenovay — por exemplo, a classe de dispositivo Smartphone do Matomo é mapeada para Mobile do Zenovay, e sistemas operacionais com sufixo de versão (Windows 11, Android 14) são agrupados sob sua família canônica.

O que esta ferramenta NÃO faz

Não importa sessões individuais de visitantes nem o registro de visitas.
Não importa eventos personalizados, metas, dados de e-commerce/receita 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.
Um arquivo de exportação de relatório do Matomo, ou uma instância Matomo acessível por HTTPS com um token de autenticação da API.

Método A — Enviar uma exportação de relatório

Use isto se o seu Matomo estiver em uma rede fechada ou se você simplesmente preferir não compartilhar um token de API.

1. Exportar do Matomo

No Matomo, abra o relatório desejado (por exemplo Visitantes → Visão geral ou Comportamento → Páginas), defina o intervalo de datas para os últimos 90 dias e use o widget Exportar para baixar um arquivo CSV ou JSON.

2. Abrir a aba Importar

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

3. Enviar o arquivo

Clique no mosaico Matomo → Enviar exportação e selecione seu arquivo CSV ou JSON. O Zenovay analisa o arquivo, mapeia as colunas do Matomo para o próprio esquema, normaliza os nomes de dispositivo/SO/navegador e exibe uma prévia antes de gravar qualquer coisa.

4. Confirmar

Revise a prévia (linhas detectadas, intervalo de datas, dimensões normalizadas) e clique em Importar. Os dados aparecem no seu painel com o marcador de origem Matomo.

Método B — Conectar via API de relatórios do Matomo

Use isto para uma importação sem intervenção que extrai todas as dimensões suportadas em uma única passagem.

1. Criar um token de autenticação no Matomo

No Matomo, vá em Pessoal → Segurança → Tokens de autenticação e crie um novo token. Copie o valor token_auth — o Matomo o exibe apenas uma vez.

2. Encontrar seu ID de site numérico

No Matomo, o ID de site (idSite) é o número exibido na URL ao visualizar os relatórios de um site, ou em Administração → Sites → Gerenciar. É um inteiro simples como 1 ou 42.

3. Conectar no Zenovay

Abra o mosaico Matomo → Conectar via API e informe:

URL base do Matomo — a raiz da sua instalação do Matomo, por exemplo https://analytics.example.com (sem caminho final).
token_auth — o token da etapa 1.
ID de site — o idSite numérico da etapa 2.

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

5. Conferir

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

Uma nota sobre a normalização

Matomo e Zenovay categorizam tecnologia de forma ligeiramente diferente. O Zenovay mapeia automaticamente para que seus dados importados e nativos se alinhem:

Classe de dispositivo do Matomo Smartphone → Zenovay Mobile; Tablet continua Tablet; Desktop continua Desktop.
Sistemas operacionais com sufixo de versão (Windows 11, macOS 15, Android 14, iOS 18) são agrupados sob sua família canônica (Windows, macOS, Android, iOS).
Os nomes de navegador são comparados com a lista canônica do Zenovay; versões menores/de build são descartadas.

Se um valor não puder ser mapeado com confiança, ele é preservado literalmente em vez de descartado.

Solução de problemas

"Não foi possível acessar o Matomo"

Verifique se a URL base não tem caminho final e está acessível por HTTPS pela internet pública. Instâncias Matomo atrás de uma VPN ou lista de IPs permitidos não são acessíveis pelo importador — use o Método A (envio de arquivo) em vez disso.

"token_auth inválido"

Gere novamente o token em Pessoal → Segurança → Tokens de autenticação e cole-o de novo. Um token de outro usuário do Matomo sem acesso de leitura ao site também falhará aqui.

"Site não encontrado"

O ID de site deve ser o idSite numérico, não o nome nem o domínio do site. Confirme-o em Administração → Sites → Gerenciar.

"Formato de exportação não reconhecido"

O Método A aceita as exportações CSV e JSON nativas do Matomo. Arquivos reexportados, editados manualmente ou regravados por uma planilha podem perder a linha de cabeçalho de que o Zenovay precisa — baixe novamente direto do widget Exportar do Matomo.

"Importação parcial"

Indica que o Matomo 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 Matomo

O Matomo deduplica e conta visitas de forma diferente da ingestão nativa do Zenovay, e a filtragem de bots difere. Espere pequenas diferenças. O marcador imported_from='matomo' permite filtrar para comparar dados equivalentes.

Distinguir os dados importados

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

Reimportar e remover

Reexecutar a importação para o mesmo período faz um UPSERT por data, então é seguro repeti-la. Para remover os dados do Matomo importados, abra o mosaico Matomo e use Excluir dados importados — as linhas nativas do Zenovay não são tocadas.

Recursos relacionados

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