6 min de lectura

Importador Matomo

Disponible en Pro y superior. El importador Matomo es una herramienta de un solo uso para traer tus últimos 90 días de agregados diarios de Matomo a Zenovay, de modo que no pierdas el contexto al cambiar.

Qué hace esta herramienta

Lee 90 días de agregados diarios desde Matomo: visitas, páginas vistas, fuentes principales, páginas principales, países principales, dispositivos, sistemas operativos y navegadores.
Los escribe en la tabla analytics_daily de Zenovay con imported_from='matomo' para que se distingan claramente de los datos nativos de Zenovay.
Idempotente: reimportar el mismo periodo hace un UPSERT por fecha y sobrescribe limpiamente sin duplicados.
Normaliza automáticamente la taxonomía de Matomo a los nombres canónicos de Zenovay — por ejemplo, la clase de dispositivo Smartphone de Matomo se asigna a Mobile de Zenovay, y los sistemas operativos con sufijo de versión (Windows 11, Android 14) se agrupan bajo su familia canónica.

Qué NO hace esta herramienta

No importa sesiones individuales de visitantes ni el registro de visitas.
No importa eventos personalizados, objetivos, datos de e-commerce/ingresos ni datos en tiempo real.
No sincroniza de forma continua — la V1 es de un solo uso. La sincronización recurrente está en la hoja de ruta.

Requisitos previos

Una cuenta de Zenovay en el plan Pro o superior.
Un archivo de exportación de informe de Matomo, o bien una instancia de Matomo accesible por HTTPS con un token de autenticación de la API.

Método A — Subir una exportación de informe

Usa esto si tu Matomo está en una red cerrada o simplemente prefieres no compartir un token de API.

1. Exportar desde Matomo

En Matomo, abre el informe que quieras (por ejemplo Visitantes → Resumen o Comportamiento → Páginas), ajusta el rango de fechas a los últimos 90 días y usa el widget Exportar para descargar un archivo CSV o JSON.

2. Abrir la pestaña Importar

Ve a la página de detalle de tu dominio → pestaña Importar. Verás mosaicos de fuentes para Plausible (existente) y Matomo (nuevo).

3. Subir el archivo

Haz clic en el mosaico Matomo → Subir exportación y selecciona tu archivo CSV o JSON. Zenovay analiza el archivo, asigna las columnas de Matomo a su propio esquema, normaliza los nombres de dispositivo/SO/navegador y muestra una vista previa antes de escribir nada.

4. Confirmar

Revisa la vista previa (filas detectadas, rango de fechas, dimensiones normalizadas) y haz clic en Importar. Los datos aparecen en tu panel con el marcador de origen Matomo.

Método B — Conectar vía la API de informes de Matomo

Usa esto para una importación sin intervención que extrae todas las dimensiones admitidas en una sola pasada.

1. Crear un token de autenticación en Matomo

En Matomo, ve a Personal → Seguridad → Tokens de autenticación y crea un token nuevo. Copia el valor token_auth — Matomo solo lo muestra una vez.

2. Encontrar tu ID de sitio numérico

En Matomo, el ID de sitio (idSite) es el número que aparece en la URL cuando ves los informes de un sitio, o en Administración → Sitios web → Gestionar. Es un entero simple como 1 o 42.

3. Conectar en Zenovay

Abre el mosaico Matomo → Conectar vía API e introduce:

URL base de Matomo — la raíz de tu instalación de Matomo, p. ej. https://analytics.example.com (sin ruta final).
token_auth — el token del paso 1.
ID de sitio — el idSite numérico del paso 2.

4. Lanzar la importación

Haz clic en Importar últimos 90 días. La importación se ejecuta en segundo plano; la interfaz consulta el estado cada dos segundos y muestra una barra de progreso. Una importación de 90 días suele completarse en 30–60 segundos.

5. Revisar

Cuando termine, verás un resumen: filas importadas, rango de fechas y qué dimensiones se encontraron. Los datos importados aparecen inmediatamente en tu panel con el marcador de origen Matomo.

Una nota sobre la normalización

Matomo y Zenovay categorizan la tecnología de forma ligeramente distinta. Zenovay asigna automáticamente para que tus datos importados y nativos cuadren:

Clase de dispositivo de Matomo Smartphone → Zenovay Mobile; Tablet sigue siendo Tablet; Desktop sigue siendo Desktop.
Los sistemas operativos con sufijo de versión (Windows 11, macOS 15, Android 14, iOS 18) se agrupan bajo su familia canónica (Windows, macOS, Android, iOS).
Los nombres de navegador se cotejan con la lista canónica de Zenovay; las versiones menores/de compilación se descartan.

Si un valor no se puede asignar con seguridad, se conserva tal cual en vez de descartarse.

Resolución de problemas

«No se pudo acceder a Matomo»

Comprueba que la URL base no tenga ruta final y sea accesible por HTTPS desde la internet pública. Las instancias de Matomo detrás de una VPN o una lista de IP permitidas no son accesibles para el importador — usa en su lugar el Método A (subida de archivo).

«token_auth no válido»

Regenera el token en Personal → Seguridad → Tokens de autenticación y pégalo de nuevo. Un token de otro usuario de Matomo sin acceso de lectura al sitio también fallará aquí.

«Sitio no encontrado»

El ID de sitio debe ser el idSite numérico, no el nombre ni el dominio del sitio. Confírmalo en Administración → Sitios web → Gestionar.

«Formato de exportación no reconocido»

El Método A acepta las exportaciones CSV y JSON nativas de Matomo. Los archivos reexportados, editados manualmente o reguardados con una hoja de cálculo pueden perder la fila de cabecera que Zenovay necesita — vuelve a descargarlo directamente desde el widget Exportar de Matomo.

«Importación parcial»

Indica que Matomo ha devuelto menos de 90 días de datos — normalmente porque el sitio tiene menos de 90 días de antigüedad, o porque algunos días no tuvieron tráfico. Verifica por muestreo el rango importado en tu panel.

Los datos difieren ligeramente del panel de Matomo

Matomo deduplica y cuenta visitas de forma distinta a la ingesta nativa de Zenovay, y el filtrado de bots difiere. Espera pequeñas diferencias. El marcador imported_from='matomo' te permite filtrar para comparar lo equivalente.

Distinguir los datos importados

Cada fila importada lleva imported_from='matomo' en analytics_daily. En la Public Stats API de Zenovay (Pro+) puedes filtrar por el mismo campo. Los datos nativos de Zenovay tienen imported_from=NULL.

Reimportar y eliminar

Volver a ejecutar la importación para el mismo periodo hace un UPSERT por fecha, así que es seguro repetirla. Para eliminar los datos de Matomo importados, abre el mosaico Matomo y usa Eliminar datos importados — las filas nativas de Zenovay no se tocan.

Recursos relacionados

¿Necesitas ayuda? Contacta a [email protected] o visita nuestro Centro de ayuda.