---
slug: shopware-plugin
title: "Wie richte ich Metrunio in Shopware 6 ein?"
category: installation
locale: de
updated: 2026-10-16
keywords: ["Shopware","Shopware 6","Plugin","Sales Channel","Message-Worker","SHOPWARE_SNIPPET_INACTIVE","SHOPWARE_REPORTS_STALLED","Consent prüfen","OneTrust"]
questions: ["Wie installiere und verbinde ich das Metrunio-Plugin für Shopware?","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?"]
url: https://bench.metrunio.com/de/hilfe/shopware-plugin
---

# Wie richte ich Metrunio in Shopware 6 ein?

**Wie installiere und verbinde ich das Metrunio-Plugin für Shopware?**

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.

## 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

1. Lade 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.
2. Öffne „Erweiterungen → Meine Erweiterungen → Metrunio → Konfigurieren“ und wähle oben den Sales Channel.
3. Klicke auf „Mit Metrunio verbinden“. Das Portal öffnet sich: Melde dich an, wähle die Website und bestätige.
4. Du landest wieder in Shopware. Die Statuszeile nennt die verbundene Website.
5. Wähle unter „Consent-Quelle“ dein Werkzeug oder lass „Automatisch“ stehen. Speichere und leere den Cache.
6. Klicke 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.
7. Ö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.

## 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ührend

- https://bench.metrunio.com/de/hilfe/consent-bridge
- https://bench.metrunio.com/de/hilfe/shopsysteme
- https://bench.metrunio.com/de/hilfe/server-events-api
- https://bench.metrunio.com/de/hilfe/erstattungen
- https://bench.metrunio.com/de/hilfe/abo-folgezahlungen
- https://bench.metrunio.com/de/hilfe/erlaubte-domains
- https://bench.metrunio.com/de/hilfe/health-center