Facebook Pixel (Meta Pixel)
Facebook Pixel (Meta Pixel) für Shopware 6.7: Browser-Tracking für E-Commerce-Events, serverseitige Conversions API mit Deduplizierung und Einwilligung über Cookie-Prüfung oder Klaro, konfigurierbar pro Sales Channel.
Facebook Pixel (Meta Pixel)
Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net
Überblick
Das Plugin bindet das Meta Pixel in die Shopware-Storefront ein und meldet E-Commerce-Events an Meta: Seitenaufrufe, Produkt- und Kategorieansichten, Warenkorb, Checkout und Bestellungen. Zusätzlich kann es dieselben Events serverseitig über die Meta Conversions API senden. Die Einstellungen gelten pro Sales Channel.
Datenschutz: Das Plugin sendet Daten an Meta. Ohne weitere Einstellung lädt das Pixel ohne Einwilligung. Schalte vor dem Livegang die Cookie-Prüfung oder die Klaro-Anbindung ein. Bei der Conversions API gehen IP-Adresse und User-Agent nicht gehasht an Meta, nur E-Mail und Telefonnummer werden gehasht.
graph LR
A["Storefront-Seite"] --> B["Event mit eventID"]
B --> C{"Einwilligung"}
C -->|"vorhanden"| D["Meta Pixel im Browser"]
B --> E{"CAPI aktiv, Event gewählt, Einwilligung"}
E -->|"ja"| F["Message Queue"]
F --> G["Meta Conversions API"]
D --> H["Meta Events Manager"]
G --> H
Dokumentation
| Seite | Inhalt |
|---|---|
| Installation | Installation per Store, Composer oder ZIP, Message-Consumer, Update, Deinstallation |
| Konfiguration | Alle Einstellungen, Verbindungstest, Praxis-Beispiele |
| Events und Daten | Welche Events wann feuern und welche Felder sie übertragen |
| Consent und Cookies | Cookie-Prüfung, Klaro-Anbindung, automatisch angelegter Klaro-Service |
| Conversions API | Einrichtung, Bedingungen für den Versand, Deduplizierung, Fehlerverhalten |
| Datenschutz | Genau welche Daten an Meta gehen, was gehasht wird und was nicht |
| Fehlerbehebung | Typische Probleme, Prüfschritte, bekannte Einschränkungen |
| Technische Details | Ablauf, Plugin-Struktur, Admin-Route, Lebenszyklus |
Features
| Feature | Beschreibung |
|---|---|
| E-Commerce-Events | PageView, ViewContent, ViewCategory, AddToCart, InitiateCheckout und Purchase, einzeln abschaltbar (außer PageView) |
| Conversions API | Serverseitiger Versand über die Message Queue, mit Auswahl der Events und Test Event Code |
| Deduplizierung | Browser und Server verwenden dieselbe Event-ID |
| Verbindungstest | Schaltfläche in der Konfiguration, die Pixel ID und Access Token prüft |
| Einwilligung | Eigene Cookie-Prüfung oder Klaro, für Browser und Conversions API gleichermaßen |
| Brutto-/Netto-Preise | Umschaltbar für B2C und B2B |
| Klaro-Service | Wird bei der Aktivierung automatisch angelegt, wenn MmdKlaroConsent installiert ist |
| Multi-Sales-Channel | Konfiguration pro Sales Channel |
Anforderungen
| Anforderung | Version | Hinweise |
|---|---|---|
| Shopware | ~6.7.0 | Composer-Paket mmd/sw67-facebook-pixel |
| PHP | ab 8.2 | |
| MmdKlaroConsent | optional | Nur für die Klaro-Anbindung |
| Lizenz | Kommerziell | Eine Lizenz pro Installation |
Lizenz
Kommerzielle Lizenz, Einzelinstallations-Lizenz inklusive:
- Alle Sales Channels
- Entwicklungs- und Staging-Umgebungen
- 12 Monate kostenlose Updates
Siehe LICENSE-Datei für die vollständigen Bedingungen.
Support
Für Fragen und Support:
Markus Michalski
E-Mail: support@markus-michalski.net