Facebook Pixel: Events und Daten

Welche Events das Facebook Pixel Plugin für Shopware 6.7 auslöst, wann sie feuern und welche Daten sie übertragen: PageView, ViewContent, ViewCategory, AddToCart, InitiateCheckout und Purchase.

English Version

Zurück zur Übersicht

Facebook Pixel: Events und Daten

Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net

Übersicht

Event	Wann	Schalter	Art
PageView	Jede gerenderte Storefront-Seite	keiner (immer aktiv)	Standard-Event
ViewContent	Produktdetailseite	Artikel-Aufrufe tracken	Standard-Event
ViewCategory	Kategorieseite	Kategorien tracken	Custom Event (`trackCustom`)
AddToCart	Warenkorbseite	Warenkorb-Aktionen tracken	Standard-Event
InitiateCheckout	Checkout-Bestätigungsseite	Checkout tracken	Standard-Event
Purchase	Bestellabschlussseite	Bestellungen tracken	Standard-Event

Voraussetzung für alle Events: Tracking aktivieren ist an und die Pixel ID ist gültig (nur Ziffern). Ob die Events im Browser tatsächlich laufen, entscheidet die Einwilligung, siehe Consent und Cookies.

Gemeinsame Regeln

Event-ID: Jedes Event bekommt eine zufällige, 32-stellige Hex-ID. Sie steht im Browser als letztes Argument jedes fbq-Aufrufs ({eventID: '...'}), bei PageView als drittes, sonst als viertes. Bei der Conversions API ist sie die event_id. Meta dedupliziert Browser- und Server-Event darüber.
Währung: ISO-Code der Währung des aktuellen Kontexts, zum Beispiel EUR.
Produktkennung: Als content_ids wird die Produktnummer (SKU) gesendet. Fehlt sie im Positions-Payload, wird die ID der Warenkorb- oder Bestellposition verwendet.
Preise: Mit Brutto-Preise tracken werden Preise inklusive MwSt. übertragen, ohne die Option Netto-Preise.
Positionen: Warenkorb und Bestellung zählen nur Positionen vom Typ Produkt. Gutscheine, Versandkosten oder andere Positionen fließen nicht in content_ids und num_items ein.

PageView

Wird auf jeder Storefront-Seite zusammen mit dem Pixel-Basiscode ausgegeben. Er trägt keine Daten außer der Event-ID.

fbq('track', 'PageView', {eventID: '...'});

ViewContent

Feld	Inhalt
`content_name`	Produktname in der Sprache des Kontexts
`content_ids`	Liste mit der Produktnummer
`content_type`	`product`
`value`	Stückpreis des Produkts (brutto oder netto)
`currency`	Währungscode

ViewCategory

Ein Custom Event, das Meta in der Standard-Auswertung nicht als Standard-Event kennt. Es hat kein content_type.

Feld	Inhalt
`content_name`	Name der Kategorie
`content_category`	Name der Kategorie. Der Code bildet den Wert aus der Kategorie und ihren Elternkategorien (getrennt durch `>`), lädt die Kategorie aber ohne Elternzuordnung. Gesendet wird deshalb in der Regel nur der eigene Name, ohne übergeordnete Kategorien.

fbq('trackCustom', 'ViewCategory', {content_name: '...', content_category: '...'}, {eventID: '...'});

AddToCart

Das Event hängt an der Warenkorbseite, nicht an der Aktion „In den Warenkorb“. Es feuert bei jedem Aufruf der Warenkorbseite.

Bei jedem Aufruf der Warenkorbseite wird für jede Produktposition im Warenkorb ein eigenes AddToCart-Event gesendet, mit eigener Event-ID. Das gilt für alle Produkte, die gerade im Warenkorb liegen, nicht nur für das zuletzt hinzugefügte. Ein erneutes Laden der Seite löst die Events erneut aus. Wer direkt aus dem Offcanvas-Warenkorb zur Kasse geht, ohne die Warenkorbseite zu öffnen, löst kein AddToCart aus.

Feld	Inhalt
`content_ids`	Liste mit der Produktnummer der Position
`content_name`	Bezeichnung der Position
`content_type`	`product`
`value`	Stückpreis mal Menge
`currency`	Währungscode
`num_items`	Menge der Position

InitiateCheckout

Wird auf der Checkout-Bestätigungsseite einmal ausgelöst. Es hat kein content_type.

Feld	Inhalt
`content_ids`	Produktnummern aller Produktpositionen im Warenkorb
`num_items`	Summe der Mengen aller Produktpositionen
`value`	Gesamtsumme des Warenkorbs (brutto) oder Nettosumme
`currency`	Währungscode

Purchase

Wird auf der Bestellabschlussseite ausgelöst.

Feld	Inhalt
`content_ids`	Produktnummern aller Produktpositionen der Bestellung
`content_type`	`product`
`value`	Gesamtbetrag der Bestellung (brutto) oder Nettobetrag
`currency`	Währungscode
`num_items`	Summe der Mengen aller Produktpositionen
`order_id`	Bestellnummer, ersatzweise die interne ID der Bestellung

Welche Daten gehen noch mit?

Die Felder oben sind die Event-Daten. Was zusätzlich an Meta geht, besonders bei der Conversions API (IP-Adresse, User-Agent, gehashte E-Mail und Telefonnummer), steht auf der Seite Datenschutz.