Facebook Pixel Event Tracking ＆ Conversion API

Installationsanleitung, Dokumentation und FAQs zum Shopware Plugin

1. Installation und Basis-Aktivierung

  1. Lade die App in deiner Shopware Administration unter Erweiterungen / Apps hoch und installiere sie.
  2. Gehe in die Konfiguration der App.
  3. Füge deine benötigte Facebook Pixel ID in das entsprechende Feld ein.
  4. Aktiviere die App.

2. Einrichten des Conversion Access Tokens (für die Conversion API)

Um die Facebook Conversions API für zuverlässigeres, serverseitiges Tracking nutzen zu können, benötigst du einen Access Token.

  1. Generiere den Facebook Pixel Conversion Access Token. Die aktuellste und detaillierteste Anleitung zur Generierung des Tokens findest du direkt in der Facebook Developer Dokumentation: https://developers.facebook.com/docs/marketing-api/conversions-api/get-started/?locale=de_DE#use-your-own-app
  2. Kopiere den generierten Access Token und füge ihn in das Feld Conversion Access Token in der Plugin-Konfiguration ein.

3. Integration mit deinem externen Cookie Consent Manager (Expertenmodus)

Je nachdem, welchen externen Cookie Consent Manager (CCM) du verwendest, muss der Wert des **data-Attributs** korrekt konfiguriert werden, damit das Facebook Pixel erst nach Zustimmung geladen wird.

  • Wenn du das Feld leer lässt, verwenden wir die Standardwerte:
    • Für User Centrics: Der Standardwert ist „Facebook Pixel“.
    • Für Cookie Bot: Der Standardwert ist „marketing“.
  • Für eine manuelle Konfiguration (Expertenmodus): Folge der spezifischen Anleitung für deinen CCM, um den korrekten Wert zu ermitteln und trage diesen in das Expertenfeld ein.

4. Opt-out-Link für Facebook Pixel bereitstellen

Um deinen Nutzern die Möglichkeit zu geben, das Tracking durch das Facebook Pixel gezielt zu deaktivieren (Opt-out), unterstützt unser Plugin einen einfachen HTML-Code.

Binde folgenden HTML-Code auf einer beliebigen Seite deines Shops ein (z.B. in den Datenschutzhinweisen):

<a onclick="javascript:fbqOptout();" >Hier Facebook Pixel Tracking für diese Website abschalten</a>

Nach dem Klick auf diesen Link wird das Tracking für den Nutzer deaktiviert.

FAQs

Ja, unser Plugin bietet die Möglichkeit, die Conversion API zu nutzen.

Dies kann bis zu 48 Stunden dauern (bitte checken, ob der Wert passt)

Die shopware.yaml, oder besser eine z-shopware.yaml im /config/packages Ordner (dort wo auch der Admin Worker ausgeschaltet wird) erweitern:

    messenger:
        routing_overwrite:
‘Biloba\AdFacebookPixel\Core\Messages\ConversionApiMessage’: low_priority

Dies verschiebt die Conversion Nachrichten der Facebook Pixel Erweiterung in die ”low_priority queue” der ”messenger_messages” Tabelle der Datenbank