Matomo Analytics: Fehlerbehebung und FAQ

Matomo Analytics für Sylius - typische Probleme mit Symptom, Prüfung und Lösung, Meldungen des Setup-Befehls, bekannte Einschränkungen und häufige Fragen zu Datenschutz, Channels und Kompatibilität

English Version

Zurück zur Übersicht

Matomo Analytics: Fehlerbehebung und FAQ

Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.

Typische Probleme

Im Storefront erscheint kein Tracking-Skript

Symptom: Der Quelltext der Seite enthält kein _paq.

Prüfen:

Gibt es unter MMKreativ Plugins > Matomo Analytics einen Eintrag für genau diesen Channel?
Ist Matomo-Tracking für diesen Channel aktivieren an?
Beginnt die Matomo-URL mit https:// und enthält sie keines der Zeichen <, >, ", ' oder \?
Ist die Site-ID größer als 0?
Ist die Migration gelaufen? Fehlt die Tabelle, schreibt das Plugin eine Warnung in den Log-Kanal mmd_matomo und gibt nichts aus, statt den Shop abstürzen zu lassen.

Lösung: Fehlende Angaben ergänzen oder bin/console mmd:matomo-integration:setup ausführen. Ein unvollständiger Eintrag wird überall wie ein ausgeschalteter behandelt.

Die Shop API antwortet mit 404

Symptom: GET /api/v2/shop/matomo-settings liefert 404.

Prüfen: Dieselben Punkte wie oben. Die API und das Storefront nutzen dieselbe Gültigkeitsprüfung. Prüfe außerdem, ob die Anfrage auf den Channel aufgelöst wird, den du erwartest.

Lösung: Eintrag für den Channel vervollständigen. Siehe Konfiguration.

Das Skript ist da, aber Matomo erhält keine Daten

Symptom: Das Skript steht im Quelltext, in Matomo erscheinen keine Besuche.

Prüfen:

Ist Do-Not-Track im Browser aktiv und Do-Not-Track-Einstellung des Browsers respektieren an? Dann wird der Besuch bewusst nicht erfasst.
Ist Klaro-Gating an, und hat der Besucher dem Dienst zugestimmt? Ohne Zustimmung sendet das Plugin nichts.
Stimmt die Site-ID mit der in Matomo überein, und ist die Matomo-URL aus dem Browser erreichbar?
Blockiert ein Werbeblocker oder eine Content-Security-Policy den Aufruf von matomo.js und matomo.php?

Lösung: Teste in einem Browserfenster ohne Do-Not-Track und mit erteilter Zustimmung, und prüfe im Netzwerk-Tab, ob matomo.php aufgerufen wird.

Klaro-Option ist ausgegraut

Symptom: Tracking-Skript über Klaro-Einwilligung freischalten lässt sich nicht anklicken.

Prüfen: Ist mmd/sylius-klaro-consent-plugin installiert und in config/bundles.php registriert?

Lösung: Klaro-Plugin installieren und das Bundle registrieren. Erst dann ist die Option wählbar.

Klaro-Gating an, aber es wird nie getrackt

Symptom: Auch nach Zustimmung kommen keine Daten.

Prüfen:

Erscheint der Dienst im Klaro-Dialog? Der Klaro-Dienstname muss mit dem technischen Namen eines Dienstes im Klaro-Katalog übereinstimmen.
Steht in der Browser-Konsole die Warnung [MmdMatomo] Klaro unavailable - consent bridge inactive, nothing will be tracked. oder [MmdMatomo] Klaro consent manager unavailable - consent bridge inactive.? Dann ist window.klaro nicht geladen oder sein Manager nicht abrufbar.

Lösung: Dienstname angleichen oder Eintrag erneut speichern, damit der Dienst angelegt wird. Existiert ein Dienst dieses Namens bereits, bleibt er unverändert.

Klaro-Gating an, Klaro-Plugin später entfernt

Symptom: Ein Eintrag hat Klaro-Gating an, das Klaro-Plugin wurde aber deinstalliert. Es wird nichts mehr getrackt.

Prüfen: Im Formular ist die Klaro-Option jetzt ausgegraut, ein gespeicherter Wert bleibt aber bestehen und das Skript wird weiter blockiert ausgegeben.

Lösung: Klaro-Plugin wieder installieren, oder das Gating abschalten, indem du den Eintrag im Admin bearbeitest.

Setup-Befehl bricht ab

Der Befehl gibt seine Meldungen auf Englisch aus:

Meldung (sinngemäß)	Ursache	Lösung
`The migrations of this plugin are not registered with Doctrine. Check that the bundle is enabled and that sylius_core.prepend_doctrine_migrations is not set to false.`	Bundle nicht aktiv, oder `sylius_core.prepend_doctrine_migrations` ist auf `false` gesetzt	Bundle in `config/bundles.php` prüfen, die Einstellung zurücknehmen
`Migrations this plugin builds on are still open. Run "bin/console doctrine:migrations:migrate" first, then run this command again.`	Sylius-Migrationen fehlen	`bin/console doctrine:migrations:migrate`, danach den Befehl erneut starten
`mmd/sylius-matomo-integration-plugin migrations are written for MySQL 8 / MariaDB only.`	Andere Datenbank	Plugin nur mit MySQL 8 oder MariaDB einsetzen

Bei Erfolg meldet der Befehl Executed N migration(s)., ohne offene Migration Migrations are already up to date.

Bekannte Einschränkungen

Zum Warenkorb hinzufügen und Mengenänderungen werden nicht getrackt, nur Produktaufrufe und abgeschlossene Bestellungen.
Produktaufrufe enthalten keinen Preis.
Nur MySQL 8 und MariaDB werden unterstützt.
Klaro-Gating funktioniert nur mit dem Klaro-Plugin mmd/sylius-klaro-consent-plugin.
Die Admin-Liste hat keine Filter und keine Detailansicht.
Die Shop API ist nur lesbar.
Übersetzungen liegen auf Deutsch und Englisch vor.

FAQ

Allgemein

Brauche ich eine Einwilligung? Das hängt von deiner Matomo-Konfiguration und deinem Rechtsraum ab. Das Plugin liefert die Werkzeuge (cookie-los, Do-Not-Track, Klaro-Gating), die rechtliche Bewertung bleibt bei dir.

Ändert die Installation sofort etwas im Shop? Nein. Ein neuer Eintrag ist ausgeschaltet, bis du ihn aktivierst und URL und Site-ID einträgst.

Konfiguration

Kann ich mehrere Channels mit derselben Matomo-Site tracken? Ja, trage in beiden Einträgen dieselbe URL und Site-ID ein.

Kann ich einen Eintrag einem anderen Channel zuweisen? Nein, die Channel-Auswahl ist nach dem Anlegen gesperrt. Lege den Eintrag neu an.

Kompatibilität

Läuft das Plugin auf PostgreSQL? Nein, die Migration bricht dort ab.

Läuft das Plugin mit Sylius 2.0 oder 2.1? Nein, erforderlich ist Sylius ab 2.2.