Kein neues Feature verpassen
Plugin-News, Updates und Shopware-Tipps aus der Praxis. Einmal im Monat.
Installationsanleitung
Bitte schaue in den Dokus der einzelnen Plugins, um das Plugin zu konfigurieren:
Auswahl der Tracking Anbieter
Die Erweiterung bietet sechs separate Tracking-Anbieter (Meta, Google, Reddit, Pinterest, Microsoft Advertising/Bing und TikTok), 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.
Optional lässt sich zusätzlich der Schalter „Consent Mode Advanced“ aktivieren (standardmäßig aus): Der Google-Container wird dann bereits vor der Einwilligung geladen, die Consent-Defaults bleiben dabei auf „denied“ gesetzt, sodass nur cookielose Pings an Google gehen. Wichtiger Datenschutz-Hinweis: Dabei geht unter anderem die IP-Adresse des Besuchers schon vor der Einwilligung an Google (Datentransfer in die USA), diese Praxis ist rechtlich umstritten. Aktivierung, Prüfung und Verantwortung liegen beim Shopbetreiber. Details dazu 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:
Pinterest Tag
Dieser Anbieter muss separat über einen In-App-Kauf freigeschaltet werden.
- Aktiv: Schalter zum Aktivieren/Deaktivieren des Pinterest Tags
- Pinterest Tag-ID: Eingabe der Tag-ID aus dem Pinterest Ads Manager
- Serverseitiges Tracking über die Conversions API: Aktiviert die zusätzliche Server-zu-Server-Übermittlung
- Ad Account ID und Conversions-API-Access-Token: Zugangsdaten für die Conversions API aus dem Pinterest Ads Manager
- Enhanced Match: Optional. Sendet eine serverseitig gehashte E-Mail zusätzlich mit
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
Hier findest du eine detailliertere Dokumentation für die Pinterest Tag Erweiterung:
Microsoft Advertising (Bing) UET-Tag
Dieser Anbieter muss separat über einen In-App-Kauf freigeschaltet werden.
- Aktiv: Schalter zum Aktivieren/Deaktivieren des UET-Tags
- UET-Tag-ID: Eingabe der UET-Tag-ID aus Microsoft Advertising (Tools › Konversionsverfolgung › UET-Tag)
- Währung überschreiben: Optional. Leer lassen für die Währung des Verkaufskanals oder eine feste Währung vorgeben
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
Hier findest du eine detailliertere Dokumentation für die Microsoft Advertising (Bing) UET-Tag Erweiterung:
TikTok Pixel
Dieser Anbieter muss separat über einen In-App-Kauf freigeschaltet werden.
- Aktiv: Schalter zum Aktivieren/Deaktivieren des TikTok Pixels
- TikTok Pixel-ID: Eingabe der Pixel-ID aus dem TikTok Events Manager
- Serverseitiges Tracking über die TikTok Events API: Aktiviert die zusätzliche Server-zu-Server-Übermittlung
- Events-API-Access-Token: Token aus dem TikTok Events Manager für die serverseitige Übertragung
- Test-Event-Code: Optional, nur zum Testen. Mit hinterlegtem Code erscheinen die Ereignisse im TikTok Events Manager unter „Test Events“. Im Produktivbetrieb leer lassen
- Enhanced Matching: Optional. Sendet zusätzlich serverseitig per SHA-256 gehashte E-Mail und Telefonnummer mit
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
Hier findest du eine detailliertere Dokumentation für die TikTok Pixel Erweiterung:
Serverseitige Einwilligungsprüfung für die Conversion API (neu in 2.8.0)
Ab Version 2.8.0 prüft die Erweiterung vor jedem serverseitigen Conversion-API-Event (Meta, Reddit, Pinterest, TikTok), ob der Besucher über deinen Consent-Manager in das Marketing-Tracking eingewilligt hat. Geprüft wird dieselbe Cookie-Kategorie bzw. dasselbe Consent-Attribut, das auch für den Browser-Tag hinterlegt ist, inklusive eines im Experten-Modus gesetzten eigenen Attributs.
- Ohne Einwilligung kein Server-Event: Hat der Besucher der Marketing-Kategorie nicht zugestimmt, sendet die Erweiterung kein serverseitiges Conversion-API-Event mehr.
- UserCentrics, CCM19 und Consentmanager: Bei diesen drei Consent-Managern spiegelt die Erweiterung die Einwilligungsentscheidung zusätzlich in einen technischen Status-Cookie. Der Cookie überträgt ausschließlich den Einwilligungsstatus, es wird darüber kein Tracking gesetzt. So funktioniert die Prüfung auch bei diesen Consent-Managern serverseitig.
Experten-Attribut je Consent-Manager:
- Cookiebot, CookieFirst, CookieYes: Kategorie
- UserCentrics: Service-Name
- Consentmanager: Vendor-ID
- CCM19: Embedding-Name. Ohne gesetzten Embedding-Namen gehen serverseitige CCM19-Events von einer vollständigen Zustimmung aus.
DSGVO-Hinweis: Je Provider gibt es einen neuen Schalter „Serverseitige Einwilligungsprüfung deaktivieren“ (nicht empfohlen). Ist er aktiv, sendet die Erweiterung Conversion-API-Events unabhängig vom Einwilligungsstatus des Besuchers. Das kann gegen die DSGVO verstoßen, wenn für das Marketing-Tracking keine anderweitige Rechtsgrundlage vorliegt. Setze den Schalter nur, wenn die Datenverarbeitung anderweitig rechtlich abgesichert ist. Ein ausdrücklicher Opt-out des Besuchers wird auch bei deaktivierter Prüfung immer respektiert.
- Serverseitige Einwilligungsprüfung deaktivieren (je Provider, nicht empfohlen): Schalter, um die Consent-Prüfung für dieses Tracking-Ziel abzuschalten.
Hinweis für Shop-Betreiber: Nach dem Update kann die Zahl der Conversion-API-Events insgesamt sinken, weil Besucher ohne Einwilligung nicht mehr serverseitig erfasst werden. Das ist eine bewusste Datenschutz-Korrektur und kein Fehler.
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.
German 
English