Si está migrando de Matomo a Zenovay, el Matomo Importer lleva sus agregados diarios históricos a Zenovay para que conserve todo el contexto el día del cambio. Zenovay se conecta a su API de Reporting de Matomo usando la URL de su instancia, token_auth e ID del sitio, luego extrae el historial directamente. Su instancia de Matomo debe ser accesible públicamente (alojada por su cuenta en un host público o Matomo Cloud).
Qué se importa
- Páginas vistas diarias, visitas y visitantes únicos (en el rango de fechas solicitado)
- Páginas principales, referentes principales, países principales
- Desglose por navegador, tipo de dispositivo y sistema operativo
Qué no se importa
- Sesiones de visitantes individuales o registros de eventos sin procesar
- Dimensiones personalizadas o informes personalizados
- Eventos de e-commerce / ingresos
- Datos en tiempo real (solo días completados; el día actual siempre se excluye)
- Objetivos y conversiones (solo totales diarios agregados)
Qué necesita
- La URL base de su instancia de Matomo (p. ej.
https://analytics.ejemplo.com) - Su
token_auth— encuéntrelo en Matomo bajo Administración → Personal → Seguridad → Tokens de autenticación - Su ID de sitio de Matomo — visible en Administración → Sitios web → Gestionar
Si no desea usar un token personal, cree un token dedicado con acceso de Ver al sitio que está importando, y elimínelo una vez que se complete la importación.
Cómo importar
- Abra la página de detalle de su dominio → pestaña Import.
- Seleccione Matomo, luego cambie al modo Conexión API.
- Ingrese su URL de Matomo,
token_authe ID del sitio. - Haga clic en Conectar e importar y espere a que la barra de progreso finalice.
Por defecto, Zenovay importa aproximadamente los últimos 90 días. La importación se ejecuta en segundo plano, así que puede salir y volver; el estado lo estará esperando en la pestaña Import.
Detrás de las escenas, Zenovay llama a la API de Reporting de Matomo (VisitsSummary.get y Actions.get para totales diarios, más Actions.getPageUrls, Referrers.getReferrers, UserCountry.getCountry y DevicesDetection.* para los desgloses) con sus credenciales. El token_auth se usa únicamente para esta importación; puede revocarlo en Matomo en cualquier momento.
Después de una importación exitosa, revoque o rote su token_auth en Matomo — usar un token de corta duración, de solo lectura, creado específicamente para la importación es el enfoque más seguro.
Verifique su importación
Una vez que la importación se complete, repase esta breve checklist para confirmar que los datos llegaron correctamente. Es el mismo runbook que usa internamente el equipo de Zenovay.
- Abra cualquier vista de analítica en su panel. Los datos importados aparecen al instante, combinados con los datos nativos ya recopilados.
- Verifique 3 días al azar contra su panel de Matomo. Espere ±5 % en páginas vistas y ±3 % en visitas — Matomo y Zenovay deduplicanan visitantes de manera diferente, así que una pequeña diferencia es normal.
- Las filas importadas se etiquetan con
imported_from='matomo'en la base de datos, por lo que siempre puede distinguirlas de los datos recopilados nativamente por Zenovay. (Nota: la API de Stats no exponeimported_fromcomo una clave de filtro consultable — sus filtros cubrencountry,browser,device,os,source, las dimensionesutm_*ypage. Consulte Stats API para la sintaxis de filtro completa.) - Reimporte el mismo período para confirmar la idempotencia. El recuento de filas debe permanecer igual — los duplicados son imposibles debido a la restricción de unicidad a nivel de base de datos.
- Cuando esté satisfecho, elimine o revoque el
token_authque creó para esta importación.
Si alguno de estos controles no se ve bien, escriba a [email protected] con la fecha en que importó y cuáles días se ven mal. Podemos ajustar individualmente días específicos.
Solución de problemas
Mensaje «Disponible en Pro»
El Matomo Importer requiere un plan de pago. Actualizar plan →
«Autenticación fallida»
Verifique su token_auth — distingue mayúsculas de minúsculas. También confirme que la URL base no tenga una barra final y sea accesible públicamente (los servidores de Zenovay no pueden llegar a direcciones de red privadas como http://192.168.1.x). Cree un nuevo token en Matomo bajo Administración → Personal → Seguridad → Tokens de autenticación con al menos permiso de Ver en el sitio de destino.
«ID de sitio no encontrado»
Confirme el ID del sitio en Administración → Sitios web → Gestionar en Matomo. Es el número mostrado junto al nombre de su sitio. Si tiene múltiples sitios, asegúrese de estar usando el ID que corresponde al dominio que está importando en Zenovay.
«Sin datos devueltos»
Si Matomo devuelve informes vacíos para su rango de fechas, verifique que el seguimiento estuviera activo en esas fechas y que el ID del sitio Matomo coincida con el dominio. También verifique que el token_auth tenga acceso de Ver al sitio, no solo acceso de superusuario al área de administración.
«Importación expirada»
Los rangos de fechas muy grandes (varios años) pueden tardar en procesarse. Zenovay reintentará automáticamente. Si la importación sigue expirada, intente dividir el rango de fechas en fragmentos más pequeños (p. ej. importar un año a la vez) y reimportar — la restricción de idempotencia hace que los rangos superpuestos sean seguros.
Preguntas frecuentes
¿Sobrescribirá mis datos nativos de Zenovay?
No. Las filas importadas se etiquetan con imported_from='matomo'. Se almacenan junto a (no sobre) los datos que recopila nativamente con el script de seguimiento, por lo que siempre son distinguibles en la base de datos.
¿Puedo reimportar? Sí, en cualquier momento. Reimportar sobrescribe el mismo rango de fechas limpiamente — sin duplicados, sin filas huérfanas.
¿Es gratuita la importación de Matomo? No. El Matomo Importer (como otros importadores de análisis) requiere un plan Pro o superior.
¿Qué zona horaria usan los totales diarios importados? Las filas importadas usan la zona horaria configurada en su sitio de Matomo para la dimensión de fecha. Si su sitio de Matomo está configurado en Europe/Londres, «2026-05-16» en la importación significa un día completo en hora de Londres.
¿Zenovay almacena mi token_auth?
No. Su token_auth se envía con la solicitud de importación, se usa únicamente para hacer las llamadas de la API de Reporting de Matomo para esa única importación, y luego se descarta. No se guarda en una base de datos de Zenovay ni se reutiliza. Aun así, una vez completada la importación, debe revocar o eliminar el token en Matomo como precaución.
¿Verá Zenovay datos personales de mis visitantes? No. La API de Reporting de Matomo devuelve solo estadísticas agregadas (totales, listas Top-N). Ningún registro de visitante individual, dirección IP o ID de usuario se transfiere a Zenovay.
¿Afecta esto a mis datos de Matomo? No. El importador es de solo lectura. Zenovay nunca escribe en su instancia de Matomo.