Facebook Pixel: Installation

Facebook Pixel (Meta Pixel) für Shopware 6.7 installieren: Shopware Store, Composer oder ZIP-Upload, erste Schritte nach der Aktivierung, Message-Consumer für die Conversions API, Update und Deinstallation.

English Version

Zurück zur Übersicht

Facebook Pixel: Installation

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

Voraussetzungen

Anforderung	Version	Hinweise
Shopware	~6.7.0	Composer-Paket `mmd/sw67-facebook-pixel`, Plugin-Klasse `MmdFacebookPixel`
PHP	ab 8.2
Message-Consumer	läuft dauerhaft	Nur für die Conversions API nötig, siehe unten
Ausgehende Verbindung	`graph.facebook.com`	Nur für die Conversions API und den Verbindungstest nötig
MmdKlaroConsent	optional	Nur für die Klaro-Anbindung, siehe Consent und Cookies

Installation

Via Shopware Store (empfohlen)

Plugin im Shopware Store erwerben
Im Shopware Admin unter Erweiterungen > Meine Erweiterungen das Plugin installieren und aktivieren
Cache leeren

Via Composer

1. Privates Repository hinzufügen

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

Hinweis: Die Repository-Zugangsdaten werden nach dem Lizenzkauf bereitgestellt.

2. Plugin installieren

composer require mmd/sw67-facebook-pixel

3. Plugin aktivieren

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

Via ZIP-Upload

ZIP-Datei im Shopware Admin unter Erweiterungen > Meine Erweiterungen hochladen
Plugin installieren und aktivieren
Cache leeren

Empfehlung: Shopware Store oder Composer bevorzugen, dann sind Updates einfacher.

Nach der Installation

Das Plugin ist nach der Aktivierung noch inaktiv, weil der Hauptschalter Tracking aktivieren standardmäßig ausgeschaltet ist.

Plugin-Konfiguration öffnen und die Pixel ID eintragen
Tracking aktivieren einschalten
Entscheiden, wie die Einwilligung der Besucher eingeholt wird (siehe Consent und Cookies)
Optional die Conversions API einrichten (siehe Conversions API)

Alle Einstellungen findest du auf der Seite Konfiguration.

Datenschutz: Ohne weitere Einstellung lädt das Plugin das Pixel sofort beim ersten Seitenaufruf, auch ohne Einwilligung. Aktiviere vor dem Livegang die Cookie-Einwilligung oder die Klaro-Anbindung.

Message-Consumer (nur Conversions API)

Die serverseitigen Events der Conversions API werden als Nachrichten in die Shopware-Message-Queue gelegt und von einem Consumer abgearbeitet. Ohne laufenden Consumer verlässt kein serverseitiges Event den Server.

bin/console messenger:consume async

Für den Produktivbetrieb richtest du dafür einen Supervisor oder systemd-Dienst ein. Details stehen in der Shopware-Dokumentation zur Message Queue.

Update

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

Deinstallation

Beim Deinstallieren über die Erweiterungsverwaltung kannst du wählen, ob die Daten des Plugins behalten werden.

Auswahl	Was passiert
Daten behalten	Es wird nichts gelöscht. Konfiguration und Klaro-Service bleiben erhalten.
Daten nicht behalten	Alle Einstellungen `MmdFacebookPixel.config.*` werden aus der Tabelle `system_config` gelöscht. Existiert der Klaro-Service `facebook-pixel`, wird er samt Übersetzungen entfernt.

Das Plugin legt keine eigenen Datenbanktabellen an.