PrestaShop-Modul

MetriXs bietet ein erstklassiges PrestaShop-Modul, das den Tracker auf jede Seite Ihres Shops setzt, Ihren Shop automatisch verifiziert und order_completed-Events serverseitig sendet — so landen Umsatz, durchschnittlicher Bestellwert, Conversion-Rate und Top-Produkte in Ihrem MetriXs-Dashboard, einschließlich Bestellungen über Redirect-Zahlmethoden wie iDEAL oder Carte Bancaire. Keine Theme-Bearbeitung, kein Code, kein Consent-Banner.

Diese Anleitung führt durch das komplette Setup.

Bevor Sie starten

Sie brauchen ein MetriXs-Konto. Das Modul selbst ist kostenlos und voll funktionsfähig; der kostenlose MetriXs-Plan reicht für den Einstieg.

1. Gehen Sie zu app.metrixs.eu und registrieren Sie sich
2. Bestätigen Sie Ihre E-Mail-Adresse über den Link, den Sie erhalten

Schritt 1: Shop in MetriXs anlegen

1. Melden Sie sich im MetriXs-Dashboard an
2. Legen Sie während des Onboardings (oder unter Einstellungen → Websites) die Domain Ihres Shops an, z. B. yourshop.com — ohne https:// und ohne www.
3. Überspringen Sie den vorgeschlagenen Snippet-Verifizierungsschritt — das Modul verifiziert Ihren Shop automatisch in Schritt 5
4. Starten Sie bei Bedarf eine Testphase oder wählen Sie den Gratisplan (Events erfordern einen aktiven Plan)

Schritt 2: Site-API-Key erstellen

Das Modul authentifiziert sich mit einem site-spezifischen API-Key. Er gewährt nur Zugriff auf diesen einen Shop (stats:read + event:write), nie auf Ihr Konto, und ist jederzeit widerrufbar.

1. Gehen Sie im Dashboard zu Einstellungen → Websites
2. Klappen Sie Ihren Shop auf und finden Sie den Bereich API-Keys
3. Klicken Sie auf Create API key und benennen Sie ihn, z. B. „PrestaShop“
4. Kopieren Sie den Key (mtx_live_...) sofort — er wird nur einmal angezeigt und kann später nicht mehr abgerufen werden

Schritt 3: Modul installieren

1. Laden Sie das neueste Modul-ZIP von der GitHub-Releases-Seite (mx-cookieless-analytics-X.Y.Z.zip)
2. Gehen Sie im Backoffice zu Module → Module-Manager
3. Klicken Sie auf Modul hochladen, wählen Sie das ZIP und warten Sie auf die Bestätigung

Alternativ entpacken Sie es in das modules/-Verzeichnis Ihrer PrestaShop-Installation (Ordnername muss mx_cookieless_analytics bleiben).

Schritt 4: Modul konfigurieren

Gehen Sie zu Module → Module-Manager, finden Sie MX Cookieless Analytics und klicken Sie auf Konfigurieren:

Feld	Eingabe
Enable tracking	Vorerst aus — nach der Verifizierung einschalten (Schritt 5)
Site API key	Der Key aus Schritt 2
MetriXs URL	Standard https://app.metrixs.eu lassen
Shop-Domain	Leer lassen für automatische Erkennung
Exclude logged-in customers	Standardmäßig an — eigene Besuche zählen nicht

Klicken Sie auf Speichern. Die Verifizierung startet automatisch mit demselben Speichervorgang.

Schritt 5: Verbinden und verifizieren

Das ersetzt die manuelle Verifizierung — nur einmal nötig.

1. Nach dem Speichern fragt das Modul die MetriXs-API nach einem Einmal-Challenge-Token und verifiziert Ihren Shop automatisch
2. Sie sehen die grüne Bestätigung „shop verified“
3. Im MetriXs-Dashboard zeigt Ihr Shop jetzt Verified
4. Schalten Sie Enable tracking ein und speichern Sie erneut

So funktioniert es: Das Modul fragt die MetriXs-API nach einem Einmal-Token, serviert es über Ihre eigene Domain und die API holt es zurück. Nur wer Ihre Domain kontrolliert, kann den Token servieren — das beweist das Eigentum

Schritt 6: Tracking prüfen

1. Öffnen Sie Ihren Shop in einem Inkognito-Fenster und surfen Sie ein paar Seiten an
2. Prüfen Sie im MetriXs-Dashboard die Realtime-Ansicht — Pageviews sollten binnen Sekunden erscheinen

Hinweis: Eingeloggte Kunden sind standardmäßig ausgeschlossen. Testen Sie im Inkognito-Modus oder passen Sie den Ausschluss in den Moduleinstellungen an.

Order-Tracking (inklusive)

Jede validierte Bestellung wird serverseitig gesendet, genau beim Erstellen — unabhängig vom Zahlungsfluss, dadurch werden Redirect-Zahlmethoden (iDEAL, Carte Bancaire, Banküberweisung) zuverlässig erfasst. Dankeseiten-Skripte, die bei Refresh doppelt feuern, braucht es nicht.

Jede Bestellung landet als order_completed-Event mit dem bezahlten Gesamtbetrag (inkl. Steuer), der Währung, den Positionen und dem Warenkorbregel-Rabattcode.

Sobald Sie eine Testbestellung aufgeben, zeigt das MetriXs-Dashboard:

• Umsatz, durchschnittlichen Bestellwert und Conversion-Rate
• Den Checkout-Trichter und Top-Produkte nach Umsatz
• Ein Rabattcode-Ranking, wenn Sie Warenkorbregeln mit Codes nutzen

Ein zusätzlicher Schritt nötig, um die Commerce-Panels zu sehen:

1. Gehen Sie im Dashboard zu Einstellungen → Websites
2. Klappen Sie Ihren Shop auf und schalten Sie den Commerce-Toggle ein

Der Umsatz wird automatisch mit täglichen EZB-Kursen in EUR umgerechnet und in Ihrer gewählten Anzeigewährung dargestellt.

Einstellungsreferenz

Einstellung	Standard	Bedeutung
Enable tracking	Aus	Hauptschalter — nichts lädt, bis der Shop verbunden ist und dies an ist
Site API key	—	Site-spezifischer Key aus dem Dashboard
MetriXs URL	https://app.metrixs.eu	Nur bei eigenen Endpoints ändern
Shop-Domain	Leer (auto)	Muss der Domain in MetriXs entsprechen
Exclude logged-in customers	An	Eingeloggte Kundenkonten nicht tracken

Fehlerbehebung

Verifizierung schlägt fehl

• Stellen Sie sicher, dass der Shop öffentlich über HTTPS erreichbar ist (kein Wartungsmodus, keine Firewall, die die MetriXs-Server blockt)
• Prüfen Sie Hosting-Sicherheitsmodule, die unbekannte Bots blocken — die MetriXs-API ruft die Challenge-URL von Ihrem Shop ab
• Speichern Sie die Einstellungsseite erneut: Das Modul wiederholt die Verifizierung (max. einmal alle 5 Minuten)

Keine Daten im Dashboard

• Die Einstellungsseite muss die „shop verified“-Bestätigung zeigen
• Enable tracking muss eingeschaltet sein
• Die Shop-Domain muss exakt der Domain in MetriXs entsprechen (ohne www., ohne https://)
• Sie sind als Kunde eingeloggt? Standardmäßig ausgeschlossen — Inkognito testen
• Full-Page-Cache im Einsatz? Leeren Sie ihn, damit der Tracker-Skript auf Ihren Seiten landet

Kein Umsatz im Dashboard

• Geben Sie eine Testbestellung auf und prüfen Sie die Realtime-Ansicht auf das order_completed-Event
• Schalten Sie den Commerce-Toggle der Website ein (Einstellungen → Websites) — ohne ihn sind die Umsatz-Panels ausgeblendet

API-Key verloren Keys sind nach der Erstellung nicht abrufbar. Widerrufen Sie den alten Key im Dashboard (Einstellungen → Websites → API-Keys), erstellen Sie einen neuen und tragen Sie ihn im Modul ein.

Deinstallation

Beim Deinstallieren des Moduls:

• Ihr Shop wird in MetriXs automatisch als getrennt markiert (Events werden nicht mehr akzeptiert)
• Ihre historischen Daten bleiben in Ihrem MetriXs-Konto
• Die Moduleinstellungen werden aus Ihrer Datenbank entfernt

Ohne Modul bevorzugt?

Sie können den Tracker jederzeit manuell mit dem Snippet aus den Plattform-Guides hinzufügen — das Modul automatisiert nur Installation, Verifizierung und Order-Tracking.