Matomo Analytics: Einrichtung und Hilfe

Folgen Sie den Schritten im Schnellstart.

Öffnen Sie "Configure" im Modulmanager. Sie benötigen eine bestehende selbst gehostete Matomo-Installation oder Matomo Cloud-Website. Konfigurieren Sie die E-Commerce-Berichte der Website in Matomo. Das Modul installiert oder hostet Matomo nicht.

Verwenden Sie eine Basis-URL wie https://analytics.example.com/ oder https://example.com/matomo/. Die Normalisierung ergänzt einen abschließenden Schrägstrich und entfernt ein abschließendes matomo.php oder piwik.php. Zugangsdaten, Abfragezeichenfolgen und Fragmente werden abgelehnt. Der Browser lädt matomo.js; Browser- und Servertracking verwenden matomo.php unter dieser Basis.

Konfigurieren Sie "Matomo site currency" auch bei ausschließlich browserseitigen Käufen. Matomo verwendet die Währung seiner Website, weshalb diese Integration geldbezogene Ereignisse bei fehlender oder abweichender Bestellwährung zurückhält. Beträge werden nicht umgerechnet. Konfigurieren Sie für eine andere Berichtswährung eine separate geeignete Website, statt einen Betrag anders zu kennzeichnen.

Der Einwilligungsleser unterstützt Cookies Revolution, Cookie Banner sowie die gemeinsamen Cookiebot-, OneTrust- und TCF-Leser. Testen Sie Ihre Kategorie- und Dienstzuordnung. Die Einwilligung wird beim Senden geprüft; Widerrufe werden über einen privaten Endpunkt dauerhaft gespeichert. Eine fehlende CMP-Entscheidung gilt nicht als Erlaubnis. Eine erkannte unterstützte CMP gilt auch bei ausgeschaltetem Einwilligungsschalter des Moduls.

Jeder Standardschalter steht standardmäßig auf Ja. Deaktivieren Sie nicht benötigte Ereignisse.

Der aktuelle Warenkorbereignispfad zeichnet ein Ereignis auf. Er sendet keine E-Commerce-Warenkorbaktualisierungssumme allein deshalb, weil auf eine Hinzufügen-Schaltfläche geklickt wurde. Suchbegriffe, die E-Mail-Adressen oder langen Zahlenfolgen ähneln, werden gefiltert.

"Track phone-link clicks", "Track actual chat starts", "Track confirmed contact forms" und "Track product engagement" stehen standardmäßig auf Nein. Formulartracking benötigt einen serverbestätigten Beleg. Chattracking benötigt eine unterstützte Meldung über einen tatsächlichen Start. Der Interaktionstracker verwendet die gemeinsamen Standardwerte von 3 Galerieinteraktionen, 1 Variantenwechsel, 1 Detailinteraktion oder 45 Sekunden, einmal pro Produkt/Sitzung, wenn Speicherung erlaubt ist. Dieses Formular enthält keine Schwellenwertfelder für diese Werte.

Benutzerdefinierte Ereignisse erfassen steht standardmäßig auf Nein. Benutzerdefinierte Event-Regeln ist anfangs leer. Fügen Sie vor der Aktivierung Regeln hinzu. Namen erlauben 1 bis 64 Buchstaben, Ziffern, Unterstriche oder Bindestriche. Sie können bis zu 25 unterschiedliche Namen konfigurieren.

[
  {"event":"QuoteRequest","trigger":"click","selector":".request-quote","label":"Quote request"},
  {"event":"SalePageView","trigger":"url","url_contains":["/promotions","/sale"],"label":"Sale page"},
  {"event":"ContactPageView","trigger":"controller","controllers":["contact"],"modules":["contactform"],"label":"Contact page"},
  {"event":"ConfiguratorUsed","trigger":"event","dom_event":"mprmtmo:custom","label":"Configurator used"}
]

document.dispatchEvent(new CustomEvent('mprmtmo:custom'));

Verwenden Sie selector für Klickregeln, URL-Fragmente für URL-Regeln und controllers für Controller-Regeln. modules kann eine Controller-Regel ergänzen. Eine DOM-Ereignisregel ohne Namen verwendet mprmtmo:custom. once ist standardmäßig false für Klicks und true für URL-, Controller- und DOM-Ereignisregeln.

Der aktive Builder verwendet für benutzerdefinierte Regeln die Matomo-Kategorie Custom, das konfigurierte Ereignis als Aktion und die konfigurierte Beschriftung als Namen. Beliebige params und DOM-Ereignisdetails werden nicht zu Matomo-Eigenschaften. Verwenden Sie diese konfigurierten Regeln statt des alten Helfers window.mprmtmoTrackEvent.

Das Modul speichert Einwilligung und Mitarbeiterstatus des Käufers und stellt berechtigte Bestellungen in die Serverwarteschlange. Der Worker prüft Aktivierungsstatus, Zielinhaberschaft, Ausgangsrichtlinie, Käufer-Einwilligung, Mitarbeiterstatus und Websitewährung erneut. Widerruft der Käufer seine Einwilligung später, wird der wartende Kauf nicht gesendet.

Jede Bestellung wird über einen Kanal an ein Matomo-Ziel gesendet. Übernimmt der Server den Versand eines Kaufs, sendet der Browser ihn nicht. Übernimmt der Browser den Versand zuerst, wird der Kauf nicht in die Serverwarteschlange aufgenommen.

Die an Matomo gesendete Kauf-ID ist die numerische PrestaShop-Bestell-ID, nicht die Bestellreferenz. Die Nutzlast enthält Produkte, Umsatz und Zwischensumme einschließlich Steuern sowie Steuer-, Versand- und Rabattbeträge. Sie wird nur gesendet, wenn die Bestellwährung mit "Matomo site currency" übereinstimmt.

Stellen Sie sicher, dass Ihr gemeinsamer MPR-Cron-Runner Folgendes ausführt:

task: send_matomo_tracking_api
callable: mprmatomo::cronProcessMatomoTrackingAPIQueue
schedule: every:300
context: any
timeout: 30

Der Anbieter in der gemeinsamen Konversionswarteschlange ist matomo_tracking_http_api. Der Worker läuft im Kontext jedes aktivierten Shops. Das Bereitschaftspanel zeigt Anzahlen für ausstehend, sendend, gesendet und fehlgeschlagen sowie zurückgehaltene, endgültige, unterdrückte und unklare Zustände. Ein unklarer Netzwerkstatus kann eine Prüfung statt blinden erneuten Sendens erfordern.

Prüfen Sie Matomo-Tracking-Bereitschaft auf Site ID, normalisierte URL, Tracking, Einwilligung, benutzerdefinierte Regeln, API-Warteschlange und Worker-Registrierung. Testen Sie in einem Kundenbrowser mit der betreffenden Analyse-/Dienstberechtigung.

Bestätigen Sie die Anfrage für matomo.js und die Tracker-Aufrufe. Testen Sie gemäß den aktivierten Schaltern Seiten-, Produkt- und Kategorieansichten, erfolgreiche Warenkorbänderung, Wunschliste, Bestellvorgang, Suche und Registrierung. Öffentliches HTML enthält statische Konfiguration; der private Endpunkt liefert Besucherrichtlinie und privaten Bestell-/Registrierungskontext.

Geben Sie eine Bestellung in Ihrer konfigurierten Matomo-Währung auf. Prüfen Sie deren numerische Bestell-ID und Beträge. Ist der Server-Fallback aktiviert, prüfen Sie Warteschlangenaufnahme und Worker-Ergebnis und bestätigen Sie, dass der Browserkanal keine Kopie erzeugt hat. Prüfen Sie Ablehnung und Widerruf separat.

Wenn nichts erfasst wird, prüfen Sie Aktivierungsschalter, Site ID, URL, Inhaberschaft, lokale Abhängigkeiten, Einwilligung und Mitarbeiterrichtlinie. Entfernen Sie einen anderen Matomo-Tracker, der sich an ein anderes Ziel binden könnte.

Fehlen Käufe, prüfen Sie zuerst "Matomo site currency". Prüfen Sie danach Käufe erfassen, Käufer-/Warenkorb-/Sitzungsinhaberschaft, ursprüngliche Einwilligung und Mitarbeiterstatus des Käufers, Kanalreservierung und Worker-Status. Ein Kauf mit unbekanntem Einwilligungsstatus wird zurückgehalten.

Wenn eine benutzerdefinierte Schaltfläche nicht erfasst wird, aktualisieren Sie ihren Selektor und prüfen Sie ihre Regel. Ein erfolgreiches Standard-Warenkorbereignis benötigt das gemeinsame Handelssignal; ein Klick allein reicht nicht aus. Der alte Helfer und die Selektorlisten früherer Dokumentation definieren nicht den aktuellen Standardereignisdetektor.

Setzen Sie Matomo Analytics aktivieren auf Nein und speichern Sie, um diese Integration anzuhalten. Deinstallieren Sie über den Modulmanager, um Menü, Cron-Registrierung und Modulkonfiguration zu entfernen. Die gemeinsame Warteschlangentabelle bleibt bestehen, wenn ein anderes Modul das Konversionspaket verwendet; andernfalls löscht dessen Deinstallationshelfer die Tabelle. Die gemeinsamen Einwilligungs- und Kanaltabellen bleiben bei der Deinstallation erhalten; löschen Sie sie nicht manuell. Verwalten Sie Ihre Matomo-Website und historischen Daten in Matomo.

Verwenden Sie die obigen Einstellungsnamen, wenn ein Referenz-Screenshot von Ihrer installierten Version abweicht.