Facebook Pixel (Meta Pixel)
Facebook Pixel (Meta Pixel) für Sylius 2: Browser-Tracking und serverseitige Conversions API (CAPI) mit Event-Deduplizierung, Einstellungen pro Channel und optionaler Klaro-Einwilligung.
Facebook Pixel (Meta Pixel)
Diese Dokumentation beschreibt immer den aktuellen Stand des Plugins.
Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net
Überblick
Facebook-Pixel-Integration (Meta Pixel) für Sylius-2-Shops: Browser-Tracking der E-Commerce-Events plus die serverseitige Meta Conversions API (CAPI), mit automatischer Event-Deduplizierung, Einstellungen pro Channel und optionalem Klaro-Consent-Gating. Sylius-Pendant zum Shopware-Plugin mmd/sw67-facebook-pixel.
Dieses Plugin sendet Daten an Meta (Facebook). Das muss in der Datenschutzerklärung und im Cookie-Banner des Shops angegeben werden. Details: Datenschutz.
Serverseitige (CAPI-)Events sind standardmäßig Fail-Closed: Ohne verifizierbaren Einwilligungsnachweis wird nichts gesendet. Siehe Konfiguration.
graph LR
A["Twig Hook"] --> B["Meta Pixel im Browser"]
A --> C["PixelEventDispatched"]
C --> D{"CAPI aktiv und Einwilligung ok?"}
D -->|"Ja"| E["Messenger: SendCapiEventMessage"]
D -->|"Nein"| F["Nichts gesendet"]
E --> G["Meta Conversions API"]
B --> H["Meta Events Manager"]
G --> H
I["Shop API"] --> J["Headless Client"]
Dokumentation
| Seite | Inhalt |
|---|---|
| Installation und Betrieb | Installation, Update, Deinstallation |
| Konfiguration | Einstellungen pro Channel, Conversions-API-Einrichtung, Praxisbeispiele |
| Storefront-Integration | Twig Hooks, Event-Deduplizierung, Consent-Gating, AddToCart-Timing |
| Shop API / Headless | Endpunkt, Antwortfelder, Abgrenzung zur CAPI |
| Erweiterbarkeit | Eigene Consent-Evidence-Provider, Event PixelEventDispatched, Verschlüsselung des Zugriffstokens |
| Datenschutz | Welche Daten wann an Meta gehen, Hashing, Einwilligung |
| Fehlerbehebung und FAQ | Häufige Probleme, bekannte Einschränkungen, häufige Fragen |
| Technische Details | Ablauf, Plugin-Struktur, Entity, Messaging |
Features
| Feature | Beschreibung |
|---|---|
| Sechs Events | PageView, ViewContent, ViewCategory (Custom Event), AddToCart, InitiateCheckout, Purchase |
| Meta Conversions API | Asynchroner serverseitiger Spiegel für jedes der sechs Events (pro Channel auswählbar); E-Mail und Telefonnummer werden SHA-256-gehasht |
| Event-Deduplizierung | Browser und Server teilen sich eine event_id pro Aktion |
| Pro Channel | Pixel-ID, Event-Auswahl, Brutto-/Netto-Preise und CAPI-Einstellungen gelten je Channel |
| Fail-Closed-CAPI-Consent | Kein verifizierbarer Einwilligungsnachweis, kein serverseitiges Event (Standard) |
| Klaro-Integration | Optional, zur Laufzeit erkannt: gated die Browser-Skripte und liefert den CAPI-Einwilligungsnachweis |
| Dual-Mode | Die Einstellungen, die ein Headless-Client braucht, sind über die Shop API lesbar |
| Verschlüsseltes Zugriffstoken | Das Conversions-API-Token wird nie im Klartext gespeichert |
Anforderungen
| Anforderung | Version | Hinweise |
|---|---|---|
| PHP | ^8.3 | |
| Sylius | ^2.2 | |
| Symfony | ^7.4 | |
| Datenbank | MySQL 8 oder MariaDB | Die Migrationen nutzen die portable Doctrine Schema API |
| Meta-Pixel-ID | - | Aus dem Meta Events Manager; ein Conversions-API-Zugriffstoken ist optional |
Lizenz
Commercial License: Eine Lizenz deckt eine Sylius-Installation ab (alle Channels plus deren Entwicklungs- und Staging-Umgebungen). Weiterverbreitung ist nicht erlaubt; Updates sind für 12 Monate nach Kauf inklusive.
Support
Für Fragen zur Lizenz, technische Fragen oder Bugs: support@markus-michalski.net.