Facebook Pixel (Meta Pixel)
Facebook Pixel (Meta Pixel) for Shopware 6.7: browser tracking of e-commerce events, server-side Conversions API with deduplication and consent via cookie check or Klaro, configurable per sales channel.
Facebook Pixel (Meta Pixel)
This documentation always refers to the latest released version.
Live Demo: Try this and other plugins live — no installation, no risk: demo.markus-michalski.net
Overview
The plugin integrates the Meta Pixel into the Shopware storefront and reports e-commerce events to Meta: page views, product and category views, cart, checkout and orders. It can additionally send the same events server-side through the Meta Conversions API. Settings apply per sales channel.
Privacy: The plugin sends data to Meta. Without further settings, the pixel loads without consent. Switch on the cookie check or the Klaro integration before you go live. With the Conversions API, the IP address and user agent go to Meta unhashed, only email and phone number are hashed.
graph LR
A["Storefront page"] --> B["Event with eventID"]
B --> C{"Consent"}
C -->|"present"| D["Meta Pixel in the browser"]
B --> E{"CAPI active, event selected, consent"}
E -->|"yes"| F["Message queue"]
F --> G["Meta Conversions API"]
D --> H["Meta Events Manager"]
G --> H
Documentation
| Page | Content |
|---|---|
| Installation | Installation via Store, Composer or ZIP, message consumer, update, uninstall |
| Configuration | All settings, connection test, practical examples |
| Events and data | Which events fire when and which fields they transmit |
| Consent and cookies | Cookie check, Klaro integration, automatically created Klaro service |
| Conversions API | Setup, conditions for sending, deduplication, failure behaviour |
| Privacy | Exactly which data goes to Meta, what is hashed and what is not |
| Troubleshooting | Typical problems, checks, known limitations |
| Technical details | Flow, plugin structure, admin route, lifecycle |
Features
| Feature | Description |
|---|---|
| E-commerce events | PageView, ViewContent, ViewCategory, AddToCart, InitiateCheckout and Purchase, individually switchable (except PageView) |
| Conversions API | Server-side delivery through the message queue, with event selection and Test Event Code |
| Deduplication | Browser and server use the same event ID |
| Connection test | Button in the configuration that validates Pixel ID and access token |
| Consent | Own cookie check or Klaro, applied equally to the browser and the Conversions API |
| Gross/net prices | Switchable for B2C and B2B |
| Klaro service | Created automatically on activation when MmdKlaroConsent is installed |
| Multi-sales-channel | Configuration per sales channel |
Requirements
| Requirement | Version | Notes |
|---|---|---|
| Shopware | ~6.7.0 | Composer package mmd/sw67-facebook-pixel |
| PHP | 8.2 or higher | |
| MmdKlaroConsent | optional | Only for the Klaro integration |
| License | Commercial | One license per installation |
License
Commercial license, single-installation license including:
- All sales channels
- Development and staging environments
- 12 months of free updates
See the LICENSE file for the full terms.
Support
For questions and support:
Markus Michalski
Email: support@markus-michalski.net