Intégration domotique Matomo, gratuite et open source

Visiteurs en ce moment, visites et objectifs du jour de vos sites Matomo dans Gladys.

• Publiée par guim31
• Appareils
• Version 1.0.0
• Nécessite Gladys >=5.1.0
• ★ 0

Voir sur GitHubToutes les intégrations

Matomo est la plateforme libre (GPL-3.0) de mesure d'audience web, auto-hébergée ou sur Matomo Cloud. Cette intégration amène les chiffres de vos sites Matomo dans Gladys : chaque site devient un appareil avec ses visiteurs en ce moment et ses visiteurs uniques, visites, pages vues, objectifs atteints et taux de rebond du jour. Des scènes peuvent réagir à un pic de visiteurs, au premier visiteur de la journée, à un objectif atteint, ou à un site qui ne reçoit plus de visites (un code de suivi cassé) ; un widget de tableau de bord montre la journée d'un coup d'œil, et une action de scène met les chiffres d'un site dans un message.

Testée sur un vrai Matomo 5.14.2 auto-hébergé (Docker, MariaDB) ; pas encore sur Matomo Cloud : vos retours sont les bienvenus dans les issues.

Ce qu'il vous faut

• Gladys Assistant 5.1.0 ou plus récent.
• Un Matomo 4 ou 5, auto-hébergé ou sur Matomo Cloud, joignable depuis la machine de Gladys.
• Un jeton d'authentification (token_auth) d'un utilisateur Matomo qui a l'accès en lecture (« Vue ») aux sites. Un utilisateur dédié en lecture seule est préférable : le jeton donne les droits de son utilisateur.

À chaque rafraîchissement, l'intégration envoie une requête à l'API de Matomo pour 20 sites au plus (une requête groupée : visiteurs des 30 dernières minutes, visites, pages vues et objectifs du jour), plus la liste des sites toutes les 10 minutes. Le jeton part toujours dans le corps d'une requête POST, jamais dans une adresse. Gladys accepte 300 états par minute : avec l'intervalle de 30 secondes, ajoutez 25 sites au plus à Gladys.

Mise en route

1. Créer un jeton

Dans Matomo, en super utilisateur, créez un utilisateur avec l'accès Vue sur les sites à suivre (Administration → Système → Utilisateurs), ou utilisez votre propre compte. Connecté avec cet utilisateur, ouvrez Personnel → Sécurité → Jetons d'authentification, cliquez sur Créer un nouveau jeton, et copiez le jeton (32 caractères, affiché une seule fois).

2. Configurer l'intégration

Dans Gladys, ouvrez Intégrations → Matomo → Configuration :

• Adresse de Matomo : l'adresse avec laquelle vous ouvrez Matomo, par exemple https://stats.example.org, http://192.168.1.10:8080 ou https://example.matomo.cloud. Une adresse copiée depuis le navigateur est comprise ; un sous-dossier (https://example.org/matomo) est gardé.
• Jeton d'authentification : le jeton de l'étape 1.
• Intervalle de rafraîchissement : de 30 secondes à 5 minutes (1 minute par défaut).
• Pic de visiteurs à partir de : les visiteurs simultanés qui déclenchent « Pic de visiteurs » (10 par défaut).
• Aucune visite depuis (heures) : les heures sans aucune visite qui déclenchent « Aucune visite depuis un moment » (24 par défaut).
• Langue des noms : langue des noms des fonctionnalités et des résultats de scène (français par défaut).

Enregistrez, puis cliquez sur Tester la connexion : le résultat donne la version de Matomo, le nombre de sites, les visiteurs uniques du jour et les visiteurs en ce moment.

3. Ajouter les sites

Ouvrez l'onglet Découverte : chaque site y est proposé avec son nom. Ajoutez ceux que vous voulez voir dans Gladys. Les déclencheurs de scène et le widget fonctionnent pour tous les sites, ajoutés ou non.

Les appareils

Chaque site devient un appareil avec :

• Visiteurs en ce moment : les visiteurs des 30 dernières minutes, comme dans le widget « Visiteurs en temps réel » de Matomo.
• Visiteurs uniques aujourd'hui : visiteurs uniques du jour.
• Visites aujourd'hui : visites du jour.
• Pages vues aujourd'hui : pages vues du jour.
• Objectifs atteints aujourd'hui : conversions de tous les objectifs du site.
• Taux de rebond aujourd'hui : la part des visites qui n'ont vu qu'une page, en pourcentage.

« Aujourd'hui » est le jour du site dans Matomo (son fuseau horaire, dans les réglages du site) : les chiffres du jour repartent de 0 à son minuit. Une valeur qui ne change pas est renvoyée toutes les 12 heures, pour que Gladys la garde récente. Le badge des appareils indique « local » pour votre propre serveur, « cloud » pour Matomo Cloud, et « injoignable » quand Matomo ne répond pas.

Tableau de bord

Le widget Matomo aujourd'hui montre cinq tuiles (visiteurs en ce moment, visiteurs uniques, visites, pages vues et objectifs du jour), additionnées sur les sites affichés, puis une ligne par site avec ses visiteurs uniques du jour et ses visiteurs en ce moment, le plus fréquenté d'abord. Dans les réglages du widget, choisissez des sites pour n'afficher qu'eux (appareils ajoutés à Gladys). Le bouton Actualiser relit Matomo.

Scènes

Déclencheurs

• Pic de visiteurs : les visiteurs en ce moment d'un site atteignent le seuil de la configuration. Une fois par pic, et 30 minutes au moins entre deux annonces pour un site : un pic qui dure encore à la fin de la pause est annoncé à ce moment-là. Variables : nom du site, domaine, visiteurs en ce moment, seuil.
• Premier visiteur de la journée : un site reçoit son premier visiteur du jour. Variables : nom du site, domaine, visiteurs uniques aujourd'hui.
• Objectif atteint : un site enregistre de nouvelles conversions d'objectifs. Variables : nom du site, domaine, nouvelles conversions, conversions aujourd'hui.
• Aucune visite depuis un moment : un site qui avait des visites n'en reçoit plus pendant les heures de la configuration : le code de suivi est peut-être cassé, ou le site en panne. Une fois, jusqu'au retour d'une visite. Variables : nom du site, domaine, heures sans visite.

Chaque déclencheur peut être limité à certains sites (vide : tous). Ce dont les déclencheurs se souviennent est gardé dans le volume /data : un redémarrage de Gladys ou de l'intégration n'annonce pas deux fois un pic, un premier visiteur ou une conversion. Rien n'est annoncé à la première lecture d'un site : un pic ou un silence déjà en cours est seulement enregistré. Si l'intégration était arrêtée, les conversions et le premier visiteur de l'intervalle sont annoncés à la première lecture après son redémarrage.

Actions

• Lire les chiffres d'un site : donne le nom (name), les visiteurs en ce moment (active), les visitors, visits, pageviews, conversions et bounce_rate du jour, et une phrase toute prête (sentence), par exemple « Blog : 15 visite(s) et 41 page(s) vue(s) aujourd'hui, 2 en ce moment, 1 objectif(s) atteint(s). ».

Idées de scènes

• Quand Objectif atteint se déclenche pour votre boutique, envoyer un message Telegram « {{website}} : {{conversions}} nouvelle(s) conversion(s), {{total}} aujourd'hui ».
• Quand Aucune visite depuis un moment se déclenche, envoyer une notification « Aucune visite sur {{website}} depuis {{hours}} h : vérifier le code de suivi ».
• Chaque soir à 21 h, Lire les chiffres d'un site et envoyer la phrase par message.
• Avec la fonctionnalité Visiteurs en ce moment en condition de scène, allumer une lampe en vert tant que quelqu'un est sur le site.

Dépannage

• « jeton refusé » : le jeton est faux, supprimé ou expiré : créez-en un nouveau dans Personnel → Sécurité.
• « aucun Matomo à cette adresse » : vérifiez l'adresse et le port ; c'est le dossier où se trouve index.php.
• « l'adresse redirige » : saisissez directement l'adresse en https://.
• « certificat refusé » : le certificat HTTPS est auto-signé ou expiré : utilisez l'adresse http:// dans votre réseau, ou un certificat reconnu.
• « Matomo signale une erreur » : les logs de l'intégration donnent le message de Matomo (erreur de base de données, extension désactivée…).
• Un site manque : l'utilisateur du jeton doit y avoir l'accès Vue. La liste est relue toutes les 10 minutes, ou avec Rechercher dans l'onglet Découverte.
• Les chiffres du jour avancent par paliers : Matomo les recalcule au plus toutes les 15 minutes par défaut (Administration → Système → Paramètres généraux → Archiver les rapports au maximum toutes les X secondes), ou à chaque tâche cron d'archivage si l'archivage par le navigateur est désactivé. « Objectif atteint » les suit. Les visiteurs en ce moment sont toujours en direct.
• Objectifs atteints aujourd'hui reste vide : l'extension Goals est désactivée. Visiteurs en ce moment reste vide : l'extension Live, ou le journal des visites, est désactivé.
• Les logs de l'intégration (Intégrations → Matomo) en disent plus ; rien n'y est écrit pendant un cycle de lecture normal.

Limites

• Lecture seule : l'intégration ne modifie rien dans Matomo.
• Les chiffres sont ceux de Matomo au moment de la lecture, avec l'intervalle de rafraîchissement comme délai (et l'archivage de Matomo pour les chiffres du jour).
• Un serveur Matomo par intégration, 200 sites au plus.
• Les seuils de « Pic de visiteurs » et « Aucune visite depuis un moment » sont les mêmes pour tous les sites ; « Objectif atteint » compte tous les objectifs d'un site ensemble.
• Matomo 3 et plus ancien ne sont pas pris en charge.
• Pas encore testée sur Matomo Cloud, et sans lien avec Matomo ni InnoCraft.

Paramètres de configuration

Voici les paramètres demandés par Matomo dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Votre Matomo	section	Non	L'adresse de votre Matomo (auto-hébergé ou Matomo Cloud) et un jeton d'authentification d'un utilisateur en lecture (Personnel → Sécurité → Jetons d'authentification). Ajoutez ensuite les sites depuis l'onglet Découverte.
Adresse de Matomo	string	Oui	L'adresse avec laquelle vous ouvrez Matomo, ex. https://stats.example.org ou https://example.matomo.cloud.
Jeton d'authentification	secret	Oui	token_auth d'un utilisateur en lecture seule : 32 caractères.
Options	section	Non
Intervalle de rafraîchissement	select	Non	À quelle fréquence Matomo est lu : une requête d'API pour 20 sites au plus à chaque fois.
Pic de visiteurs à partir de	number	Non	Visiteurs simultanés (30 dernières minutes) qui déclenchent le déclencheur de scène « Pic de visiteurs ».
Aucune visite depuis (heures)	number	Non	Heures sans aucune visite qui déclenchent le déclencheur de scène « Aucune visite depuis un moment ».
Langue des noms	select	Non	Langue des noms des fonctionnalités (fixés à l'ajout d'un appareil) et des résultats de scène.

Comment installer Matomo dans Gladys

1. Dans Gladys, ouvrez Intégrations : Matomo apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-matomo:1.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-matomo.

Matomo nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes

Matomo est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.

• Parcourir toutes les intégrations, natives et communautaires
• Créer et publier votre propre intégration externe
• Code source sur GitHub — source de cette documentation

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂