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:
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:
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:
Support
Bei Fragen oder Problemen stehen wir zur Verfügung:
- Support-Anfrage: biloba-it.de/shopware-plugin-support
- E-Mail: support@biloba-it.de
- Telefon: +49 (0) 711 – 13633800
Keine Lösung gefunden?
Beschreibe uns Dein Problem – wir schauen uns das an und melden uns schnellstmöglich.
