Shopware-6-Plugin

MetriXs hat ein erstes Shopware-6-Plugin, das den Tracker auf jeder Seite deines Shops einbindet und deinen Shop automatisch verifiziert. Es bleibt strikt opt-in: Nichts wird geladen, bis du es verbindest. Kein Theme-Editing, keine Twig-Snippets, kein Consent-Banner.

Diese Anleitung fuehrt dich Schritt fuer Schritt durch das komplette Setup.

Hinweis

Das Plugin unterstuetzt selbst gehostetes Shopware 6 (6.5 und 6.6). Shopware-Cloud-Shops nutzen ein anderes Erweiterungssystem (“Apps”) und werden noch nicht unterstuetzt.

Bevor du startest

Du brauchst ein MetriXs-Konto. Das Plugin selbst ist kostenlos und voll funktionsfaehig; ein kostenloser MetriXs-Tarif reicht fuer den Anfang.

1. Gehe zu app.metrixs.eu und registriere dich
2. Bestaetige deine E-Mail-Adresse ueber den Link, den du erhaeltst

Schritt 1: Shop in MetriXs hinzufuegen

1. Melde dich im MetriXs-Dashboard an
2. Fuege waehrend des Onboardings (oder unter Einstellungen → Sites) die Domain deines Shops hinzu, z. B. deinshop.de — ohne https:// und ohne www.
3. Ueberspringe den Snippet-Verifizierungsschritt des Dashboards — das Plugin verifiziert deinen Shop automatisch in Schritt 4
4. Starte bei Bedarf einen Test oder waehle den kostenlosen Tarif (Events erfordern einen aktiven Tarif)

Schritt 2: Site-API-Key erstellen

Das Plugin authentifiziert sich mit einem site-spezifischen API-Key. Er gewaehrt nur Zugriff auf diesen einen Shop (stats:read + event:write), niemals auf dein Konto, und kann jederzeit widerrufen werden.

1. Gehe im Dashboard zu Einstellungen → Sites
2. Klappe deinen Shop auf und finde den Bereich API-Keys
3. Klicke auf API-Key erstellen und vergebe einen Namen, z. B. “Shopware”
4. Kopiere den Key (mtx_live_...) sofort — er wird nur einmal angezeigt und kann spaeter nicht mehr abgerufen werden

Schritt 3: Plugin installieren

1. Lade das neueste Plugin-ZIP von der GitHub-Releases-Seite herunter (metrixs-mxcoan-X.Y.Z.zip)
2. Gehe in der Shopware-Administration zu Erweiterungen → Meine Erweiterungen
3. Klicke auf Erweiterung hochladen und waehle die ZIP-Datei aus

Das Plugin ist auf Shopware 6.5 und 6.6 (self-hosted) getestet.

Schritt 4: Plugin konfigurieren

Gehe in der Shopware-Administration zu Erweiterungen → Meine Erweiterungen → MX Cookieless Analytics → Konfigurieren:

Oder klicken Sie auf Connect with MetriXs: Das öffnet das MetriXs-Dashboard, wo Sie Ihr Konto erstellen (oder öffnen), und der Shop wird hinzugefügt, verifiziert und das Tracking automatisch aktiviert. Kein API-Key-Kopieren.

Feld	Eingabe
Enable tracking	Laesst du erstmal aus — nach der Verifizierung einschalten
Site API key	Der Key aus Schritt 2
MetriXs API URL	Standard https://app.metrixs.eu beibehalten

Klicke auf Speichern. Das Plugin verifiziert deinen Shop automatisch mit demselben Speichern. Die Verifizierung laeuft hoechstens einmal alle 5 Minuten — wenn du einen Fehler korrigierst (z. B. einen falschen Key), warte kurz und speichere erneut.

Dann schalte Enable tracking ein und speichere erneut. Shopware baut den Theme-Cache bei der Plugin-Aktivierung neu auf, sodass der Tracker sofort auf deinen Seiten erscheint.

Schritt 5: Verifizieren, dass Tracking funktioniert

1. Oeffne deinen Shop in einem Inkognito-/Privatfenster und besuche einige Seiten
2. Oeffne das MetriXs-Dashboard und pruefe die Echtzeit-Ansicht — Pageviews sollten innerhalb von Sekunden erscheinen

So funktioniert die Verifizierung: Das Plugin fragt die MetriXs-API nach einem einmaligen Challenge-Token, stellt ihn unter deiner eigenen Domain bereit (/mxcoan/challenge), und die API ruft ihn ab. Nur jemand, der deine Domain kontrolliert, kann den Token bereitstellen — damit ist der Besitz bewiesen. Der Token wird nach dem Handshake wieder entfernt.

Bestellungen und Umsatz

Ist das Plugin verbunden, kommen abgeschlossene Bestellungen von allein: Das Plugin meldet eine Bestellung, sobald ihre Transaktion auf Bezahlt steht, und MetriXs zählt sie als Conversion - Umsatz- und Conversion-Ansichten füllen sich ohne zusätzliche Einstellung. Jede Meldung enthält den Bruttogesamt- betrag, die Währung, die Bestellnummer und die Positionen (Name, Preis, Menge). Persönliche Daten gehen nicht mit - kein Name, keine Adresse, keine E-Mail und kein Bestelllink.

Eine Bestellung wird nur einmal gemeldet, auch wenn sie später erstattet wird oder sich der Status ändert. Ist MetriXs kurzzeitig nicht erreichbar, geht die Meldung nicht verloren, sondern folgt beim nächsten Statuswechsel.

Hinweis

Mehrere Vertriebskanäle auf verschiedenen Domains? Injectiert wird nur die Domain, die beim Handshake verifiziert wurde. Lege die weiteren Domains bei MetriXs an und nutze pro Domain ein Plugin oder das Snippet.

Einstellungsreferenz

Einstellung	Standard	Bedeutung
Enable tracking	Aus	Hauptschalter — nichts wird geladen, bis der Shop verbunden ist und dies eingeschaltet ist
Site API key	—	Site-spezifischer Key aus dem Dashboard
MetriXs API URL	https://app.metrixs.eu	Nur bei eigenen Endpunkten aendern

Das Tracker-Skript wird von app.metrixs.eu mit versionierter URL ausgeliefert, in den <head> jeder Seite eingebunden und asynchron (defer) geladen. Es funktioniert problemlos neben Shopwares HTTP-Cache und Full-Page-Caching: Das Plugin leert den Cache beim Verbinden.

Fehlerbehebung

Verifizierung schlaegt fehl

• Stelle sicher, dass der Shop oeffentlich ueber HTTPS erreichbar ist (kein Wartungsmodus, keine Firewall, die die MetriXs-Server blockiert)
• Pruefe Hosting-Sicherheitsmodule, die unbekannte Bots blockieren — die MetriXs-API ruft die Challenge-URL von der oeffentlichen Domain deines Shops ab
• Speichere die Einstellungsseite erneut: Das Plugin wiederholt die Verifizierung (hoechstens einmal alle 5 Minuten)

Keine Daten im Dashboard

• Enable tracking muss eingeschaltet sein und der Shop muss verbunden (verifiziert) sein
• Die Domain muss exakt der Domain in MetriXs entsprechen (ohne www., ohne https://)
• Du brows in deinem eigenen Shop als Admin? Storefront-Besuche werden wie jeder Besucher gezaehlt — teste aus einem Inkognito-Fenster, wenn du nur deinen eigenen Traffic siehst
• Full-Page-Cache im Einsatz? Das Plugin leert ihn beim Verbinden; wenn du Tracking ohne Neuverbindung eingeschaltet hast, leere den Cache manuell

Umsatz bleibt bei null

• Bestellungen brauchen keine Einstellung, aber einen verbundenen Shop: das Plugin schaltet beim Verifizieren die Commerce-Funktion der Site mit an
• Gezählt wird erst, wenn die Transaktion Bezahlt erreicht - Bestellungen in “In Bearbeitung” fehlen noch

API-Key verloren Keys koennen nach der Erstellung nicht abgerufen werden. Widerrufe den alten Key im Dashboard (Einstellungen → Sites → API-Keys), erstelle einen neuen und trage ihn in den Plugin-Einstellungen ein.

Deinstallieren

Wenn du das Plugin deinstallierst:

• Dein Shop wird in MetriXs automatisch als getrennt markiert (Events werden nicht mehr akzeptiert)
• Deine historischen Daten bleiben in deinem MetriXs-Konto
• Die Plugin-Einstellungen werden aus deiner Datenbank entfernt

Ohne Plugin bevorzugt?

Du kannst den Tracker jederzeit manuell mit dem Snippet aus den Plattform-Guides einbinden — das Plugin automatisiert nur Installation, Verifizierung und Cache-Handling.