Facebook Pixel (Meta Pixel) | Tracking & Conversions API

von Markus Michalski

Bewertung: keine Bewertung ( Bewertung schreiben )

Downloads: <10

Facebook Pixel (Meta Pixel) für Shopware 6.7 mit allen E-Commerce-Events, serverseitiger Conversions API (CAPI), Event-Deduplizierung und DSGVO-konformer Klaro Consent Integration.

Jährlich 3,40 €* /Monat 48,00 € * 40,80 €* /Jahr 15% Rabatt Im Vergleich zum regulären Monatspreis

Monatlich 4,00 €* /Monat Monatlich kündbar

Kompatibel mit:

6.7.0.0 - 6.7.10.2

Inklusive:

Kostenloser Probemonat

Das Abonnement beginnt mit einem kostenlosen Probemonat, in dem das Abonnement jederzeit gekündigt werden kann.

Alle Updates

Während des Abonnements sind alle veröffentlichten Updates kostenlos enthalten.

Unterstützung durch den Extension Partner

Falls du Fragen oder Probleme mit der Erweiterung hast, kannst du während des Abonnements jederzeit den Extension Partner um Hilfe bitten.

Beschreibung

Highlights

1. Vollständiges E-Commerce-Tracking: PageView, ViewContent, AddToCart, Checkout & Purchase
2. Meta Conversions API (CAPI) — serverseitiges Tracking für bessere Datenqualität
3. DSGVO-konform mit Klaro Consent Manager Integration und Cookie-Consent-Prüfung
4. Asynchrone CAPI-Verarbeitung über Symfony Messenger — kein Performance-Verlust
5. Multi-Sales-Channel mit separater Konfiguration pro Verkaufskanal

Features

- PageView-Tracking auf allen Storefront-Seiten
- ViewContent-Event auf Produktdetailseiten mit Produktdaten
- ViewCategory-Event auf Kategorieseiten (Custom Event)
- AddToCart-Event beim Hinzufügen zum Warenkorb
- InitiateCheckout-Event auf der Checkout-Bestätigungsseite

- Purchase-Event beim Bestellabschluss mit vollständigen Bestelldaten
- Meta Conversions API (CAPI) — serverseitiges Event-Tracking
- Automatische Event-Deduplizierung zwischen Client und Server via event_id
- Asynchrone CAPI-Verarbeitung über Symfony Messenger
- SHA-256 PII-Hashing für DSGVO-konforme Datenübertragung (CAPI)
- Klaro Consent Manager Integration für DSGVO-konformes Tracking
- Integrierte Cookie-Consent-Prüfung als Alternative zu Klaro
- Brutto/Netto-Preiskonfiguration für B2C und B2B
- Granulare Event-Steuerung — jedes Event einzeln schaltbar
- Multi-Sales-Channel mit separater Konfiguration pro Kanal

Mehr anzeigen Weniger anzeigen

Über die Erweiterung

Warum dieses Plugin?

Wer Meta Ads (Facebook/Instagram) schaltet, braucht sauberes Conversion-Tracking. Adblocker, iOS-Einschränkungen und Browser-Restriktionen sorgen dafür, dass Client-seitiges Tracking allein nicht mehr ausreicht. Dieses Plugin löst das Problem mit Metas empfohlenem Redundant Setup: Client-Side Pixel plus serverseitige Conversions API — für maximale Datenqualität und bessere Ad-Attribution.

Kernfunktionen

PageView — Automatisches Tracking auf allen Storefront-Seiten
ViewContent — Produktdetailseiten mit Produkt-ID, Name, Preis und Währung
ViewCategory — Kategorieseiten-Tracking (Custom Event)
AddToCart — Event beim Hinzufügen zum Warenkorb
InitiateCheckout — Checkout-Bestätigungsseite
Purchase — Bestellabschluss mit Bestellwert, Produkt-IDs und Artikelanzahl
Meta Conversions API (CAPI) — Serverseitiges Tracking parallel zum Client-Side Pixel
Event-Deduplizierung — Automatische Deduplizierung über event_id zwischen Client und Server
Brutto/Netto-Preise — Konfigurierbar für B2C- und B2B-Shops
Granulare Event-Steuerung — Jedes Event einzeln aktivierbar/deaktivierbar

So funktioniert es

Nach der Installation konfigurierst du lediglich deine Pixel ID und aktivierst das Tracking. Optional schaltest du die Conversions API dazu — dafür brauchst du einen Access Token aus dem Meta Events Manager. CAPI Events werden asynchron über Symfony Messenger verarbeitet und belasten den Seitenaufbau nicht.

Für die DSGVO-Konformität stehen zwei Optionen bereit: Die integrierte Cookie-Consent-Prüfung oder die Klaro Consent Manager Integration (erfordert das MmdKlaroConsent Plugin). So wird erst nach expliziter Einwilligung getrackt.

Voraussetzungen

Shopware 6.7.x
PHP 8.2 oder höher
Facebook Pixel ID (aus dem Meta Events Manager)
Für CAPI: Access Token aus dem Meta Events Manager
Für CAPI: Laufender Symfony Messenger Consumer (bin/console messenger:consume async)
Optional: MmdKlaroConsent Plugin für Klaro Consent Integration

Anwendungsfälle

Meta Ads Retargeting — Besucher mit dynamischen Produktanzeigen erneut ansprechen
Conversion-Tracking — Käufe, Warenkörbe und Checkout-Starts messen
Custom Audiences — Zielgruppen auf Basis von Shop-Interaktionen erstellen
Lookalike Audiences — Neue Kunden finden, die den besten Käufern ähneln
ROAS-Optimierung — Ad-Performance mit vollständigen Conversion-Daten verbessern
iOS 14+ Compliance — Serverseitige Events ergänzen eingeschränktes Browser-Tracking

Wichtige Hinweise

Facebook Pixel sendet Daten an Meta (Facebook). Dies muss in der Datenschutzerklärung und im Cookie-Consent-Banner offengelegt werden. Ich empfehle dringend die Nutzung der Klaro Integration oder der integrierten Consent-Prüfung zur DSGVO-Konformität.

Die Conversions API erfordert einen laufenden Symfony Messenger Consumer. Für den Produktivbetrieb sollte dieser über Supervisor oder systemd dauerhaft betrieben werden.

Dokumentation: Ausführliche Dokumentation im Wiki

Details

Verfügbar in: Englisch, Deutsch
Zuletzt aktualisiert: 1. Juni 2026
Veröffentlicht: 5. Juni 2026
Version: 1.2.0
Kategorie: Social Commerce

Ressourcen

Bewertungen (0)

Bewertung schreiben

Wenn du diese Erweiterung heruntergeladen hast, kannst du diese im Shopware Account bewerten.

Bewertung schreiben

Keine Bewertungen gefunden.

Über den Extension Partner

Markus Michalski

Alle Erweiterungen anzeigen

Partner Status

Shopware
Extension Partner

Details

Partner seit: 2026
Erweiterungen: 3

Support

Land: Germany
Spricht: Deutsch, Englisch
Reaktionszeit: Sehr schnell

Deutsch

Frontend:: Zur Demo

Admin:: Zur Demo
Name:: admin
Passwort:: shopware

1.2.0 30. April 2026

## [1.2.0] – 30.04.2026

### Hinzugefügt

- Schaltfläche zum Testen der API-Verbindung hinzugefügt

### Behoben

- Alle Plugin-Daten bei der Deinstallation entfernen, wenn „Alle Daten löschen“ ausgewählt wird

1.1.0 20. März 2026

## [1.1.0] - 2026-03-20

### Hinzugefügt
- Klaro-Service wird bei Plugin-Aktivierung automatisch erstellt

## [1.0.2] - 2026-02-25

### Hinzugefügt
- Meta Conversions API (CAPI) serverseitiges Event-Tracking hinzugefügt
- Facebook Pixel Tracking mit CAPI-fähiger Architektur implementiert

### Geändert
- GitHub Actions Workflow für Tests, Coverage und statische Analyse hinzugefügt
- Platzhalter-Einträge in CHANGELOG.md bereinigt
- CLAUDE.md zur .gitignore hinzugefügt
- Erstes Release vorbereitet
- Changelog für unveröffentlichte v1.0.0 konsolidiert
- README, kommerzielle Lizenz und Lizenz-Header für Testdateien hinzugefügt
- Plugin-Icon (SVG + PNG) hinzugefügt und .gitignore aktualisiert
- .gitignore um weitere Cache- und temporäre Dateien ergänzt
- CHANGELOG.md für v1.0.0 Release hinzugefügt
- Initiale Changelog-Datei hinzugefügt
- Initiales Projekt-Setup

### Behoben
- Leere Sektionen für v1.0.1 aus Changelog entfernt
- Korrektes Shopware config.xml Optionsformat für Multi-Select verwendet
- client_ip_address und client_user_agent werden in CAPI ungehasht gesendet
- CAPI-Nachrichten asynchron über Shopware Message Queue verarbeitet

### Sicherheit
- Alle Ergebnisse des Sicherheitsaudits vom 20.02.2026 umgesetzt

## [1.0.1] - 2026-02-11

### Behoben
- Korrektes Shopware config.xml Optionsformat für Multi-Select verwendet
- client_ip_address und client_user_agent werden in CAPI ungehasht gesendet

## [1.0.0] - 2026-02-11

### Hinzugefügt
- Meta Conversions API (CAPI) serverseitiges Event-Tracking hinzugefügt
- Facebook Pixel Tracking mit CAPI-fähiger Architektur implementiert

### Geändert
- Erstes Release vorbereitet
- Changelog für unveröffentlichte v1.0.0 konsolidiert
- README, kommerzielle Lizenz und Lizenz-Header für Testdateien hinzugefügt
- Plugin-Icon (SVG + PNG) hinzugefügt und .gitignore aktualisiert
- .gitignore um weitere Cache- und temporäre Dateien ergänzt
- CHANGELOG.md für v1.0.0 Release hinzugefügt
- Initiale Changelog-Datei hinzugefügt
- Initiales Projekt-Setup

### Behoben
- CAPI-Nachrichten asynchron über Shopware Message Queue verarbeitet

### Hinzugefügt
- Facebook Pixel (Meta Pixel) Basis-Code-Einbindung mit `fbq('init')` und `PageView`-Tracking
- `ViewContent`-Event auf Produktdetailseiten (content_name, content_ids, value, currency)
- `ViewCategory`-Custom-Event auf Kategorie-/Navigationsseiten (content_name, content_category)
- `AddToCart`-Event auf der Warenkorbseite für alle Produktpositionen
- `InitiateCheckout`-Event auf der Bestellbestätigungsseite
- `Purchase`-Event bei Bestellabschluss (content_ids, value, num_items, order_id)
- Pro Verkaufskanal konfigurierbar (Pixel-ID, 6 individuelle Tracking-Schalter)
- Brutto-/Netto-Umschaltung für B2B-Shops
- Klaro Consent Manager Integration (`type="text/plain"` + `data-name`-Pattern)
- Migration erstellt Klaro-Cookie-Service-Eintrag (Zweck: Marketing, Cookies: _fbp, _fbc, fr)
- ConsentChecker mit Unterstützung der Marketing-Einwilligungsgruppe
- Plugin-Konfiguration mit 3 Karten (Pixel-Optionen, Tracking-Optionen, Klaro-Integration)
- Deutsche und englische Übersetzungen für Konfigurationslabels
- Meta Conversions API (CAPI) serverseitiges Event-Tracking (redundantes Setup mit event_id-Deduplizierung)
- Asynchroner CAPI-Versand über Symfony Messenger (`AsyncMessageInterface`)
- DSGVO-konformes PII-Hashing (SHA-256) für E-Mail, Telefon, IP, User-Agent
- Ereignisbasierte CAPI-Auswahl (Auswahl, welche Events serverseitig gesendet werden)
- Test-Event-Code-Unterstützung zum Debugging im Meta Events Manager
- CAPI-Konfigurationskarte (capiEnabled, capiAccessToken, capiTestEventCode, capiEventSelection)
- Extraktion von Kunden-E-Mail und -Telefonnummer für Purchase- und InitiateCheckout-Events

### Technisch
- CAPI-Architektur: Event Value Objects mit `PixelEventRendererInterface`
- `event_id` (UUID) pro Event zur Conversions API-Deduplizierung
- Zentraler `EventDataExtractor` für alle Shopware-Entity-zu-Event-Konvertierungen
- `PixelJsRenderer` als austauschbarer v1-Renderer
- `PixelEventDispatched`-internes Event als Brücke zwischen Subscribern und CAPI-System
- `ConversionsApiClient` für `graph.facebook.com/v21.0` mit Fire-and-Forget-Fehlerbehandlung
- `PiiHasher` mit SHA-256-Hashing für alle PII-Felder
- `ServerEventContext` / `ServerEventContextFactory` zur Erfassung des Request-Kontexts
- `SendCapiEventMessage` / `SendCapiEventHandler` für asynchrone Message-Queue-Verarbeitung
- `CapiEventListener` zur Weiterleitung von Events an die Message Queue mit unabhängiger Einwilligungsbehandlung
- 139 Unit-Tests, 369 Assertions, PHPStan Level 8
- Strikte Typen, durchgängig `final readonly class`

### Sicherheit
- Pixel-ID-Validierung: ausschließlich `ctype_digit()` (keine beliebigen Zeichenketten)
- XSS-Prävention: `json_encode()` mit `JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP`
- Keine Benutzereingaben werden direkt in JavaScript gerendert
- Ausschließlich HTTPS für `connect.facebook.net`
- Einwilligungs-Allowlist mit expliziter Wertvalidierung
- PII wird niemals im Klartext geloggt (CAPI-Fehlerlogs schließen Response-Body aus)
- Access Token wird nur serverseitig verwendet, niemals dem Client exponiert