Facebook Pixel: Konfiguration
Alle Einstellungen des Facebook Pixel (Meta Pixel) Plugins für Shopware 6.7: Pixel ID, Tracking-Optionen, Conversions API, Klaro-Anbindung und Verbindungstest, mit Standardwerten und Praxis-Beispielen.
Facebook Pixel: Konfiguration
Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net
Wo du die Einstellungen findest
Im Shopware Admin unter Erweiterungen > Meine Erweiterungen beim Plugin Facebook Pixel (Meta Pixel) auf Konfigurieren gehen. Oben wählst du, ob die Werte für alle Sales Channels oder für einen einzelnen Sales Channel gelten. Jede Einstellung lässt sich pro Sales Channel überschreiben.
Facebook Pixel Optionen
| Einstellung | Schlüssel | Standard | Beschreibung |
|---|---|---|---|
| Pixel ID | pixelId |
leer | Die Pixel ID aus dem Meta Events Manager. Pflichtfeld, nur Ziffern. Enthält der Wert etwas anderes als Ziffern, wird gar nichts ausgegeben. |
| Tracking aktivieren | trackingEnabled |
Aus | Hauptschalter. Ist er aus, rendert das Plugin nichts und sendet keine serverseitigen Events. |
| Cookie-Einwilligung erforderlich | requireCookieConsent |
Aus | Pixel und Conversions API nur nach Einwilligung. Die Einwilligung wird über Cookies erkannt, siehe Consent und Cookies. Wirkt nicht, wenn die Klaro-Anbindung aktiv ist. |
Tracking Optionen
| Einstellung | Schlüssel | Standard | Beschreibung |
|---|---|---|---|
| Artikel-Aufrufe tracken | trackProductViews |
An | ViewContent auf Produktdetailseiten |
| Kategorien tracken | trackCategories |
An | ViewCategory (Custom Event) auf Kategorieseiten |
| Warenkorb-Aktionen tracken | trackAddToCart |
An | AddToCart auf der Warenkorbseite |
| Checkout tracken | trackInitiateCheckout |
An | InitiateCheckout auf der Checkout-Bestätigungsseite |
| Bestellungen tracken | trackOrders |
An | Purchase auf der Bestellabschlussseite |
| Brutto-Preise tracken | trackGrossPrices |
An | Preise inklusive MwSt. verwenden. Für B2B-Shops ausschalten, dann werden Netto-Preise übertragen. |
PageView hat keinen eigenen Schalter und wird immer ausgelöst, sobald das Tracking aktiv und die Pixel ID gültig ist. Was jedes Event überträgt, steht auf der Seite Events und Daten.
Conversions API (Server-seitig)
| Einstellung | Schlüssel | Standard | Beschreibung |
|---|---|---|---|
| Conversions API aktivieren | capiEnabled |
Aus | Events zusätzlich serverseitig an Meta senden |
| Access Token | capiAccessToken |
leer | Token der Conversions API aus dem Meta Events Manager. Das Feld ist ein Passwortfeld. |
| Test Event Code (optional) | capiTestEventCode |
leer | Test-Code aus dem Meta Events Manager. Mit gesetztem Code erscheinen die Events im Tab Test-Events. Für den Livebetrieb leeren. |
| Server-seitige Events | capiEventSelection |
keines gewählt | Mehrfachauswahl aus PageView, ViewContent, ViewCategory, AddToCart, InitiateCheckout und Purchase. Nur gewählte Events werden serverseitig gesendet. |
Ist die Auswahl leer, sendet die Conversions API nichts, auch wenn sie aktiviert ist. Meta empfiehlt mindestens PageView und Purchase.
Die Conversions API arbeitet nur, wenn zusätzlich Tracking aktivieren eingeschaltet, die Pixel ID gültig und ein Access Token eingetragen ist. Alle Details stehen auf der Seite Conversions API.
Verbindung testen
Unter dem Test Event Code sitzt der Block API-Verbindung testen mit der Schaltfläche Verbindung testen. Sie sendet ein PageView-Test-Event an die Conversions API und prüft damit Pixel ID und Access Token.
- Verwendet werden die aktuell im Formular eingetragenen Werte. Fehlt dort ein Wert, wird der zuletzt gespeicherte genommen. Maßgeblich ist der oben gewählte Sales Channel.
- Der Test braucht weder aktivierte Conversions API noch aktiviertes Tracking.
- Das Test-Event trägt die IP-Adresse deines Admin-Zugriffs und die feste Kennung
Mmd-FacebookPixel-Plugin/Testals User-Agent. - Ohne Test Event Code zählt Meta das Test-Event wie ein normales PageView-Event. Trage vor dem Test einen Test Event Code ein, wenn du das vermeiden willst.
- Der Aufruf braucht das Recht
system_config:read.
Das Ergebnis erscheint als Banner unter der Schaltfläche. Der Banner-Titel ist bei Erfolg Verbindung erfolgreich, sonst Verbindung fehlgeschlagen. Darunter steht der Text aus der Tabelle:
| Ergebnis | Text im Banner |
|---|---|
| Erfolg (HTTP 200) | Meta hat das Test-Event akzeptiert. Pixel-ID und Access-Token sind gültig. |
| Keine Pixel ID | Bitte trage zuerst eine Pixel-ID ein und speichere die Konfiguration. |
| Kein Access Token | Bitte trage zuerst einen Access-Token ein und speichere die Konfiguration. |
| Pixel ID mit anderen Zeichen als Ziffern | Die Pixel-ID darf nur Ziffern enthalten. |
| Meta antwortet mit einem anderen Status als 200 und liefert eine Fehlermeldung | Meta hat die Anfrage abgelehnt (HTTP {status}, Code {code}): {message}. Status, Code und Meldung stammen von Meta. |
| Meta antwortet mit einem anderen Status als 200 und liefert keine Fehlermeldung | Meta hat die Anfrage abgelehnt. Bitte prüfe Pixel-ID und Access-Token im Meta Events Manager. |
| Anfrage technisch gescheitert (zum Beispiel Timeout oder Firewall) | Verbindung zu graph.facebook.com nicht möglich. Bitte prüfe die Server-Internetverbindung und Firewall. |
Klaro Consent Integration
| Einstellung | Schlüssel | Standard | Beschreibung |
|---|---|---|---|
| Klaro Consent Manager verwenden | useKlaroConsent |
Aus | Pixel-Skripte werden für Klaro blockiert gerendert und erst nach Einwilligung ausgeführt. Setzt das Plugin MmdKlaroConsent voraus. |
| Klaro Service-Name | klaroServiceName |
facebook-pixel |
Technischer Name des Klaro-Service. Muss mit dem Service in MmdKlaroConsent übereinstimmen. |
Details und Zusammenspiel mit den anderen Einstellungen stehen auf der Seite Consent und Cookies.
Praxis-Beispiele
B2C-Shop mit Klaro und Conversions API
| Einstellung | Wert |
|---|---|
| Pixel ID | deine numerische Pixel ID |
| Tracking aktivieren | An |
| Klaro Consent Manager verwenden | An |
| Klaro Service-Name | facebook-pixel |
| Brutto-Preise tracken | An |
| Conversions API aktivieren | An |
| Access Token | Token aus dem Events Manager |
| Server-seitige Events | PageView, ViewContent, AddToCart, InitiateCheckout, Purchase |
B2B-Shop ohne Klaro, mit eigener Consent-Lösung
| Einstellung | Wert |
|---|---|
| Tracking aktivieren | An |
| Cookie-Einwilligung erforderlich | An |
| Brutto-Preise tracken | Aus |
Deine Consent-Lösung muss dann einen der erkannten Cookies setzen (zum Beispiel fb_consent mit dem Wert 1).
Conversions API testen
- Test Event Code aus dem Events Manager eintragen und speichern
- Mit Verbindung testen die Zugangsdaten prüfen
- Den Shop aufrufen und im Events Manager im Tab Test-Events die Events beobachten
- Test Event Code wieder leeren