Voraussetzungen
- Shopware 6.7.14 in einer Installation, die Plugins unterstützt.
- PHP 8.3 oder PHP 8.4.
- Eine Meta-Pixel-ID sowie Zugriff auf den zugehörigen Meta Events Manager.
- Die native Cookie-Einwilligung von Shopware für die Steuerung des Pixels.
- Zugriff auf die Erweiterungsverwaltung und die Einstellungen der betreffenden Verkaufskanäle.
Die Anleitung bezieht sich auf EshaMetaPixelIntegration 1.1.1. Die Erweiterung enthält weder Conversions API noch Advanced Matching. Google Tag Manager ist für diese Einbindung nicht erforderlich.
Installation
Über den Shopware Store: Beziehe Meta Pixel Tracking über den Store und füge die Erweiterung deiner Shop-Installation hinzu. Installiere und aktiviere sie anschließend in der Shopware-Administration unter „Erweiterungen“ → „Meine Erweiterungen“.
Über ein ZIP-Paket: Lade das bereitgestellte EshaMetaPixelIntegration-Paket unter „Erweiterungen“ → „Meine Erweiterungen“ hoch. Installiere und aktiviere die Erweiterung. Verwende ein vollständiges Installationspaket, keinen Quellcode-Export des Repositories.
Eine aktive Erweiterung allein startet noch kein Tracking: Eine gültige Pixel-ID und die Einwilligung des Besuchers sind ebenfalls erforderlich. Vermeide parallele Einbindungen desselben Pixels über Theme, weitere Erweiterungen oder Tag Manager – sonst können Ereignisse mehrfach erfasst werden.
Wechsel von einer älteren technischen Plugin-Identität: EshaMetaPixelIntegration ist nicht nur ein neuer Anzeigename. Beim Wechsel von DifoFacebookPixelIntegration müssen die Pixel-Einstellungen je Verkaufskanal übernommen werden. Behandle den Wechsel nicht als gewöhnliches In-place-Update. Stimme die Übernahme vorab mit dem Support ab.
Einrichtung in drei Schritten
1. Pixel-ID je Verkaufskanal hinterlegen
Öffne die Konfiguration von Meta Pixel Tracking in der Erweiterungsverwaltung. Wähle den gewünschten Verkaufskanal und trage im Feld „Meta Pixel ID“ die zugehörige ID ein: nur Ziffern, ohne Leerzeichen. Speichere die Einstellung und leere nach Änderungen den Storefront-Cache. Wiederhole dies bei Bedarf für weitere Verkaufskanäle. Eine leere oder ungültige ID deaktiviert das Tracking über diese Einbindung.
2. Cookie-Einwilligung prüfen
Öffne die Cookie-Einstellungen deiner Storefront. Die Erweiterung registriert den Eintrag „Meta Pixel“ in der Marketing-Gruppe der nativen Shopware-Cookieverwaltung. Prüfe, dass der Eintrag sichtbar ist und die Einwilligung nicht vorweggenommen wird. Ohne Zustimmung darf die Erweiterung den Pixel nicht laden. Nach Zustimmung wird die Einbindung aktiv; ein Widerruf wird ohne Seitenneuladen berücksichtigt.
Bei einer anderen Consent-Lösung muss die Integration gesondert geprüft werden. Eine pauschale Kompatibilität mit allen Consent-Managern wird nicht zugesagt.
3. Events im Meta Events Manager kontrollieren
Öffne im Meta Events Manager den zur Pixel-ID gehörenden Datenbereich und dessen Testfunktion für Ereignisse. Besuche deine Storefront in einer frischen Browsersitzung zunächst ohne Einwilligung, dann nach Zustimmung. Rufe ein Produkt auf, wechsle gegebenenfalls die Variante, lege einen Artikel in den Warenkorb und starte den Checkout. Schließe anschließend einen ausdrücklich dafür vorgesehenen Testkauf ab.
Kontrolliere die unten aufgeführten Events und deren Werte. Widerrufe danach die Einwilligung und prüfe, dass über diese Einbindung keine weiteren Events übermittelt werden. Bereits übertragene Daten werden durch den Widerruf nicht zurückgerufen. Ein erst nach dem Kauf erteilter Consent löst keine nachträgliche Kaufmeldung aus.
Browser-Einstellungen, Werbeblocker und fehlende Einwilligungen können die Erfassung begrenzen. Eine erfolgreiche lokale Einrichtung garantiert keine vollständige Erfassung oder Zuordnung in Meta.
Welche Events werden übertragen?
| Event | Anlass | Vom Plugin ergänzte Commerce-Parameter |
|---|---|---|
| PageView | Seitenaufruf nach Einwilligung | Keine Artikel-, Wert- oder Währungsparameter |
| ViewContent | Produktansicht, einschließlich Variantenwechsel | Artikelnummer der ausgewählten Variante, Menge, Brutto-Artikelpreis, Bruttowert und Währung |
| AddToCart | Erfolgreiches Hinzufügen von Artikeln zum Warenkorb | Artikelnummern und tatsächlich hinzugefügte Mengen, Brutto-Artikelpreise, Bruttowert der hinzugefügten Artikel und Währung |
| InitiateCheckout | Beginn des Checkouts | Artikelnummern, Mengen, Brutto-Artikelpreise, zahlbarer Bruttogesamtwert und Währung |
| Purchase | Abgeschlossener Kauf auf der Bestellbestätigung | Artikelnummern, Mengen, Brutto-Artikelpreise, zahlbarer Bruttogesamtwert und Währung |
Die Commerce-Parameter heißen content_ids, content_type (Wert product), contents, value und currency. Die Einträge in contents enthalten id, quantity und item_price. Artikelnummern dienen als IDs, nicht interne Produkt-UUIDs. Bei Checkout und Kauf berücksichtigt der Gesamtwert Rabatte und Versandkosten; er muss deshalb nicht der Summe der aufgeführten Artikelpreise entsprechen.
Event-IDs und browserseitige Versandmarker helfen, wiederholte Meldungen zu vermeiden. Das ist keine globale Exactly-once-Garantie. Bereits abgeschlossene Käufe werden bei späterer Zustimmung nicht rückwirkend gemeldet.
Datenschutz und Einwilligung
Die Datenübertragung an Meta über diese Einbindung beginnt erst nach Einwilligung. Ein Widerruf stoppt weitere Ereignisse über diese Einbindung, macht bereits erfolgte Übertragungen aber nicht rückgängig. Für die Funktion werden Cookies sowie LocalStorage und SessionStorage im Browser genutzt.
Das vom Plugin aufgebaute Event-Payload enthält keine Kundenangaben wie Namen, E-Mail-Adressen oder Postanschriften. Daraus folgt nicht, dass die Pixel-Nutzung anonym ist: Meta kann technische Kennungen und Verbindungsdaten verarbeiten. Als Shopbetreiber bist du für eine geeignete Einwilligung, die rechtliche Prüfung und eine zutreffende Datenschutzerklärung verantwortlich. Die Erweiterung ersetzt keine Datenschutzberatung und garantiert keine rechtskonforme Gesamtkonfiguration.
Häufige Fragen
Warum sehe ich keine Events?
Prüfe zuerst Aktivierung, gewählten Verkaufskanal, eine gültige Pixel-ID und die gespeicherten Einstellungen. Leere nach Konfigurationsänderungen den Storefront-Cache. Erteile in der Storefront die Einwilligung für „Meta Pixel“. Prüfe außerdem Werbeblocker und Browser-Einstellungen. Stelle sicher, dass du im Meta Events Manager den richtigen Pixel kontrollierst.
Kann jeder Verkaufskanal eine eigene Pixel-ID verwenden?
Ja. Wähle in der Konfiguration den betreffenden Verkaufskanal und hinterlege dessen Pixel-ID. Prüfe jeden Kanal separat.
Warum erscheinen Events doppelt?
Prüfe, ob derselbe Pixel zusätzlich über Theme, Tag Manager oder eine andere Erweiterung geladen wird. Die Deduplikation dieser Erweiterung ersetzt keine Abstimmung mit anderen Einbindungen.
Sind Conversions API oder Advanced Matching enthalten?
Nein. Meta Pixel Tracking bindet den Browser-Pixel ein. Eine serverseitige Conversions API und Advanced Matching gehören nicht zum Funktionsumfang.
Werden abgelehnte oder frühere Käufe später nachgemeldet?
Nein. Ohne Einwilligung erfolgt über diese Einbindung kein Tracking. Eine erst nach dem Kauf erteilte Zustimmung führt nicht zur rückwirkenden Meldung dieses Kaufs.
Änderungen in Version 1.1.1
- Neuer technischer Name EshaMetaPixelIntegration. Beim Wechsel von Difo müssen Pixel-Einstellungen je Verkaufskanal übernommen werden; Cookie-Auswahl und vorhandene Versandmarker bleiben kompatibel.
- SDK-Fehler beeinträchtigen Warenkorb und Checkout nicht; ausstehende Trackingereignisse werden sauber beendet.
- Consentbeschreibung um Produkt-, Warenkorb-, Checkout- und Kaufmessung sowie Browserspeicherung ergänzt.
- Unnötige Checkoutabrufe begrenzt und technische Antwortheader verbessert.
Support
Du brauchst Hilfe bei Einrichtung oder Versionswechsel? Schreib an info@digital-forces.de. Nenne deine Shopware-, PHP- und Plugin-Version sowie den betroffenen Schritt. Sende keine Passwörter, Zugangstoken oder Kundendaten mit.
Anbieter und Kontakt: DigitalForces. Diese Dokumentation enthält keine Zusage zu Antwortzeiten oder individuellen Servicelevels.