Matomo im JTL-Shop einrichten: Mixx-Matomo Schritt für Schritt – mit oder ohne API-Token

Matomo ist die Webanalyse, bei der die Daten auf Ihrem eigenen Server bleiben. Das Plugin Mixx-Matomo verbindet Ihren JTL-Shop 5 damit: Seitenaufrufe, Suchbegriffe, Warenkorb, Bestellungen mit Umsatz und die Schritte im Bestellvorgang landen in Matomo, die Cookie-Einwilligung läuft über den Consent Manager des Shops.

Diese Anleitung zeigt die Einrichtung so, wie wir sie bei Kunden machen: mit dem Assistenten im Plugin, der alles in Matomo anlegt, und alternativ von Hand. Sie brauchen dafür keine Programmierkenntnisse, nur einen Matomo-Zugang mit Admin-Rechten und den Admin-Zugang Ihres Shops.

Was Sie vorher brauchen

• Eine laufende Matomo-Installation, zum Beispiel unter https://www.ihr-shop.de/matomo/. Matomo läuft auf demselben Server wie der Shop oder auf einem eigenen. Wenn Sie noch kein Matomo haben, richten wir es ein.
• Einen Matomo-Benutzer mit Admin-Rechten für die automatische Einrichtung. Für den Betrieb danach reicht ein Benutzer mit Schreibrecht auf die Shop-Website.
• Das Plugin Mixx-Matomo als Zip-Datei. Sie bekommen es von uns.

Ein Matomo kann beliebig viele Shops bedienen. Jeder Shop bekommt eine eigene „Website“ mit eigener Nummer, der Site-ID. Die Auswertungen bleiben getrennt.

Plugin installieren

1. Im Shop-Backend unter Plugins › Plugin-Manager die Registerkarte Upload öffnen und die Zip-Datei hochladen.
2. Unter Verfügbar das Plugin Mixx-Matomo installieren und anschließend aktivieren.
3. In der Plugin-Liste auf Mixx-Matomo klicken. Es öffnet sich die Übersicht des Plugins.

Die Übersicht zeigt oben den Zustand: solange nichts eingerichtet ist, steht dort „Tracking aus“. Darunter sehen Sie die Karte Einrichtung mit zwei Wegen. Welchen Sie nehmen, entscheiden Sie jetzt.

Weg A: Automatisch mit API-Token

Der Assistent legt in Matomo alles an, was das Plugin braucht, und trägt die Nummern selbst ein. Dafür braucht er einmalig ein Token, mit dem er sich bei Matomo anmelden darf.

Das Token in Matomo holen

1. In Matomo anmelden und oben rechts auf das Zahnrad klicken (Verwaltung).
2. Links im Menü unter Persönlich auf Sicherheit klicken.
3. Nach unten scrollen bis zum Abschnitt API Authentifizierungs-Token und auf Neuen Token generieren klicken.
4. Matomo fragt nach Ihrem Passwort. Danach vergeben Sie eine Bezeichnung, zum Beispiel „JTL-Shop Plugin“.
5. Das Token wird nur einmal angezeigt. Kopieren Sie die Zeichenkette sofort.

Das Token ist ein Schlüssel zu Ihrem Matomo. Geben Sie es nicht per E-Mail weiter und tragen Sie es nur im Plugin ein. Sie können es in Matomo an derselben Stelle jederzeit löschen und ein neues erstellen.

Den Assistenten starten

1. Im Plugin auf der Übersicht in der Karte Einrichtung, linke Spalte Automatisch mit API-Token.
2. Matomo-URL eintragen: die Adresse, unter der Sie Matomo im Browser öffnen, zum Beispiel https://www.ihr-shop.de/matomo/. Ob mit oder ohne Schrägstrich am Ende ist egal, das Plugin korrigiert das.
3. API-Token einfügen.
4. Optional die Option IP-Anonymisierung anhaken. Dazu unten mehr.
5. Auf Matomo einrichten klicken.

Das Plugin meldet jeden Schritt zurück:

• Website: Gibt es in Matomo schon eine Website mit der Adresse Ihres Shops, wird sie verwendet. Sonst legt das Plugin sie an, mit Währung Euro, Zeitzone Berlin und eingeschaltetem E-Commerce.
• Goals: Sieben Ziele, eines je Schritt im Bestellvorgang: Warenkorb, Versand und Zahlungsart, Zusammenfassung, Bestellung abgeschlossen, registrierte Bestellung, Gastbestellung, Neuregistrierung.
• Custom Dimensions: Drei Merkmale je Besuch: Kundengruppe, Sprache und ob der Kunde eingeloggt war.
• Einstellungen gespeichert: Site-ID und alle Nummern stehen jetzt im Plugin.

Klicken Sie danach auf Seite neu laden. Die Übersicht zeigt jetzt „Tracking läuft“, die Site-ID und die Zähler für Goals und Dimensions.

Der Assistent arbeitet nur an der Website Ihres Shops. Andere Websites in derselben Matomo-Installation werden weder gelesen noch verändert. Ein zweiter Klick legt nichts doppelt an, vorhandene Ziele werden am Namen erkannt.

Weg B: Von Hand, ohne Token

Wenn Sie dem Plugin kein Token geben möchten, legen Sie alles selbst in Matomo an und tragen die Nummern ein.

1. Website anlegen: In Matomo unter Verwaltung › Websites › Verwalten auf Neue Website hinzufügen. Name und Adresse des Shops eintragen, Währung Euro, Zeitzone Berlin. Nach dem Speichern steht die Site-ID in der Liste.
2. E-Commerce einschalten: Die Website bearbeiten, unter E-Commerce die Option „E-Commerce aktiviert“ wählen. Ohne diese Einstellung ignoriert Matomo Warenkorb und Bestellungen.
3. Ziele anlegen: Unter Verwaltung › Websites › Ziele (oder im Bericht „Ziele“ › Ziele verwalten) sieben Ziele erstellen. Wichtig: bei jedem Ziel „Ziel wird manuell ausgelöst“ wählen, das Plugin löst sie selbst aus. Die Namen sind frei, merken Sie sich die Nummer, die Matomo jedem Ziel gibt.
4. Custom Dimensions anlegen (optional): Unter Verwaltung › Websites › Custom Dimensions drei Dimensionen mit Bereich „Besuch“: Kundengruppe, Sprache, Login-Status.
5. Im Plugin eintragen: Registerkarte Allgemein: Matomo-URL und Site-ID. Registerkarte Goals: die sieben Nummern, 0 schaltet ein Ziel aus. Registerkarte Custom Dimensions: die drei Nummern, 0 schaltet eine Dimension aus. Speichern.

Die Nummern der Ziele beginnen in jeder Website bei 1. Legen Sie die Ziele in der Reihenfolge des Plugins an, dann stimmen die Vorgaben 1 bis 7 im Plugin bereits.

Cookie-Einwilligung wählen

Auf der Registerkarte Allgemein entscheidet die Einstellung Cookie-Einwilligung, wie das Plugin mit dem Cookie-Banner Ihres Shops zusammenspielt. Das Plugin trägt sich selbst als „Matomo“ im Consent Manager des Shops ein.

Damit der cookielose Betrieb ohne Einwilligung vertretbar ist, muss Matomo die IP-Adressen anonymisieren: Verwaltung › Privatsphäre › Anonymisierung der Daten, mindestens 2 Bytes maskieren. Der Assistent kann das für Sie setzen (Option IP-Anonymisierung), das gilt dann für die gesamte Matomo-Installation. Ergänzen Sie außerdem Ihre Datenschutzerklärung um Matomo. Ob das für Ihren Shop ausreicht, klären Sie mit Ihrem Rechtstexte-Anbieter.

Prüfen, ob alles ankommt

1. Im Plugin die Registerkarte Diagnose öffnen und Verbindung testen klicken. Grün bei Tracker-Skript und Endpunkt bedeutet: der Shop erreicht Matomo. Mit Token prüft die Diagnose zusätzlich, ob E-Commerce eingeschaltet ist und ob alle Ziele existieren.
2. In Matomo unter Besucher › Besucher-Log den Shop in einem zweiten Browserfenster aufrufen. Der Seitenaufruf erscheint nach wenigen Sekunden.
3. Einen Artikel in den Warenkorb legen und eine Testbestellung abschließen. Unter E-Commerce › Protokoll stehen Warenkorb und Bestellung mit Positionen und Betrag, unter Ziele die erreichten Schritte.

Ein Adblocker im eigenen Browser blockiert Matomo meist komplett. Testen Sie in einem Fenster ohne Adblocker oder im privaten Modus. Für Besucher mit Adblocker kann das Plugin Bestellungen serverseitig nachtragen, siehe unten.

Weitere Einstellungen, die sich lohnen

• Shop-Admins nicht tracken (Allgemein, Vorgabe an): Ihre eigenen Klicks im Backend und beim Ansehen des Shops zählen nicht mit.
• Bestellung serverseitig nachtragen (Server und API): Blockiert ein Adblocker das Matomo-Skript, meldet der Shop die Bestellung selbst. Mit Token wird dabei die Adresse des Besuchers übergeben, sonst die des Servers. Die Cookie-Einwilligung wird beachtet.
• Tracker-Datei und Endpunkt (Allgemein): Adblocker sperren die Dateinamen matomo.js und matomo.php. Mit eigenen Pfaden oder einem Proxy auf der Shop-Domain kommen mehr Daten an. Das richten wir auf Wunsch ein.
• Beträge brutto oder netto (Allgemein): Legt fest, wie Preise und Umsätze an Matomo gehen. Für den Vergleich mit der Wawi ist netto oft praktischer.
• 404-Seiten tracken (Tracking): Zeigt unter Verhalten › Seitentitel, welche Adressen ins Leere laufen, inklusive der Seite, von der der Besucher kam.

Typische Stolpersteine

• „Tracking aus“ obwohl alles eingetragen ist: Die Matomo-URL ist keine gültige Adresse oder die Site-ID ist keine Zahl. Die Diagnose markiert den Wert als „ungültig“.
• Ziele erscheinen nicht in Matomo: Das Ziel ist nicht „manuell ausgelöst“, sondern an eine URL gebunden. In Matomo das Ziel bearbeiten.
• Umsatz in Matomo ist doppelt so hoch wie im Shop: Die Ziele wurden mit Umsatz angelegt. Das Plugin meldet Umsatz nur über die E-Commerce-Bestellung, Ziele bleiben ohne Betrag.
• Nach Matomo-Update kommt nichts mehr an: In Matomo prüfen, ob die Website noch E-Commerce eingeschaltet hat und das Token noch gültig ist. Token lassen sich mit Ablaufdatum anlegen.

Fazit

Mit Token dauert die Einrichtung zwei Minuten: Token holen, Matomo-URL und Token in den Assistenten, einrichten, neu laden. Ohne Token sind es die gleichen Schritte von Hand in Matomo. In beiden Fällen gilt: Cookie-Einwilligung bewusst wählen, IP-Anonymisierung einschalten und mit einer Testbestellung prüfen, dass Warenkorb und Umsatz ankommen. Wenn Sie unsicher sind, welche Einwilligung zu Ihrem Shop passt, oder Matomo noch nicht installiert ist, übernehmen wir das.

Häufige Fragen