Questions fréquentes

Comment activer les statistiques sur mon site web ou application ?

Remarque : En activant le suivi des visites, vous acceptez que les statistiques de visites de votre site web soient publiques.

Premier cas : Votre site ou application est la seule de son espace de nommage (profil ou groupe)

Copiez le code suivant dans l’en-tête <head> des fichiers HTML de votre site web.

<!-- Matomo -->
<script>
    var _paq = window._paq = window._paq || [];
    /* tracker methods like "setCustomDimension" should be called before "trackPageView" */
    _paq.push(['setDocumentTitle', window.location.hostname]);
    _paq.push(['trackPageView']);
    _paq.push(['enableLinkTracking']);
    (function() {
        var u="https://wa.phm.education.gouv.fr/snp/";
        _paq.push(['setTrackerUrl', u+'matomo.php']);
        _paq.push(['setSiteId', '17']);
        var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
        g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
    })();
</script>

Si vous comprenez ce code mais qu’il vous surprend, lisez les discussions techniques plus bas.

Second cas : Plusieurs projets de votre espace de nommage (utilisateur·ice ou groupe) publient des gitlab-pages

Ils partagent alors tous le même nom de domaine, de la forme https://utilisateur_ou_groupe.forge.apps.education.fr/, et il faut pouvoir différencier les différents projets qui s’y trouvent.

Utilisez le même code que précédemment, en remplaçant la ligne :

_paq.push(['setDocumentTitle', window.location.hostname]);

par :

_paq.push(['setDocumentTitle', `${window.location.hostname}/PROJET`]);

où PROJET est l’identifiant du projet (au sens de Gitlab). Par exemple :

Cas particulier n°1 : Mon site utilise un nom de domaine unique (de la forme https://projet-123abc.forge.apps.education.fr/)

Contexte

Il est possible de ne plus utiliser les noms de domaines uniques, mais cela impose certaines contre-parties :

Solution 1

Désactivez le nom de domaine unique. Vous devrez alors utiliser soit le premier cas si c’est le seul projet à suivre, soit le second s’il y a plusieurs projets dans le même espace de nommage.

Solution 2

Pour un projet bien établi dont vous souhaitez garder le nom de domaine unique, suivez les instructions du cas où le site web n’est pas sur la forge (cas particulier 2).

Cas particulier n°2 : Mon site web est hébergé ailleurs (son URL n’est pas de la forme https://blablabla.forge.apps.education.fr/blablabla) ?

Ceci concerne des projets dont le code source est sur la forge, mais dont le rendu du projet est hébergé ailleurs. Dans ce cas, il va falloir « simuler » le fait que le site est hébergé sur la Forge, en utilisant le code du premier cas, et en remplaçant la ligne

_paq.push(['setDocumentTitle', window.location.hostname]);

par

_paq.push(['setDocumentTitle', "ESPACE.forge.apps.education.fr/SOUSGROUPES/PROJET"]);

en remplaçant ESPACE, et les éventuels SOUSGROUPE ou PROJET par les informations correspondant dans la structure du dépôt sur la forge.

Par exemple, pour le projet https://forge.apps.education.fr/komit/tagada/tsoin/tsoin, hébergé sur https://la-fraise.tsoin.tsoin.example.com/, utilisez :

_paq.push(['setDocumentTitle', "komit.forge.apps.education.fr/tagada/tsoin/tsoin"]);

Respectez ces règles pour que :

Que signifient les icônes ?

Dans tous les cas, les données sont mises à jour chaque semaine, donc il faut attendre une semaine avant la création du dépôt ou l’activation des statistiques sur les pages, et qu’il y ait au moins une visite sans bloqueur de trackers, pour que les données apparaissent ici.

Si ça ne fonctionne toujours pas venez disctuer avec nous.

Comment voir les statistiques de visite ?

Allez sur la page principale https://stats.forge.apps.education.fr, et recherchez votre site dans la colonne de gauche.

Les statistiques de votre site web seront visibles au maximum une semaine après la mise en place de ce code, si votre site web a au moins une visite.

Si cela ne fonctionne pas, venez poser votre question sur notre salon Tchap.

Comment voir les statistiques par page ?

Cette méthode ne permet que d’agréger les statistiques de visite pour l’ensemble du site web, mais pas de faire la différence par page.

Pourquoi mon projet n’apparait pas ?

Dans les deux cas, puisque les données sont mises à jour toutes les semaines, il faut attendre une semaine avant la création du dépôt et l’activation des statistiques sur les pages.

Si cela ne répond pas à la question, contactez nous.

Discussions techniques : Dialogue

Heu… Vous renseignez l’URL (enfin, le nom de domaine) dans le champ prévu par Matomo pour le titre de la page. Pourquoi ?

Matomo permet de gérer plusieurs sites web, mais pour différentes raisons (parce que nous ne sommes pas administrateurs sur l’instance, que nous ne voulons pas gérer des centaines de sites différents — un pour chaque projet), nous « trichons » (un hack au sens noble du terme) en utilisant un seul site (au sens de Matomo) pour gérer l’ensemble des sites webs hébergés sur la Forge.

Pour cela, puisque Matomo, prévu pour gérer un seul site web, d’un seul nom de domaine, ne conserve que la partie de l’URL arrivant après le nom de domaine (ce qui ne nous permet pas de différencier les pages https://brigit.forge.apps.education.fr/index.html et https://komit.forge.apps.education.fr/index.html), nous utilisons le champ prévu pour le titre de la page pour y insérer l’URL (partielle) avec son nom de domaine.

Remarque : Avoir notre propre Matomo, avec une procédure automatisée pour ouvrir un nouvel espace, est en cours de discussion. Patience…

Du coup, il n’est pas possible de voir les statistiques par page, pour un site web donné ? Matomo permet pourtant cela, non ?

Oui, mais le hack décrit à la partie précédente, qui simplifie notre gestion (un seul site au sens de Matomo, un seul code pour tous les projets, sans avoir besoin de créer un nouveau site dans Matomo pour chaque nouveau projet), nous empêche en contrepartie d’avoir cette vue fine des statistiques par page.

Mais Matomo permet pourtant nativement de suivre les statistiques de plusieurs sites web ! Pourquoi vous embêter avec ce hack ?

Nous utilisons une instance partagée avec d’autres services, et nous n’avons à notre disposition qu’un seul espace pour l’ensemble de la forge : nous n’avons pas les droits d’administration sur cette instance, donc nous ne pouvons pas créer un espace pour chacun des sites web. Et même si nous le pouvions, cela voudrait dire qu’à chaque fois qu’une personne veut suivre les visites d’un nouveau projet, elle devrait nous demander la création d’un nouvel espace sur Matomo, ce qui fait du travail de votre côté et du nôtre. Nous avons choisi cette solution en raison des limites techniques, administratives, et pour limiter notre charge de travail que nous préférons consacrer à d’autres aspects de la Forge.

Encore une fois, avoir notre propre Matomo, avec une procédure automatisée pour ouvrir un nouvel espace, est en cours de discussion. Patience…

J’ai vu dans la documentation qu’en activant l’option X dans l’interface d’administration, il est possible de…

Nous ne disposons pas des droits d’administration, nous ne pouvons pas faire cela.

Pourquoi ne pas utiliser l’URL complète du site web (plutôt que simplement le domaine, en ajoutant éventuellement à la main le projet) ? C’est faisable automatiquement en javascript.

Nous y avons pensé, mais il n’y aurait alors pas moyen de différencier un groupe d’un sous groupe (à moins de faire plein d’appels à l’API de Gitlab). Par exemple, https://komit.forge.apps.education.fr/tagada/tsoin/tsoin est-elle :

Et si je ne respecte pas le chemin demandé dans la première partie, mais que j’utilise un chemin différent pour chacune des pages ?

Voici ce qu’il peut arriver si le texte proposé n’est pas reconnu par notre outil comme étant l’URL d’un dépôt de la forge :

À propos

Une autre question ?

Vous pouvez nous contacter par ici.