Markus Michalski FAQ

Matomo Analytics: Konfiguration

Einstellungen von Matomo Analytics für OXID eShop 7: Matomo-URL und Site-ID, Datenschutz, Klaro, E-Commerce-Tracking, Heartbeat und Link-Tracking, mit Standardwerten und Praxisbeispielen.

English Version

Zurück zur Übersicht

Matomo Analytics: Konfiguration

Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net

Die Einstellungen findest du im Admin unter Erweiterungen → Module → Matomo Analytics → Einstell.. Sie gelten pro Shop (Subshop). Das Modul ist nach der Installation ausgeschaltet.

Grundeinstellungen

Einstellung Standard Beschreibung
Tracking aktivieren Aus Hauptschalter. Ohne diesen Schalter wird nichts ausgeliefert.
Matomo-URL leer Vollständige HTTPS-URL deiner Matomo-Installation, zum Beispiel https://analytics.example.com. Ein abschließender Schrägstrich wird entfernt.
Site-ID 1 Die Website-ID aus deiner Matomo-Installation. Muss größer als 0 sein.

Der Tracking-Code wird nur ausgeliefert, wenn "Tracking aktivieren" an ist, die Matomo-URL mit https:// beginnt, eine gültige URL ist und keines der Zeichen <, >, ", ', \ enthält, und die Site-ID größer als 0 ist. Eine http://-URL ist ungültig.

Was diese Einstellungen im Detail bewirken, steht auf der Seite Datenschutz und Einwilligung.

Einstellung Standard Beschreibung
Cookieless Tracking An Gibt disableCookies aus: Matomo setzt keine Tracking-Cookies.
IP-Anonymisierung 2 Bytes Ohne Wirkung. Wird eingelesen, aber nicht in den Tracking-Code übernommen.
Do-Not-Track respektieren An Gibt setDoNotTrack aus und liefert ohne Klaro-Integration bei gesetztem DNT: 1-Header keinen Code aus.
Consent erforderlich Aus Gibt requireConsent aus; prüft ohne Klaro und ohne Cookieless Tracking ein Consent-Cookie.
Klaro Integration aktivieren Aus Bindet das Tracking-Script für Klaro als text/plain ein.
Klaro Service-Name matomo Name des Klaro-Services. Ist das Feld leer, gilt matomo.

Die Auswahl bei "IP-Anonymisierung" (keine, 1, 2 oder 3 Bytes) verändert nichts am Tracking-Code. Aktiviere die IP-Anonymisierung stattdessen in deiner Matomo-Installation.

E-Commerce Tracking

Einstellung Standard Beschreibung
E-Commerce Tracking aktivieren An Übergeordneter Schalter. Ist er aus, entfallen Produktansichten, Warenkorb und Bestellungen.
Produktansichten tracken An Produktansicht mit Artikelnummer, Titel, Kategoriepfad und Bruttopreis.
Warenkorb tracken An Warenkorb-Update mit allen Positionen und dem Bruttogesamtwert.
Bestellungen tracken An Abgeschlossene Bestellungen auf der Bestätigungsseite.

Was genau getrackt wird

Produktansicht: Das Modul gibt die Produktansicht aus, wenn die aktuelle Seite ein Produkt liefert (typischerweise die Produktdetailseite). Auf dieser Seite wird nur die Produktansicht ausgegeben, kein Warenkorb.

Warenkorb: Der Warenkorb-Code wird auf jeder Seite ausgegeben, auf der ein nicht leerer Warenkorb vorliegt und keine Produktansicht ausgegeben wird. Das ist keine ereignisbasierte Erfassung von "Artikel hinzugefügt". Jeder Seitenaufruf mit gefülltem Warenkorb sendet ein Warenkorb-Update (addEcommerceItem je Position, dann trackEcommerceCartUpdate).

Bestellung: Wird eine Bestellung gespeichert und hat sie eine Bestellnummer, legt das Modul die Bestelldaten in der Session ab. Die Bestätigungsseite gibt sie einmal aus. Eine Bestellnummer wird pro Session nur einmal vorgemerkt. Die Werte:

Wert Quelle
Bestellnummer oxordernr
Umsatz Brutto-Warensumme (oxtotalbrutsum) plus Versandkosten (oxdelcost)
Zwischensumme Brutto-Warensumme
Steuer Brutto-Warensumme minus Netto-Warensumme (oxtotalnetsum)
Versandkosten oxdelcost
Positionen Artikelnummer (oxartnum), Titel (oxtitle), Brutto-Einzelpreis (oxbprice), Menge (oxamount)

Erweiterte Einstellungen

Einstellung Standard Beschreibung
Heartbeat-Timer aktivieren Aus Gibt enableHeartBeatTimer mit dem eingestellten Intervall aus.
Heartbeat-Intervall (Sekunden) 15 Intervall in Sekunden. Ein leerer Wert oder 0 wird als 15 behandelt.
Ausgehende Links tracken An Siehe Hinweis unten.
Downloads tracken An Siehe Hinweis unten.

"Ausgehende Links tracken" und "Downloads tracken" sind nicht unabhängig. Für beide gibt das Modul denselben Aufruf enableLinkTracking aus, sobald mindestens einer der beiden Schalter an ist. Nur wenn beide aus sind, entfällt er.

Klaro einrichten

  1. Aktiviere im Modul Klaro Integration aktivieren und trage bei Klaro Service-Name den Namen deines Klaro-Services ein (Standard matomo).
  2. Lege in deiner Klaro-Konfiguration einen Service mit genau diesem Namen an:
var klaroConfig = {
    services: [{
        name: 'matomo',
        title: 'Matomo Analytics',
        purposes: ['analytics'],
        cookies: [/^_pk_.*$/, /^mtm_.*$/]
    }]
};

Der Wert name muss mit dem Klaro Service-Namen des Moduls übereinstimmen, sonst gibt Klaro das Script nicht frei und der Consent-Handler meldet keine Einwilligung.

Mit Klaro läuft der Tracking-Code erst nach der Einwilligung. Die Cookie-Liste ist nur relevant, wenn du Cookieless Tracking ausschaltest. Das Modul selbst löscht keine Cookies.

Praxisbeispiele

1. Standardbetrieb ohne Cookies. Tracking aktivieren, Matomo-URL und Site-ID eintragen, alles andere auf den Standardwerten lassen. Das Modul gibt disableCookies und setDoNotTrack aus, es gibt keine Consent-Prüfung.

2. Besucher einwilligen lassen (Klaro). Cookieless Tracking ausschalten, Klaro Integration aktivieren, den Service in der Klaro-Konfiguration anlegen. Der Tracking-Code läuft erst nach der Einwilligung des Besuchers.

3. Eigene Cookie-Banner-Lösung. Cookieless Tracking ausschalten, "Consent erforderlich" einschalten. Das Modul liefert den Code nur aus, wenn eines der erkannten Consent-Cookies (matomo_consent, CookieConsent, CookieControl, cookie-agreed) einen positiven Wert hat. Matomo wartet wegen requireConsent auf setConsentGiven, das deine Lösung selbst aufrufen muss. Siehe Datenschutz und Einwilligung.

4. Nur Seitenaufrufe, kein E-Commerce. "E-Commerce Tracking aktivieren" ausschalten.

© 2026 Markus Michalski | Back to Homepage | Impressum | Datenschutz