← Dokumentation / PlentyShop LTS
PLUGIN-HANDBUCH // SMBLNC-GTM-TRACKING-LTS

PlentyShop LTS Dokumentation & Setup-Handbuch

Offizielle technische Anleitung für das Google Tag Manager Tracking & Google Consent Mode v2 Plugin für PlentyShop LTS (Ceres / IO) inklusive 1-Klick-Kopierbuttons für sämtliche Cookie-Listen.

SCHRITT-FÜR-SCHRITT // INSTALLATION & VERKNÜPFUNG

Installation & Verknüpfung in Plentymarkets LTS

Folgen Sie dieser Anleitung, um das Plugin in Ihrem Plentymarkets-System abzurufen, im Plugin-Set zu aktivieren, die Container-Verknüpfungen zu prüfen und die empfohlenen Ceres-Performance-Einstellungen zu setzen.

1. Git-Repository in Plenty hinterlegen / aktualisieren

  1. Gehe zu Plugins » Git.
  2. Wähle das Repository GoogleTagManagerConsentV2 und klicke auf Plugins abrufen (Pull).

2. Plugin im Plugin-Set aktivieren

  1. Gehe zu Plugins » Plugin-Set-Übersicht » [Dein Plugin-Set].
  2. Stelle sicher, dass GoogleTagManagerConsentV2 aktiv ist (blaues Häkchen).
  3. Öffne die Konfiguration, trage deine GTM Container-ID ein sowie deinen smblnc B2B-Lizenzschlüssel unter „Lizenz & Schutz“.

3. Container-Verknüpfungen (automatisch via DataProviders)

Das Plugin stellt moderne Plentymarkets dataProviders mit vordefinierten Layout-Containern bereit:

  • GTM Head Container → Standard: Ceres::PageDesign.AfterOpeningHeadTag
  • GTM Body Container → Standard: Ceres::PageDesign.AfterOpeningBodyTag
  • GTM Order Confirmation → Standard: Ceres::OrderConfirmation.BeforeOrderDetails
⚠ Warning
Verknüpfe niemals Container mit Ceres::Header oder Ceres::Footer! In Ceres sind dies Override-Container, die den gesamten Header oder Footer (inklusive des Ceres Cookie-Banners) überschreiben.

4. Empfohlene plentyShop LTS (Ceres) Performance-Einstellungen

Unter CMS » plentyShop LTS » [Webshop wählen] » Performance:

  • State Cloning für das Event Propagation-Plugin aktivieren: Muss aktiviert (angehakt) sein! Wenn State Cloning deaktiviert ist, übergibt Ceres leere Datenobjekte in den Events, wodurch Artikel-ID, Preis und Menge für add_to_cart / remove_from_cart verloren gehen.
  • Vue Server-Side Rendering (SSR): Kann problemlos aktiviert bleiben (Plugin ist 100% SSR-kompatibel).
  • Performance-Level: Live-Modus empfohlen („Gesamte Seite vor der Anzeige nach ungültigem Markup-Code durchsuchen“ deaktiviert lassen).

5. Empfohlene plentyShop LTS Cookie-Einstellungen (Rechtssicherheit & Session-Handling)

Um die Rechtssicherheit Ihres plentyShops nach EU-Recht (DSGVO / ePrivacy) zu garantieren und gleichzeitig sicherzustellen, dass Warenkörbe bei wiederkehrenden Besuchern erhalten bleiben, werden folgende Einstellungen empfohlen:

Pfad im Plenty-Backend:
Einrichtung » Assistenten » Plugins » [Dein Plugin-Set] » plentyShop LTS » Schritt: Webshop » Aufklappbox: Einstellungen für Cookies
(Alternativ unter: Plugins » Plugin-Set-Übersicht » [Dein Plugin-Set] » plentyShop LTS » Konfiguration » Global)
Einstellung Empfohlener Wert Erklärung / Hintergrund
Gültigkeit des Cookies (Session-Cookie) 100 Tage Der Session-Cookie dient dazu, Informationen zu bündeln und einem Nutzer zuzuordnen. Eine Gültigkeit von 100 Tagen stellt sicher, dass in den Warenkorb gelegte Artikel auch bei späteren Besuchen erhalten bleiben (essenziell für Kaufabbrüche, Remarketing und eine hohe Conversion-Rate).
Nicht akzeptierte Cookies blockieren (empfohlen) Aktiviert (angehakt) Dringend empfohlen für Rechtssicherheit nach EU-Recht: Blockiert alle nicht-essenziellen Cookies und Drittanbieter-Skripte (z. B. Google reCAPTCHA), solange keine ausdrückliche Zustimmung im Cookie-Banner vorliegt. In Kombination mit diesem Plugin greift der Google Consent Mode v2 sofort und schützt vor Abmahnungen.

6. Plugin-Set bereitstellen

Klicke auf Plugin-Set bereitstellen (Speichern & Bereitstellen). Das Ceres-eigene Cookie-Banner bleibt vollständig intakt und steuert Google Consent Mode v2 dynamisch.

1. Kernfunktionen & Architektur

CONSENT MODE V2

Advanced Standard integriert

Initialer Default-Zustand denied vor GTM-Load (wait_for_update: 500). Sendet cookielose Signal-Pings zur KI-Modellierung in Google Ads und GA4.

CERES INTEGRATION

Ceres ConsentRepository

Vollständige Einbindung in window.ConsentManager und consent-change Event-Listener. Saubere Cookie-Gruppen (Essenziell, Statistik, Marketing).

DATENREINHEIT

Dynamisches Cookie-Purging

Keine hardgecodeten Cookies. Bei Widerruf werden ausschließlich die vom Anwender konfigurierten Cookies präzise gelöscht (unterstützt Regex, Wildcards und Präfixe).

B2B-LIZENZ & SCHUTZ

Lizenzschutz & Staging-Bypass

Mathematische Offline-Validierung via HMAC-SHA256 mit 24h Client-Heartbeat gegen smblnc.de. Dev- und Staging-Domains (*.plentymarkets-cloud01.com, localhost) sind vollautomatisch freigeschaltet.

PLENTYMARKETS BACKEND // KONFIGURATION

2. Konfiguration im Plentymarkets Plugin-Set

Die Einstellungen befinden sich unter:
Plugins » Plugin-Set-Übersicht » [Dein Plugin-Set] » Google Tag Manager inkl. CMV2 von smblnc.de » Konfiguration

Tipp zur Cookie-Notation (fehlertolerant):
Das Plugin unterstützt flexibel Regex mit Schrägstrichen (z. B. /^_ga_/), Wildcards mit Stern (z. B. _ga_*), Präfixe mit Dach (z. B. ^_ga) oder exakte Cookie-Namen (z. B. _fbp). Nutzen Sie die bequemen Kopierbuttons, um die Listen direkt in Plentymarkets einzufügen.

1. Aufklappbox: Google Tag Manager

EinstellungTypEmpfohlener Wert
Google Tag Manager aktivierenCheckboxAktiviert
Google Tag Manager IDTextfeldIhre GTM-ID (z. B. GTM-XXXXXXX)
Zu registrierende CookiesTextfeldStandardmäßig leer lassen (GTM setzt keine Cookies)
Google Search Console VerifizierungTextfeldHTML-Tag oder Token zur Inhaberschaftsbestätigung
Hinweis: GTM wird automatisch als technisch notwendiger Dienst in die Gruppe „Essenziell“ eingebunden.

2. Aufklappbox: Google Analytics (GA4)

EinstellungTypEmpfohlener Wert
Google Analytics aktivierenCheckboxAktiviert (Gruppe Tracking)
Zu registrierende CookiesTextfeldEmpfohlene Cookie-Liste siehe unten
Empfohlene Cookie-Liste für Google Analytics (Standard mit Regex):
_ga,/^_ga_/,/^_gac_/,/^_gac_gb_/,/^_gcl_/,FPID,FPLC,_gid,_gat,/^_gat_/,AMP_TOKEN
Alternative Wildcard-Notation:
_ga,_ga_*,_gac_*,_gcl_*,FPID,FPLC,_gid,_gat,_gat_*,AMP_TOKEN

3. Aufklappbox: Google Ads

EinstellungTypEmpfohlener Wert
Google Ads aktivierenCheckboxAktiviert (Gruppe Marketing)
Zu registrierende CookiesTextfeldEmpfohlene Cookie-Liste siehe unten
Empfohlene Cookie-Liste für Google Ads:
/^_gcl_/,/^_gac_/,FPAU,_gbraid,_wbraid,__gads,__gpi,PAIDID,IDE,test_cookie,DSID,ANID,AID,NID,1P_JAR,DV,CONSENT,SOCS,APISID,HSID,SAPISID,SID,SIDCC,SSID,VISITOR_INFO1_LIVE,YSC
Alternative Wildcard-Notation:
_gcl_*,_gac_*,FPAU,_gbraid,_wbraid,__gads,__gpi,PAIDID,IDE,test_cookie,DSID,ANID,AID,NID,1P_JAR,DV,CONSENT,SOCS,APISID,HSID,SAPISID,SID,SIDCC,SSID,VISITOR_INFO1_LIVE,YSC

4. Aufklappbox: Meta (Facebook & Instagram)

EinstellungTypEmpfohlener Wert
Meta (Facebook) aktivierenCheckboxAktiviert (Gruppe Marketing)
Zu registrierende CookiesTextfeldEmpfohlene Cookie-Liste siehe unten
Facebook Domain-VerifizierungTextfeldHTML-Tag oder Token aus Meta Business Manager
Empfohlene Cookie-Liste für Meta / Facebook:
_fbp,_fbc,gtmeec,/^_fb/
Alternative Wildcard-Notation:
_fbp,_fbc,gtmeec,_fb*

5. Aufklappbox: Microsoft Advertising (Bing Ads / UET)

EinstellungTypEmpfohlener Wert
Microsoft Advertising aktivierenCheckboxAktiviert (Gruppe Marketing)
Zu registrierende CookiesTextfeldEmpfohlene Cookie-Liste siehe unten
Bing Webmaster Tools VerifizierungTextfeldHTML-Tag oder Token aus Bing Dashboard
Empfohlene Cookie-Liste für Microsoft Advertising:
_uetmsclkid,_uetsid,_uetvid,MUID,MSPC,/^_uet/
Alternative Wildcard-Notation:
_uetmsclkid,_uetsid,_uetvid,MUID,MSPC,_uet*

6. Aufklappbox: Pinterest Tag

EinstellungTypEmpfohlener Wert
Pinterest aktivierenCheckboxAktiviert (Gruppe Marketing)
Zu registrierende CookiesTextfeldEmpfohlene Cookie-Liste siehe unten
Pinterest Domain-VerifizierungTextfeldHTML-Tag oder Token aus Pinterest Business
Empfohlene Cookie-Liste für Pinterest:
_pin_unauth,_pinterest_ct_ua,_pinterest_sess,_epik,epik,/^_pin_/,/^_epik/
Alternative Wildcard-Notation:
_pin_unauth,_pinterest_ct_ua,_pinterest_sess,_pin_*,_epik*,epik

7. Aufklappbox: AWIN

EinstellungTypEmpfohlener Wert
AWIN aktivierenCheckboxAktiviert (Gruppe Marketing)
Zu registrierende CookiesTextfeldEmpfohlene Cookie-Liste siehe unten
Empfohlene Cookie-Liste für AWIN:
/^_awin/,/^_aw/,AWSESS,awc
Alternative Wildcard-Notation:
_awin*,aw*,AWSESS,awc

8. Aufklappbox: moebel.de

EinstellungTypEmpfohlener Wert
moebel.de aktivierenCheckboxAktiviert (Gruppe Marketing)
Zu registrierende CookiesTextfeldEmpfohlene Cookie-Liste siehe unten
Empfohlene Cookie-Liste für moebel.de:
/^_moebel/,moebel_session

9. Aufklappbox: Matomo

EinstellungTypEmpfohlener Wert
Matomo aktivierenCheckboxAktiviert (Gruppe Tracking)
Zu registrierende CookiesTextfeldEmpfohlene Cookie-Liste siehe unten
Empfohlene Cookie-Liste für Matomo:
/^_pk_/,_pk_id,_pk_ses,_pk_ref,_pk_cvar
Alternative Wildcard-Notation:
_pk_id*,_pk_ses*,_pk_ref*,_pk_cvar*,mtm_cookie_consent*

10. Aufklappbox: Fraud0 (Bot-Schutz)

EinstellungTypEmpfohlener Wert
Fraud0 aktivierenCheckboxAktiviert (Gruppe Notwendig)
Zu registrierende CookiesTextfeldEmpfohlene Cookie-Liste siehe unten
Empfohlene Cookie-Liste für Fraud0 (Bot-Schutz):
/^_f0_/,f0_uid,f0_sid

11. Aufklappbox: Klaviyo

EinstellungTypEmpfohlener Wert
Klaviyo aktivierenCheckboxAktiviert (Gruppe Marketing)
Zu registrierende CookiesTextfeldEmpfohlene Cookie-Liste siehe unten
Empfohlene Cookie-Liste für Klaviyo:
/^_{1,2}kla_/,__kla_id,_kla_id,__kla_offo

12. Aufklappbox: ADCELL

EinstellungTypEmpfohlener Wert
ADCELL aktivierenCheckboxAktiviert (Gruppe Marketing)
Zu registrierende CookiesTextfeldEmpfohlene Cookie-Liste siehe unten
Empfohlene Cookie-Liste für ADCELL:
/^adcell/,adcell_*,_adcell_*

13. Aufklappbox: OpenAI (ChatGPT Conversions)

EinstellungTypEmpfohlener Wert
OpenAI aktivierenCheckboxAktiviert (Gruppe Marketing)
Zu registrierende CookiesTextfeldEmpfohlene Cookie-Liste siehe unten
Empfohlene Cookie-Liste für OpenAI:
__oppref,__obref,/^_{1,2}oppref/,/^_{1,2}obref/
MANAGED SGTM // SERVER-SETUP

14. Aufklappbox: Serverseitiges GTM-Tracking (sGTM)

EinstellungTypEmpfohlener Wert / Funktion
Serverseitiges GTM aktivierenCheckboxAktiviert sGTM über eigene Server-Subdomain
Server-Domain (Subdomain)Textfeldz. B. ssmblnc.domain.xyz (ohne https://)
Client-GTM Container-IDTextfeldWeb-Container-ID für den Server-Client (z. B. GTM-XXXXXXX)
Dienste serverseitig registrierenCheckboxenAktiviert GA4, Ads, Meta, Bing, Pinterest, AWIN, Klaviyo für sGTM
Zu registrierende Cookies (sGTM)TextfelderEmpfohlene Cookie-Listen siehe unten

Wenn Sie den sGTM Server-Container einsetzen, können Sie die Cookies auf die für den Server relevanten First-Party-Signale reduzieren:

Serverseitiges Google Analytics 4:
FPID,FPLC,_ga,/^_ga_/
Serverseitiges Google Ads:
FPAU,/^_gcl_/,_gcl_au,_gcl_aw,_gcl_dc,_gbraid,_wbraid
Serverseitiges Meta CAPI:
_fbp,_fbc,gtmeec,/^_fb/
Serverseitiges Microsoft Advertising:
_uetmsclkid,_uetsid,_uetvid,MUID,MSPC,/^_uet/
Serverseitiges Pinterest CAPI:
_pin_unauth,_pinterest_ct_ua,_pinterest_sess,_epik,epik,/^_pin_/,/^_epik/
Serverseitiges AWIN S2S:
/^_awin/,/^_aw/,AWSESS,awc
Serverseitiges Klaviyo sGTM:
/^_{1,2}kla_/,__kla_id,_kla_id,__kla_offo
LIZENZSCHLÜSSEL-EINGABE // NEU IN V1.8.0

15. Aufklappbox: Lizenz & Schutz

Hinterlegen Sie hier Ihren persönlichen smblnc B2B-Lizenzschlüssel zur dauerhaften Freischaltung des Trackings auf Ihrer Produktiv-Domain:

EinstellungTypWert / Format
smblnc B2B-LizenzschlüsselTextfeldIhr von smblnc.de bereitgestellter Lizenzschlüssel (z. B. SMBLNC-LTS-XXXX-XXXX-XXXX-XXXX)
✓ Wichtige Hinweise zum Lizenzschlüssel & Staging-Bypass
1. Staging- und Entwicklungsumgebungen: Test- und Staging-Domains wie *.plentymarkets-cloud01.com, *.plenty-test.de oder localhost sind vollautomatisch und dauerhaft freigeschaltet. Auf Staging-Umgebungen muss kein Lizenzschlüssel eingegeben werden.
2. Produktivbetrieb: Für Ihre offizielle Live-Domain (z. B. ihredomain.de) tragen Sie den Schlüssel hier ein. Das Plugin validiert den Schlüssel sofort mathematisch offline via HMAC-SHA256.
3. Asynchroner Heartbeat: 1x alle 24 Stunden synchronisiert sich das Plugin per ressourcenschonendem Browser-Ping mit smblnc.de (24h-Client-Cache). Ihr Shop bleibt bei Netzwerkverzögerungen stets 100% performant und fehlerfrei erreichbar.

3. E-Commerce DataLayer Events

Das Plugin übergibt sämtliche E-Commerce Aktionen gemäß GA4 Standard vollautomatisch in den dataLayer:

view_item

Auf Artikel-Detailseiten mit Item-ID, Name, Preis und Währung.

add_to_cart

Beim Hinzufügen eines Artikels über Ceres Frontend-Events.

begin_checkout

Beim Start des Kassiervorgangs mit Warenkorbinhalt.

purchase

Auf der Bestellbestätigungsseite inkl. Transaktions-ID und Steuern.

> BEREIT FÜR PLENTYSHOP LTS?

Bereit für Ihren PlentyShop LTS Web-Container?

Erzeugen Sie den passenden GTM-Container direkt in unserem Web-Konfigurator.

[ > Zum PlentyShop LTS Web-Konfigurator → ]