Matomo-Analyse

[Discourse]

	Zusammenfassung	Matomo Analytics ist ein Skript zur Aktivierung von Matomo-Analytics auf Discourse.
	Repository-Link	https://github.com/discourse/discourse-matomo-analytics
	Neu bei Discourse-Themes?	Einsteigeranleitung zur Verwendung von Discourse-Themes

Installiere diese Theme-Komponente

Da dies eine von der Discourse-Community gepflegte #offizielle Theme-Komponente ist, können Support, Contribute > Bug, Contribute > UX und #contribute:feature-Anfragen in den entsprechenden Kategorien hier auf Meta gestellt und mit dem passenden Tag für die Theme-Komponente versehen werden. Klicke auf einen der untenstehenden Links, um eine Anfrage zu starten.

 Support  Bug  UX  Feature

Funktionen

Matomo ist eine Open-Source-Analytics-Plattform. Nutzer können zwischen Selbsthosting oder professionellem Hosting in der Cloud wählen.

Matomo hieß früher Piwik. Details zur Namensänderung findest du unter Piwik is now Matomo - Announcement - Analytics Platform - Matomo.

Um Matomo-Analytics in deinem Discourse-Forum zu aktivieren, musst du nur die offizielle Theme-Komponente installieren.

Gültig für Matomo API v1.5 und neuer

1. Folge der Anleitung zur Theme-Installation, um sie von der folgenden URL zu importieren:

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

   Und du wirst sehen

   

2. Gib die Host URL und die Website ID ein

   

3. Füge die Theme-Komponente “Matomo Analytics” zu deinen aktiven Theme(s) hinzu.

   

Das war’s!

Einstellungen

Name	Beschreibung
host url	Host-URL ohne http:// oder https://
website id
exclude groups	Komma-getrennte Liste von Gruppen, die vom Tracking ausgeschlossen werden sollen, z. B. Administratoren, Mitarbeiter
user id tracking	Ein identifizierendes Feld im aktuellen Benutzerobjekt, z. B. id, username oder external_id.
subdomain tracking	Besucher über die Hauptdomain und Subdomains hinweg verfolgen, davon ausgehend, dass Discourse auf einer Subdomain läuft.
do not track	Tracking-Anfragen werden nicht gesendet, wenn Besucher nicht verfolgt werden möchten.
disable cookies	Deaktiviert alle First-Party-Cookies. Bestehende Matomo-Cookies für diese Website werden beim nächsten Seitenaufruf gelöscht.

Credits

Danke an @mattab & @brahn @tagtomat und @simon

Von uns gehostet? Theme-Komponenten können in unseren Standard-, Business- und Enterprise-Plänen genutzt werden.

[chrisblech (Christoph Blechschmitt)]

Thanks for this howto, works fine for me.

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…
Does anyone see a way to include this piwik iframe in Discourse TOS ?
Thanks.

[xrav3nz]

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.

[some-user]

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.

[sam (Sam Saffron)]

Is this iframe thing still a concern?

[chrisblech (Christoph Blechschmitt)]

Hey @xrav3nz your component works great - thanks!

@sam

Is this iframe thing still a concern?

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

[Patrick_David (Pat David)]

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:

[darix]

We are on beta 6+git1 on our instance

[xrav3nz]

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?

[Patrick_David (Pat David)]

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.

[downey (Michael Downey)]

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

[surety (Ryan)]

Danke für die Komponente!

Ich bin verwirrt, warum der Tracking-Code eine benutzerdefinierte Variable namens ‘Anonymous’ sendet. Ist das nicht spezifisch für deine Matomo-Konfiguration? Es scheint nicht so, als ob dies für alle vorhanden sein sollte.

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

Ich habe ein paar Zeilen hinzugefügt, damit Besucher zwischen Discourse auf einer Subdomain und einer Hauptseite verfolgt werden können. Ich sende gerne einen Pull-Request, wenn du möchtest.

[goaround]

Sie müssen Ihre Matomo-URL in der Content-Security-Policy-Header-Überschrift in die Whitelist aufnehmen. Suchen Sie nach der Admin-Einstellung content_security_policy_script_src und fügen Sie dort Ihre Domain (mit https://) hinzu.

[danb35 (Dan)]

Ich habe Probleme, das bei meiner Installation zum Laufen zu bringen. Ich habe die Komponente installiert und in mein Theme eingebunden, aber Matomo meldet, dass es keine Daten für die Seite gibt. Ich denke, meine Einstellungen sind korrekt:

Aber ich sehe diesen Fehler in der Browserkonsole:

…und wenn ich mir die Seite in Matomo ansehe, erscheint Folgendes:

Was habe ich übersehen?

Edit: Weitere Untersuchungen zeigen, dass der Fehler in der JavaScript-Konsole nur in Firefox auftritt, nicht jedoch in Chrome (mit den jeweils neuesten Versionen auf einem Mac). Außerdem sehe ich jetzt einige Ergebnisse in Matomo, wobei Firefox auffällig fehlt – alle Besucher außer einem nutzen Chrome; der einzige Ausnahmefall nutzt Safari.

[danb35 (Dan)]

Habt ihr dazu eine Idee? Dieser Beitrag:

Tracking not working in Firefox

legt nahe, dass es an den „Nicht-Verfolgen“-Einstellungen von Firefox liegen könnte. Selbst wenn ich sie für meine Website deaktiviere, erhalte ich denselben Fehler in der Webkonsole von Firefox. Außerdem scheint Firefox dies ohnehin nicht als Tracker zu betrachten:

[goaround]

Versuchen Sie, das letzte / von “https://www.familybrown.org/analytics/” zu entfernen → “https://www.familybrown.org/analytics”

[danb35 (Dan)]

Danke. Leider bekomme ich immer noch denselben Fehler:

[goaround]

Könntest du mir die URL deines Forums geben?

[danb35 (Dan)]

SpareOom

[eextra (Sylwia)]

Müssen diese beiden Felder ausgefüllt werden? Ich verstehe sie nicht wirklich.