Deutsche Version

Back to overview

Facebook Pixel: Installation

Live Demo: Try this and other plugins live — no installation, no risk: demo.markus-michalski.net

Requirements

Installation

Via Shopware Store (recommended)

1. Purchase the plugin in the Shopware Store
2. In the Shopware Admin under Extensions > My extensions, install and activate the plugin
3. Clear the cache

Via Composer

1. Add the private repository

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://packeton.markus-michalski.net"
        }
    ]
}

Note: The repository credentials are provided after you purchase a license.

2. Install the plugin

composer require mmd/sw67-facebook-pixel

3. Activate the plugin

bin/console plugin:refresh
bin/console plugin:install --activate MmdFacebookPixel
bin/console cache:clear

Via ZIP upload

1. Upload the ZIP file in the Shopware Admin under Extensions > My extensions
2. Install and activate the plugin
3. Clear the cache

Recommendation: Prefer the Shopware Store or Composer, which make updates easier.

After installation

The plugin is still inactive after activation, because the master switch Enable Tracking is off by default.

1. Open the plugin configuration and enter your Pixel ID
2. Switch on Enable Tracking
3. Decide how visitors give their consent (see Consent and cookies)
4. Optionally set up the Conversions API (see Conversions API)

All settings are described on the Configuration page.

Privacy: Without further settings the plugin loads the pixel on the very first page view, even without consent. Enable the cookie consent check or the Klaro integration before you go live.

Message consumer (Conversions API only)

Server-side Conversions API events are put into the Shopware message queue and processed by a consumer. Without a running consumer, no server-side event leaves your server.

bin/console messenger:consume async

For production, set up a supervisor or systemd service for it. See the Shopware documentation on the message queue for details.

Update

composer update mmd/sw67-facebook-pixel
bin/console cache:clear

Uninstall

When you uninstall via the extension manager, you can choose whether to keep the plugin's data.

The plugin does not create any database tables of its own.