Integración domótica Matomo, gratuita y de código abierto
Visitantes ahora, visitas y conversiones del día de sus sitios Matomo en Gladys.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Matomo es la plataforma libre (GPL-3.0) de analítica web, autoalojada o en Matomo Cloud. Esta integración trae las cifras de sus sitios Matomo a Gladys: cada sitio se convierte en un dispositivo con sus visitantes ahora mismo y sus visitantes únicos, visitas, páginas vistas, conversiones de objetivos y tasa de rebote del día. Las escenas pueden reaccionar a un pico de visitantes, al primer visitante del día, a un objetivo alcanzado o a un sitio que ya no recibe visitas (un código de seguimiento roto); un widget del panel muestra el día de un vistazo, y una acción de escena pone las cifras de un sitio en un mensaje.
Probada con un Matomo 5.14.2 real autoalojado (Docker, MariaDB); todavía no en Matomo Cloud: sus comentarios son bienvenidos en las issues.
Lo que necesita
- Gladys Assistant 5.1.0 o posterior.
- Un Matomo 4 o 5, autoalojado o en Matomo Cloud, accesible desde la máquina de Gladys.
- Un token de autenticación (
token_auth) de un usuario de Matomo con acceso de lectura («Ver») a los sitios. Mejor un usuario dedicado solo de lectura: el token tiene los derechos de su usuario.
En cada actualización, la integración envía una petición a la API de Matomo para hasta 20 sitios (una petición agrupada: visitantes de los últimos 30 minutos, visitas, páginas vistas y objetivos del día), más la lista de sitios cada 10 minutos. El token va siempre en el cuerpo de una petición POST, nunca en una dirección. Gladys acepta 300 estados por minuto: con el intervalo de 30 segundos, añada como máximo 25 sitios a Gladys.
Primeros pasos
1. Crear un token
En Matomo, como superusuario, cree un usuario con el acceso Ver a los sitios que quiere seguir (Administración → Sistema → Usuarios), o use su propia cuenta. Con la sesión de ese usuario, abra Personal → Seguridad → Tokens de autenticación, haga clic en Crear nuevo token y copie el token (32 caracteres, se muestra una sola vez).
2. Configurar la integración
En Gladys, abra Integraciones → Matomo → Configuración:
- Dirección de Matomo: la dirección con la que abre Matomo, por ejemplo
https://stats.example.org,http://192.168.1.10:8080ohttps://example.matomo.cloud. Una dirección copiada del navegador se entiende; una subcarpeta (https://example.org/matomo) se conserva. - Token de autenticación: el token del paso 1.
- Intervalo de actualización: de 30 segundos a 5 minutos (1 minuto por defecto).
- Pico de visitantes a partir de: los visitantes simultáneos que activan «Pico de visitantes» (10 por defecto).
- Sin visitas desde hace (horas): las horas sin ninguna visita que activan «Sin visitas desde hace un tiempo» (24 por defecto).
- Idioma de los nombres: idioma de los nombres de las funciones y de los resultados de escena (francés por defecto).
Guarde y haga clic en Probar la conexión: el resultado da la versión de Matomo, el número de sitios, los visitantes únicos del día y los visitantes ahora mismo.
3. Añadir los sitios
Abra la pestaña Descubrir: cada sitio se propone con su nombre. Añada los que quiera ver en Gladys. Los desencadenantes de escena y el widget funcionan para todos los sitios, añadidos o no.
Los dispositivos
Cada sitio se convierte en un dispositivo con:
- Visitantes ahora mismo: los visitantes de los últimos 30 minutos, como en el widget «Visitantes en tiempo real» de Matomo.
- Visitantes únicos hoy: visitantes únicos del día.
- Visitas hoy: visitas del día.
- Páginas vistas hoy: páginas vistas del día.
- Conversiones de objetivos hoy: conversiones de todos los objetivos del sitio.
- Tasa de rebote hoy: la parte de las visitas que solo vieron una página, en porcentaje.
«Hoy» es el día del sitio en Matomo (su zona horaria, en los ajustes del sitio): las cifras del día vuelven a 0 a su medianoche. Un valor que no cambia se envía de nuevo cada 12 horas, para que Gladys lo mantenga reciente. La insignia de los dispositivos indica «local» para su propio servidor, «nube» para Matomo Cloud, e «inaccesible» cuando Matomo no responde.
Panel
El widget Matomo hoy muestra cinco mosaicos (visitantes ahora mismo, visitantes únicos, visitas, páginas vistas y objetivos del día), sumados sobre los sitios mostrados, y luego una fila por sitio con sus visitantes únicos del día y sus visitantes ahora mismo, el más visitado primero. En los ajustes del widget, elija sitios para mostrar solo esos (dispositivos añadidos a Gladys). El botón Actualizar vuelve a leer Matomo.
Escenas
Desencadenantes
- Pico de visitantes: los visitantes ahora mismo de un sitio alcanzan el umbral de la configuración. Una vez por pico, y 30 minutos como mínimo entre dos avisos para un sitio: un pico que sigue al final de la pausa se avisa entonces. Variables: nombre del sitio, dominio, visitantes ahora mismo, umbral.
- Primer visitante del día: un sitio recibe su primer visitante del día. Variables: nombre del sitio, dominio, visitantes únicos hoy.
- Objetivo alcanzado: un sitio registra nuevas conversiones de objetivos. Variables: nombre del sitio, dominio, nuevas conversiones, conversiones hoy.
- Sin visitas desde hace un tiempo: un sitio que tenía visitas no recibe ninguna durante las horas de la configuración: quizá el código de seguimiento falla, o el sitio está caído. Una vez, hasta que vuelva una visita. Variables: nombre del sitio, dominio, horas sin visitas.
Cada desencadenante puede limitarse a algunos sitios (vacío: todos). Lo que
recuerdan los desencadenantes se guarda en el volumen /data: un reinicio de
Gladys o de la integración no avisa dos veces de un pico, de un primer
visitante o de una conversión. No se avisa de nada en la primera lectura de
un sitio: un pico o un silencio ya en curso solo se registra. Si la
integración estaba detenida, las conversiones y el primer visitante del
intervalo se avisan en la primera lectura tras su reinicio.
Acciones
- Leer las cifras de un sitio: da el nombre (
name), los visitantes ahora mismo (active), losvisitors,visits,pageviews,conversionsybounce_ratedel día, y una frase lista (sentence), por ejemplo «Blog: 15 visita(s) y 41 página(s) vista(s) hoy, 2 ahora mismo, 1 conversión(es) de objetivos.».
Ideas de escenas
- Cuando Objetivo alcanzado se active para su tienda, enviar un mensaje de Telegram «{{website}}: {{conversions}} nueva(s) conversión(es), {{total}} hoy».
- Cuando Sin visitas desde hace un tiempo se active, enviar una notificación «Sin visitas en {{website}} desde hace {{hours}} h: revise el código de seguimiento».
- Cada tarde a las 21:00, Leer las cifras de un sitio y enviar la frase por mensaje.
- Con la función Visitantes ahora mismo como condición de escena, encender una lámpara en verde mientras alguien está en el sitio.
Solución de problemas
- «token rechazado»: el token es incorrecto, se borró o caducó: cree uno nuevo en Personal → Seguridad.
- «no hay ningún Matomo en esta dirección»: revise la dirección y el
puerto; es la carpeta donde está
index.php. - «la dirección redirige»: introduzca directamente la dirección
https://. - «certificado rechazado»: el certificado HTTPS es autofirmado o está
caducado: use la dirección
http://en su red, o un certificado reconocido. - «Matomo indica un error»: los registros de la integración dan el mensaje de Matomo (error de base de datos, plugin desactivado…).
- Falta un sitio: el usuario del token necesita el acceso Ver a él. La lista se vuelve a leer cada 10 minutos, o con Buscar en la pestaña Descubrir.
- Las cifras del día avanzan por escalones: Matomo las recalcula como mucho cada 15 minutos por defecto (Administración → Sistema → Configuración general → Archivar informes como máximo cada X segundos), o en cada tarea cron de archivado si el archivado por el navegador está desactivado. «Objetivo alcanzado» las sigue. Los visitantes ahora mismo siempre son en directo.
- Conversiones de objetivos hoy se queda vacío: el plugin Goals está desactivado. Visitantes ahora mismo se queda vacío: el plugin Live, o el registro de visitas, está desactivado.
- Los registros de la integración (Integraciones → Matomo) dicen más; no se escribe nada en ellos durante un ciclo de lectura normal.
Límites
- Solo lectura: la integración no cambia nada en Matomo.
- Las cifras son las de Matomo en el momento de la lectura, con el intervalo de actualización como retraso (y el archivado de Matomo para las cifras del día).
- Un servidor Matomo por integración, 200 sitios como máximo.
- Los umbrales de «Pico de visitantes» y «Sin visitas desde hace un tiempo» son los mismos para todos los sitios; «Objetivo alcanzado» cuenta todos los objetivos de un sitio juntos.
- Matomo 3 y anteriores no son compatibles.
- Todavía no probada en Matomo Cloud, y sin relación con Matomo ni InnoCraft.
Parámetros de configuración
Estos son los parámetros que Matomo te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su Matomo | section | No | La dirección de su Matomo (autoalojado o Matomo Cloud) y un token de autenticación de un usuario con acceso de lectura (Personal → Seguridad → Tokens de autenticación). Después añada los sitios desde la pestaña Descubrir. |
| Dirección de Matomo | string | Sí | La dirección con la que abre Matomo, p. ej. https://stats.example.org o https://example.matomo.cloud. |
| Token de autenticación | secret | Sí | token_auth de un usuario solo con acceso de lectura: 32 caracteres. |
| Opciones | section | No | |
| Intervalo de actualización | select | No | Con qué frecuencia se lee Matomo: una petición de API para hasta 20 sitios cada vez. |
| Pico de visitantes a partir de | number | No | Visitantes simultáneos (últimos 30 minutos) que activan el disparador de escena «Pico de visitantes». |
| Sin visitas desde hace (horas) | number | No | Horas sin ninguna visita que activan el disparador de escena «Sin visitas desde hace un tiempo». |
| Idioma de los nombres | select | No | Idioma de los nombres de las funciones (fijados al añadir un dispositivo) y de los resultados de escena. |
Cómo instalar Matomo en Gladys
- En Gladys, abre Integraciones: Matomo aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-matomo:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-matomo.
Matomo requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Matomo es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación