Matomo Analytics: Konfiguration
Matomo Analytics für Sylius - alle Einstellungen pro Channel mit Standardwerten, Admin-Oberfläche, Gültigkeitsregeln für Matomo-URL und Site-ID sowie Praxis-Beispiele
Matomo Analytics: Konfiguration
Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
Wo du einstellst
Alle Einstellungen liegen in der Datenbank und werden im Admin gepflegt, es gibt keine YAML-Konfiguration für das Bundle. Du findest sie unter Admin-Sidebar > MMKreativ Plugins > Matomo Analytics.
Die Einstellungen gelten pro Channel, nicht global: Jeder Channel hat höchstens einen Eintrag mit eigener Matomo-URL, eigener Site-ID und eigenen Schaltern. Ein Channel kann nur einmal konfiguriert werden, ein zweiter Eintrag für denselben Channel wird mit einer Fehlermeldung abgelehnt.
Admin-Oberfläche
Die Seite Matomo Analytics ist eine Liste mit diesen Spalten: Channel, Aktiviert und Site-ID. Die Liste ist nach Channel-Code sortiert und kennt keine Filter. Über die Schaltfläche zum Anlegen erstellst du einen Eintrag, pro Zeile kannst du bearbeiten und löschen. Eine Detailansicht gibt es nicht. Unter dem Seitentitel zeigt der Admin die installierte Plugin-Version an.
Nach dem Anlegen, Ändern und Löschen zeigt der Admin eine Bestätigung („Die Matomo-Channel-Einstellungen wurden erfolgreich erstellt/aktualisiert/gelöscht.“). Ein zweiter Eintrag für denselben Channel wird mit „Für diesen Channel bestehen bereits Matomo-Einstellungen.“ abgelehnt, ein ungültiger Klaro-Dienstname mit einem Hinweis auf die erlaubten Zeichen.
Beim Bearbeiten ist die Channel-Auswahl gesperrt: Ein Eintrag lässt sich nicht auf einen anderen Channel umhängen. Wurde der Channel in Sylius inzwischen gelöscht, zeigt der Eintrag weiterhin seinen ursprünglichen Channel-Code an.
Der Eintrag MMKreativ Plugins in der Sidebar ist eine gemeinsame Gruppe. Installierst du mehrere MMKreativ-Plugins, erscheinen alle unter derselben Gruppe.
Einstellungen
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Channel | Der Channel, für den der Eintrag gilt. Pflichtfeld, nach dem Anlegen gesperrt | |
| Matomo-Tracking für diesen Channel aktivieren | aus | Hauptschalter. Solange er aus ist, wird kein Tracking-Skript ausgegeben |
| Matomo-URL | leer | Basis-URL deiner Matomo-Installation, z. B. https://analytics.example.com. Muss HTTPS sein, siehe Wann ein Channel als konfiguriert gilt |
| Site-ID | 0 | Die Site-ID aus Matomo. Muss größer als 0 sein |
| Cookie-loses Tracking | an | Besucher werden ohne Matomo-Cookies erfasst |
| Do-Not-Track-Einstellung des Browsers respektieren | an | Besucher mit aktivem Do-Not-Track werden nicht erfasst |
| Tracking-Skript über Klaro-Einwilligung freischalten | aus | Das Skript wird erst nach Zustimmung im Klaro-Dialog freigeschaltet. Ausgegraut, solange das Klaro-Plugin fehlt |
| Klaro-Dienstname | matomo |
Technischer Name des Klaro-Dienstes. Erlaubt sind Kleinbuchstaben, Ziffern, - und _ |
| E-Commerce-Tracking aktivieren | an | Hauptschalter für die beiden E-Commerce-Schalter darunter |
| Produktaufrufe tracken | an | Erfasst Produktaufrufe, wirksam nur bei aktivem E-Commerce-Tracking |
| Abgeschlossene Bestellungen tracken | an | Erfasst Bestellungen auf der Dankeseite, wirksam nur bei aktivem E-Commerce-Tracking |
| Heartbeat-Timer aktivieren | an | Meldet in regelmäßigen Abständen, dass die Seite noch offen ist. Matomo kann so die Verweildauer genauer messen |
| Heartbeat-Intervall (Sekunden) | 15 | Abstand der Heartbeat-Meldungen, muss größer als 0 sein |
| Ausgehende Links und Downloads tracken | an | Aktiviert das Link-Tracking von Matomo |
Die Details zu Cookie-losem Tracking, Do-Not-Track und Klaro stehen unter Datenschutz und Einwilligung.
Wann ein Channel als konfiguriert gilt
Das Plugin speichert auch unvollständige Einträge, prüft aber vor jeder Ausgabe, ob der Channel tatsächlich tracken kann. Dafür müssen alle drei Bedingungen erfüllt sein:
- Der Hauptschalter ist an.
- Die Matomo-URL ist eine gültige URL, beginnt mit
https://und enthält keines der Zeichen<,>,",'oder\. - Die Site-ID ist größer als 0.
Trifft eine Bedingung nicht zu, wird der Eintrag überall wie ein ausgeschalteter behandelt: Im Storefront erscheint kein Tracking, und die Shop API antwortet mit 404. Abschließende Schrägstriche der Matomo-URL werden entfernt.
Die HTTPS-Pflicht ist technisch erzwungen, nicht nur empfohlen. Eine URL mit
http://gilt als nicht konfiguriert, damit Tracking-Daten nie unverschlüsselt übertragen werden.
E-Commerce-Schalter
Produktaufrufe und Bestellungen werden nur erfasst, wenn E-Commerce-Tracking aktivieren und der jeweilige Einzelschalter an sind. Schaltest du den Hauptschalter aus, ist beides aus, unabhängig von den Einzelschaltern.
Praxis-Beispiele
Beispiel 1: Shop mit einem Channel, Standardwerte
| Einstellung | Wert |
|---|---|
| Matomo-Tracking aktivieren | an |
| Matomo-URL | https://analytics.example.com |
| Site-ID | 3 |
Alle anderen Einstellungen bleiben auf ihren Standardwerten. Damit trackt der Channel cookie-los, respektiert Do-Not-Track und erfasst Seitenaufrufe, Produktaufrufe und Bestellungen.
Beispiel 2: Zwei Channels mit getrennten Site-IDs
Ein Shop mit den Channels DE und AT, die in Matomo getrennt ausgewertet werden:
| Channel | Matomo-URL | Site-ID |
|---|---|---|
DE |
https://analytics.example.com |
3 |
AT |
https://analytics.example.com |
4 |
Lege für jeden Channel einen eigenen Eintrag an. Ein dritter Channel ohne Eintrag trackt nichts.
Beispiel 3: Tracking erst nach Einwilligung
Du betreibst das Klaro-Plugin und willst nur nach Zustimmung tracken:
| Einstellung | Wert |
|---|---|
| Tracking-Skript über Klaro-Einwilligung freischalten | an |
| Klaro-Dienstname | matomo |
Beim Speichern legt das Plugin den passenden Dienst im Klaro-Katalog an, falls er noch nicht existiert. Danach kannst du ihn im Klaro-Admin anpassen, das Plugin überschreibt ihn nie. Mehr dazu unter Datenschutz und Einwilligung.
Beispiel 4: Nur Seitenaufrufe, ohne E-Commerce
Schalte E-Commerce-Tracking aktivieren aus. Das Storefront erfasst weiterhin Seitenaufrufe, gibt aber auf Produkt- und Dankeseite nichts aus.