Multitracking Pro mit Facebook Pixel, Gtag und Reddit Ads


Installationsanleitung, Dokumentation und FAQs zum Shopware Plugin

Installationsanleitung

Bitte schaue in den Dokus der einzelnen Plugins, um das Plugin zu konfigurieren:

Auswahl der Tracking Anbieter

Das Plugin bietet drei separate Tracking-Anbieter, die jeweils unabhängig voneinander per In App Käufen erworben und konfiguriert werden können. Alle Einstellungen lassen sich verkaufskanal-spezifisch oder für alle Verkaufskanäle gleichzeitig vornehmen.

Meta Pixel

Dieser Anbieter muss separat über einen In-App-Kauf freigeschaltet werden.

  • Meta Pixel aktivieren – Schalter zum Aktivieren/Deaktivieren des Meta Pixels
  • Meta Pixel ID – Eingabe der Meta Pixel ID
  • Conversion API Access Token – Token für die serverseitige Übertragung via Conversion API
  • Conversion API aktivieren – Aktiviert das serverseitige Event-Tracking über die Facebook Conversion API, um die Datenqualität zu verbessern
  • Benutzerdaten in Conversion API deaktivieren – Unterdrückt die Übermittlung von Nutzerdaten an die Conversion API
  • Asynchrone Conversion API aktivieren – Nutzt den Symfony Messenger für die asynchrone Verarbeitung der API-Aufrufe
  • Conversion API Logging aktivieren – Protokolliert die Conversion-API-Aufrufe für Debugging-Zwecke
  • Debug Modus aktivieren – Aktiviert den Debug-Modus für das Pixel
  • Meta Automatic Configuration (Auto-Event-Erkennung) aktivieren – Default aus. Nur zum Debugging mit der Meta Pixel Helper Browser-Extension aktivieren. Im aktiven Zustand erlaubt das Plugin Metas Auto-Event-Detection (Auto-Purchase aus Schema.org-Preisen, SubscribedButtonClick, Auto-Advanced-Matching) — diese Events können nicht gegen die Conversion API dedupliziert werden und können Conversion-Werte aufblähen. Im Produktivbetrieb daher aus lassen.
  • Kundengruppen vom Tracking ausschließen – Bestimmte Kundengruppen können vom Tracking ausgenommen werden
  • ViewCategory-Ereignis auf Kategorie Root Ebene nicht auslösen – Verhindert das Feuern des ViewCategory-Events auf der obersten Kategorieebene

Consent Manager:

  • Consent Manager – Auswahl des verwendeten Cookie-Consent-Managers (Standard: Shopware Cookie Consent Manager)
  • Experten Modus – Eigenes Consent Manager Data Attribut – Ermöglicht die Angabe eines eigenen Data-Attributs für den Consent Manager
  • Cookie-Kategorie – Zuordnung des Meta Pixels zu einer Cookie-Kategorie (Standard: Statistik)

Hier findest du eine detailliertere Dokumentation für die Meta Pixel Erweiterung:

Facebook Pixel Event Tracking & Conversion API

Google Analytics/ Google Tag Manager

Dieser Anbieter muss separat über einen In-App-Kauf freigeschaltet werden.

  • Google Tracking aktivieren – Schalter zum Aktivieren/Deaktivieren des Google Trackings
  • Tracking Integration – Auswahl der Integrationsmethode (Standard: Google Tag Manager)
  • Google Analytics Measurement ID (G-XXXXXX) – Eingabe der GA4 Measurement ID
  • GTM Container ID (GTM-XXXXXX) – Eingabe der Google Tag Manager Container ID
  • Google Ads Conversion Tracking aktivieren – Aktiviert das Conversion Tracking für Google Ads
  • Erweiterte Conversions (Advanced Data) aktivieren – Übermittelt erweiterte Conversion-Daten an Google Ads
  • Google Ads Conversion ID (AW-XXXXXX) – Eingabe der Conversion ID für Google Ads
  • Google Ads Conversion Label – Eingabe des Conversion Labels für Google Ads
  • Debug Modus aktivieren – Aktiviert den Debug-Modus
  • Preisübertragungsmodus – Legt fest, wie Preise an Google übermittelt werden (Standard: Bruttopreise)
  • Geschäftsbereich – Festlegung des Business-Segments (Standard: retail)
  • Server-Side Tracking aktivieren – Aktiviert das serverseitige Tracking über eine eigene GTM-Server-Container-URL
  • Server Container URL – URL des serverseitigen GTM-Containers
  • Preise für Kundengruppen ausblenden – Bestimmte Kundengruppen werden bei der Preisübermittlung ausgeblendet
  • Kundengruppen vom Tracking ausschließen – Bestimmte Kundengruppen können vom Tracking ausgenommen werden

Consent Manager:

  • Consent-freien Container als technisch notwendig markieren – Kennzeichnet den consent-freien Container als technisch notwendig
  • Consent Manager – Auswahl des Cookie-Consent-Managers (Standard: Shopware Cookie Consent Manager)
  • Experten Modus – Eigenes Consent Manager Data Attribut – Eigenes Data-Attribut für den Consent Manager
  • Consent Attribut für Analytics – Benutzerdefiniertes Consent-Attribut für die Analytics-Kategorie
  • Consent Attribut für Marketing – Benutzerdefiniertes Consent-Attribut für die Marketing-Kategorie
  • Cookie-Kategorie – Zuordnung zu einer Cookie-Kategorie (Standard: Statistik)
  • Eigenes GTM Snippet (nach Consent) – JavaScript-Snippet, das nach Erteilung der Einwilligung eingefügt wird
  • GTM Consent-freies Snippet (immer geladen) – JavaScript-Snippet, das ohne Einwilligungsanforderung geladen wird
  • Consent-freie GTM Container ID – Container ID für den consent-freien GTM-Container

Eigene Snippets (Head & Body) — neu in 2.3.0

Neu in Version 2.3.0: In der Karte „Eigene Snippets“ bindest du provider-übergreifend eigenen Code in die Storefront ein:

  • „Eigener Code im Head“ — wird unverändert im Head-Bereich jeder Storefront-Seite ausgegeben (z. B. Server-Side-GTM-Container, fremde Consent-Tools, alternative Tracker). Die Script-Tags gibst du selbst an.
  • „Eigener Code nach Body“ — wird direkt nach dem öffnenden Body-Tag ausgegeben (z. B. GTM-Noscript-Fallback).

Wichtig: Der Head-Code wird ohne Consent-Steuerung geladen — die ggf. erforderliche Einwilligung (z. B. DSGVO) liegt in deiner Verantwortung. Fehlerhafter Code kann die Storefront beschädigen.

Weitere Neuerungen der Version 2.3.0 – Lead-Conversion-Tracking (generate_lead), GTM-Vorschaumodus und Coupon-Mapping für Staffel-/UVP-Preise – betreffen den Google-Provider. Die Einrichtung findest du in der Google-Tag-Manager-Doku:

Zusätzlich erfasst der Google-Provider automatisch UTM-Parameter und Werbe-Klick-IDs (gclid, fbclid, msclkid u. a.) als Quellen-Tracking – die Quelle jeder Bestellung ist dadurch direkt in der Shopware-Bestellliste sichtbar. Details dazu ebenfalls in der Google-Tag-Manager-Doku.

Hier findest du eine detailliertere Dokumentation für die Google Tag Manager, Google Analytics 4 Erweiterung:

Google Tag Manager, Google Analytics 4 & Ads Tracking

Reddit Pixel

Dieser Anbieter muss separat über einen In-App-Kauf freigeschaltet werden.

  • Reddit Pixel aktivieren – Schalter zum Aktivieren/Deaktivieren des Reddit Pixels
  • Reddit Pixel ID – Eingabe der Reddit Pixel ID
  • Conversion API Access Token – Token für die serverseitige Übertragung
  • Conversion API aktivieren – Aktiviert das serverseitige Event-Tracking
  • Benutzerdaten in Conversion API deaktivieren – Unterdrückt die Übermittlung von Nutzerdaten
  • Asynchrone Conversion API aktivieren – Asynchrone Verarbeitung via Symfony Messenger
  • Conversion API Logging aktivieren – Protokollierung der API-Aufrufe
  • Debug Modus aktivieren – Aktiviert den Debug-Modus
  • Kundengruppen vom Tracking ausschließen – Bestimmte Kundengruppen können vom Tracking ausgenommen werden
  • ViewCategory-Ereignis auf Kategorie Root Ebene nicht auslösen – Verhindert das Feuern des ViewCategory-Events auf der obersten Kategorieebene

Consent Manager:

  • Consent Manager – Auswahl des Cookie-Consent-Managers (Standard: Shopware Cookie Consent Manager)
  • Experten Modus – Eigenes Consent Manager Data Attribut – Eigenes Data-Attribut für den Consent Manager
  • Cookie-Kategorie – Zuordnung zu einer Cookie-Kategorie (Standard: Statistik)

Hier findest du eine detailliertere Dokumentation für die Meta Pixel Erweiterung:

Reddit Pixel Event Tracking & Conversion API

Support

Bei Fragen oder Problemen stehen wir zur Verfügung: