Matomo Analytics

:discourse2: Résumé Matomo Analytics est un script permettant d’activer l’analyse Matomo sur Discourse.
:hammer_and_wrench: Lien du dépôt https://github.com/discourse/discourse-matomo-analytics
:open_book: Nouveau dans les thèmes Discourse ? Guide du débutant pour utiliser les thèmes Discourse

Installer ce composant de thème

Fonctionnalités

Matomo est une plateforme d’analyse open source. Les utilisateurs peuvent choisir entre l’auto-hébergement ou le paiement d’un hébergement professionnel dans le cloud.

:mega: Matomo s’appelait auparavant Piwik. Voir Piwik is now Matomo - Announcement - Analytics Platform - Matomo pour plus de détails sur le changement de nom.

Pour activer l’analyse Matomo sur votre forum Discourse, tout ce que vous avez à faire est d’installer le composant de thème officiel.

Valable pour l’API Matomo v1.5 et versions ultérieures

  1. Suivez le guide d’installation du thème pour importer depuis l’URL suivante :

    https://github.com/discourse/discourse-matomo-analytics.git
    

    Et vous verrez

  2. Entrez l’URL de l'hôte et l’ID du site

  3. Ajoutez le composant de thème “Matomo Analytics” à vos thème(s) actif(s).

C’est tout !

Paramètres

Nom Description
host url URL de l’hôte sans http:// ou https://
website id
exclude groups Liste séparée par des virgules des groupes à exclure du suivi, tels que les administrateurs, le personnel
user id tracking Un nom de champ identifiant sur l’objet utilisateur actuel, tel que id, username ou external_id.
subdomain tracking Suivre les visiteurs sur le domaine principal et les sous-domaines, en supposant que discourse est sur un sous-domaine.
do not track Ainsi, les requêtes de suivi ne seront pas envoyées si les visiteurs ne souhaitent pas être suivis.
disable cookies Désactive tous les cookies de première partie. Les cookies Matomo existants pour ce site seront supprimés lors de la prochaine page vue.

Crédits

Merci à @mattab & @brahn @tagtomat et @simon


:discourse2: Hébergé par nous ? Les composants de thème sont disponibles sur nos plans Standard, Business et Enterprise.

38 « J'aime »

Thanks for this howto, works fine for me. :thumbsup:

In order to comply with the European laws, users must have the possibility to reject piwik’s cookie. Piwik offers a really simple solution for this, by including an IFrame.

Unfortunately, Discourse doesn’t allow iframe tags in posts… :grimacing:
Does anyone see a way to include this piwik iframe in Discourse TOS ?
Thanks.

1 « J'aime »

:wave: I just created a new “Matomo Analytics” theme component, and updated the instructions on how to set it up.

Could you give it a try? Please also remember to remove the original custom scripts.

8 « J'aime »

Looks good on first sight. No error in javascript console. Requests to piwik.php being in the webserver log again.

Statistics in Matomo are available as well.

5 « J'aime »

Is this iframe thing still a concern?

1 « J'aime »

Hey @xrav3nz :clap: your component works great - thanks!

Yes it is. Opt-out should be possible, and Matomo provides this via including an iFrame: see Matomo documentation

3 « J'aime »

This doesn’t appear to be working for me at the moment? I can add the component, and add the correct URL and siteid, but it doesn’t render anything:

I added the comments around the code to find it quicker in the page:

1 « J'aime »

We are on beta 6+git1 on our instance

Inline JavaScripts in themes and components are automatically extracted to an external “theme JavaScript” file.

Could you try checking the one immediately after your comments?

7 « J'aime »

This is at the main page on https://discuss.pixls.us:

Edit
Hold on, I’ve got a new hash on the file on recent refresh, it looks like the code is there. Thank you @xrav3nz!

Looks like it’s working now - not sure what I was doing wrong yesterday - user error.

5 « J'aime »

So I have the JS loaded into the theme customizations, and the external “theme JavaScript file”* is linked in my test browser, just under where I inserted it like in the screenshot in a few posts earlier … BUT the requests aren’t coming through to the Matomo tracking web server.

(Tracking works fine for other non-Discourse sites, FWIW.)

Has anyone else seen that happen?


* e.g. https://discourse-cdn.example.com/standard11/theme-javascripts/{numeric_string}.js?__ws=my-discourse-forum.example.org

Merci pour le composant !

Je ne comprends pas pourquoi le code de suivi envoie une variable personnalisée appelée Anonymous. N’est-ce pas spécifique à votre configuration Matomo ? Cela ne semble pas devoir être présent pour tout le monde.

_paq.push(['setCustomVariable', 1, 'Anonymous', !currentUser, 'visit']);

J’ai ajouté quelques lignes afin de permettre le suivi des visiteurs entre Discourse sur un sous-domaine et un site principal. Je suis prêt à envoyer une demande de fusion si vous le souhaitez.

Vous devez ajouter votre URL Matomo à la liste blanche dans l’en-tête Content-Security-Policy. Recherchez le paramètre d’administration content_security_policy_script_src et ajoutez votre domaine (avec https://) à cet endroit.

6 « J'aime »

J’ai du mal à faire fonctionner cela sur mon installation. J’ai installé le composant et l’ai ajouté à mon thème, mais Matomo indique qu’il n’y a pas de données pour le site. Je pensais avoir les paramètres corrects :


image
Mais je vois cette erreur dans la console de mon navigateur :
image
…et lorsque je consulte le site dans Matomo, j’obtiens ceci :

Qu’est-ce que j’oublie ?

Édition : Des investigations supplémentaires révèlent que l’erreur dans la console JavaScript n’apparaît que dans Firefox, pas dans Chrome (avec les dernières versions de chacun sur un Mac). Et je vois maintenant certains résultats dans Matomo, bien que Firefox soit remarquablement absent ; tous les visiteurs sauf un utilisent Chrome ; la seule exception utilise Safari.

Des idées à ce sujet ? Ce post :

suggère qu’il pourrait s’agir des paramètres « Ne pas me suivre » de Firefox, mais même lorsque je les désactive pour mon site, j’obtiens la même erreur dans la console web avec Firefox. Et Firefox ne semble de toute façon pas considérer cela comme un traqueur :

Essayez de supprimer le dernier / de “https://www.familybrown.org/analytics/” → “https://www.familybrown.org/analytics

1 « J'aime »

Merci. Malheureusement, je rencontre toujours la même erreur :
image

Pourriez-vous me donner l’URL de votre forum ?

Ces deux champs doivent-ils être remplis ? Je ne les comprends pas vraiment.