Installation
Wie richte ich Metrunio in Shopware 6 ein?
Du installierst das Plugin „Metrunio“ in Shopware 6, klickst in seinen Einstellungen auf „Mit Metrunio verbinden“ und bestätigst im Portal die Website. Danach misst das Plugin die Besuche, übernimmt die Einwilligung aus deinem Consent-Werkzeug und meldet Bestellungen, Stornos und Erstattungen direkt vom Shop-Server.
Wie installiere und verbinde ich das Metrunio-Plugin für Shopware?
Was du brauchst
- Shopware 6.6 oder 6.7, selbst betrieben oder bei einem Hoster. In Shopware Cloud laufen keine Plugins; dort misst du über das Snippet und die Server Events API.
- Ein Metrunio-Konto mit einer Website für den Shop und abgeschlossenem Auftragsverarbeitungsvertrag. Vorher nimmt Metrunio nichts an.
- Die Domain des Shops unter den Adressen dieser Website, als Hauptadresse oder erlaubte Domain. Nur dorthin leitet das Portal nach der Freigabe zurück.
- Einen laufenden Message-Worker. Shopware verschickt die Bestellmeldungen über seine Warteschlange; der Admin-Worker genügt.
Einrichten
- 01Lade das kostenlose Plugin „Metrunio“ im Portal unter „Einrichtungsassistent“ herunter. Lade die Datei in der Administration unter „Erweiterungen → Meine Erweiterungen → Erweiterung hochladen“ hoch, installiere und aktiviere das Plugin.
- 02Öffne „Erweiterungen → Meine Erweiterungen → Metrunio → Konfigurieren“ und wähle oben den Sales Channel.
- 03Klicke auf „Mit Metrunio verbinden“. Das Portal öffnet sich: Melde dich an, wähle die Website und bestätige.
- 04Du landest wieder in Shopware. Die Statuszeile nennt die verbundene Website.
- 05Wähle unter „Consent-Quelle“ dein Werkzeug oder lass „Automatisch“ stehen. Speichere und leere den Cache.
- 06Klicke in den Plugin-Einstellungen auf „Consent prüfen“. Dein Shop öffnet sich mit einer kleinen Anzeige oben rechts: welches Consent-Werkzeug erkannt ist, welchen Eintrag es sucht und welche Entscheidung vorliegt. Stimme im Banner zu, und die Anzeige zeigt die neue Entscheidung.
- 07Öffne den Shop in einem privaten Fenster, stimme im Banner zu und rufe zwei Seiten auf. Im Portal erscheinen sie im Live-Test.
Das Plugin liest die Entscheidung aus dem Cookie-Manager von Shopware oder aus Usercentrics, consentmanager, Cookiebot, CCM19, OneTrust, dem Google Consent Mode oder IAB TCF. Für Werkzeuge, die Skripte vor der Einwilligung selbst zurückhalten (Cookiebot, Usercentrics, consentmanager, OneTrust), tragen die Skript-Tags von Metrunio die Ausnahmen, die diese Werkzeuge dafür vorsehen. Vor der Entscheidung deiner Besucher speichern und senden sie nichts. Einen Eintrag für Metrunio brauchst du nur in Werkzeugen, die nach Diensten fragen, etwa Usercentrics oder CCM19; welchen, zeigt die Prüfung.
Hat dein Shop mehrere Sales Channels, verbindest du jeden einzeln. Jeder misst in die Website, die du beim Verbinden wählst; zwei Kanäle dürfen dieselbe Website nehmen.
Was das Plugin misst
| Was | Woher | Wann |
|---|---|---|
| Seitenaufrufe und Einwilligung | Snippet auf jeder Seite des Sales Channels | erst nach der Entscheidung im Banner |
| Kauf | vom Shop-Server, wenn die Bestellung angelegt wird | mit Einwilligung verbunden mit den Besuchen; ohne Entscheidung im Banner mit Bestellnummer, ohne Browser-, Kunden- und Werbekennungen, nicht zugeordnet; nach einer Ablehnung ebenso, aber nur mit aktivierter Zusatzweisung zur Umsatzabstimmung |
| Storno und volle Erstattung | vom Shop-Server beim Statuswechsel | als Erstattung über den vollen Betrag |
| Abo-Bestellungen aus Shopware Subscriptions (ab 1.3.0) | vom Shop-Server, mit der Kennung des Abos | die erste Bestellung wie jeder Kauf; jede Folgebestellung als Folgezahlung ohne Entscheidung und ohne Kennungen, gemessen und nie zugeordnet |
| Verbindung von Kauf und Besuchen | Kennung aus der Sitzung, die das Plugin an die Bestellung hängt | nur mit Einwilligung für Analytics |
Beträge gehen in der Standardwährung deines Shops hinaus, mit dem Kurs, den Shopware bei der Bestellung verwendet hat. Den Wareneinsatz nimmt das Plugin aus dem Einkaufspreis der Produkte, aber nur, wenn er für jede Position gepflegt ist. Fehlt er bei einer, bleibt das Feld leer.
Wenn im Portal ein Befund steht
| Befund | Ursache | Was du tust |
|---|---|---|
| SHOPWARE_SNIPPET_INACTIVE | Das Snippet ist für den Sales Channel ausgeschaltet. Bestellungen kommen an, Besuche nicht. | In den Plugin-Einstellungen einschalten, speichern, Cache leeren. |
| SHOPWARE_REPORTS_STALLED | Bestellmeldungen liegen seit mehr als einer Stunde im Shop. Meist läuft kein Message-Worker. | Den Worker starten. Nicht gemeldete Bestellungen lassen sich in den Plugin-Einstellungen erneut anstoßen. |
Grenzen
- Teilerstattungen meldet das Plugin nicht. Shopware kennt dafür nur den Status „teilweise erstattet“, nicht den Betrag. Melde sie über die Server Events API.
- Eine Folgebestellung aus Shopware Subscriptions entsteht ohne Besuch. Sie geht ohne Einwilligungsentscheidung hinaus, auch wenn Shopware die Angaben der ersten Bestellung mitkopiert, und wird deshalb nie zugeordnet. Legt eine Bestellung mehrere Abos an (gemischter Warenkorb mit verschiedenen Plänen), trägt sie keine Abo-Kennung.
- Bestellungen, die du in der Administration anlegst, haben keine Sitzung und damit keine Einwilligung. Sie zählen im Umsatz, werden aber keinem Kanal zugeordnet.
- Bricht jemand die Zahlung bei PayPal oder Klarna ab, storniert Shopware die Bestellung. Im Bericht stehen dann ein Kauf und eine Erstattung.
- Deine Daten bleiben nach einer Deinstallation in Metrunio. Ist Metrunio beim Deinstallieren nicht erreichbar, bleibt die Verbindung bestehen. Du löst sie dann im Portal unter „Datenverbindungen“ mit „Verbindung lösen“; das darf die Rolle Admin.
- Bei der Deinstallation bleiben die Angaben von Metrunio an deinen Bestellungen stehen (
order.customFields.metrunio: Kennungen von Besuch und Sitzung und der Einwilligungsstand). Sie gehören zur Bestellung in deinem Shop, und installierst du das Plugin wieder, meldet es Erstattungen früherer Bestellungen mit ihrem Einwilligungsstand.
Zuletzt geprüft am 16.10.2026
Im Überblick
Einbaucode, Einwilligung und Bestellungen vom Shop-Server, für Shopware 6.6 und 6.7.
Im Kundenportal
Ebenfalls gefragt
- Was bleibt bei der Deinstallation an meinen Bestellungen?
- Wo bekomme ich das Shopware-Plugin?
- Shopware-Plugin herunterladen
- Shopware Plugin installieren
- Metrunio in Shopware einbauen
- Shopware 6 Tracking-Plugin
- Shopware mit Metrunio verbinden
- Bestellmeldungen aus Shopware stehen
- Das Snippet ist im Sales Channel ausgeschaltet
- Geht das Plugin in Shopware Cloud?
- Läuft das Plugin mit Shopware 6.6?
- Wie prüfe ich, ob Shopware die Einwilligung an Metrunio gibt?
- Funktioniert das Plugin mit OneTrust, Usercentrics oder Cookiebot?
- Blockiert mein Consent-Werkzeug das Skript von Metrunio?
Weiterführende Artikel
- Wie übernimmt Metrunio die Entscheidung aus meinem Consent-Werkzeug?
Muss ich metrunio.setConsent selbst aufrufen, wenn ich Usercentrics, Cookiebot, Complianz, Borlabs Cookie, Real Cookie Banner oder ein anderes gängiges Consent-Werkzeug nutze?
Über die Consent-Bridge, ohne dass du
metrunio.setConsentselbst aufrufst: Für dreizehn Werkzeuge liest dieses kleine Zusatzskript die Entscheidung aus deinem Banner und gibt sie an Metrunio weiter, auch jeden späteren Widerruf. Der Einbaucode im Portal enthält es, sobald du im Consent-Schritt dein Werkzeug wählst, und das Shopware-Plugin bindet es selbst ein. - Wo baue ich das Tracking in meinem Shopsystem ein?
Wie installiere ich Metrunio in WordPress, Shopify, Shopware oder Webflow?
Für Shopify, Shopware 6 und WordPress mit WooCommerce gibt es eine Erweiterung, die Besuche, Einwilligung und Bestellungen zugleich misst. Die übrigen Systeme haben eine Stelle für eigenen Head-Code; die Tabelle nennt den Weg je System. Ohne Erweiterung empfehlen wir für Kaufabschlüsse zusätzlich die Server Events API, weil sie unabhängig vom Browser funktioniert.
- Wie melde ich Conversions serverseitig?
Wie sende ich Events aus meinem Shop, CRM oder Backend?
Über POST /v1/server/events an den Collector, mit dem Serverschlüssel im Authorization-Header. Die Adresse und den fertigen Aufruf für deine Website zeigt das Portal unter „Einrichtung“ im Reiter „Server Events API“. Der Aufruf ist unabhängig vom Browser und damit robust gegenüber Adblockern und kurzlebigen Cookies.
- Wie kommen Erstattungen in Metrunio an?
Wie melde ich eine Erstattung, und woran sehe ich, dass sie verbucht ist?
Dein Shop-Server meldet eine Erstattung über die Server Events API als
refund, mit derselben Bestellnummer, Umgebung und Währung wie der Kauf. Metrunio mindert damit den Wert dieser Bestellung. Findet es 24 Stunden lang keinen passenden Kauf, verbucht es die Erstattung nicht und löscht sie. Unter „Datenstatus“ zählt der Befund REFUND_WITHOUT_PURCHASE dann je Website und Tag, wie viele es waren, ohne Bestellnummer. - Wie zählt Metrunio Folgezahlungen eines Abos?
Wie kennzeichne ich Abo-Folgezahlungen, und welchem Kanal werden sie zugeordnet?
Eine Folgezahlung meldest du als Kauf mit der Kennung des Abos (subscription_id) und dem Kennzeichen subscription_renewal; Verlängerungen aus Stripe kennzeichnet Metrunio selbst. Sie zählt im gemessenen Umsatz, steht in den Berichten getrennt und bekommt die Anteile der ersten Bestellung desselben Abos, denn einen eigenen Werbekontakt hat sie nicht. Ohne bekannte erste Bestellung oder ohne Einwilligung bleibt sie mit Grund nicht zugeordnet.
- Warum muss ich Domains freigeben?
Was bedeutet DOMAIN_NOT_ALLOWED und wie ergänze ich eine Domain?
Der Schreibschlüssel ist im Quelltext sichtbar; damit ihn keine fremde Website im Browser ihrer Besucher verwenden kann, prüft der Collector die Herkunft der Anfrage. Steht die Domain nicht in der Liste der erlaubten Domains, wird das Event mit DOMAIN_NOT_ALLOWED abgewiesen. Eine Anfrage außerhalb eines Browsers hält diese Prüfung nicht ab, deshalb meldest du Käufe am besten zusätzlich über deinen Server.
- Was macht das Setup Health Center?
Wie finde ich heraus, was an meiner Einrichtung fehlt?
Das Health Center führt eine Diagnose über deine Einrichtung aus und meldet jeden Befund mit Ursache, Auswirkung, Fehlercode und den Schritten zur Behebung, statt nur mit einer Fehlermeldung.