Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net
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.
| 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. |
| 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.
| 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.
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.
Mmd-FacebookPixel-Plugin/Test als User-Agent.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. |
| 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.
| 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 |
| 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).