Google Tag Manager

Über die Erweiterung

Tag Manager bringt den Google Tag Manager in deine Storefront und füllt den DataLayer mit 13 GA4-Events, vom Produkt-Listing bis zum Kauf. Standardmäßig lädt der Container erst nach der Einwilligung des Besuchers, und optionale Funktionen ergänzen Google Consent Mode v2, Enhanced Conversions und das Laden aus deinem eigenen Server-Side-Container. Alles stellst du pro Verkaufskanal in der Plugin-Konfiguration ein.

Google Tag Manager in deiner Storefront

Aktiviere „Google Tag Manager aktivieren“ und trage deine „GTM Container ID“ (GTM-XXXXXXX) in der Plugin-Konfiguration ein. Tag Manager lädt den Container dann auf den Storefront-Seiten des Verkaufskanals, standardmäßig nach der Einwilligung des Besuchers.

• Einstellungen pro Verkaufskanal
• „Server-Side GTM URL“ lädt gtm.js von deinem eigenen Server-Side-Container (optional)
• Tag Manager lädt nur den GTM-Container: Tags, Trigger und Variablen bleiben in deinem Container

13 GA4-Events im DataLayer

Tag Manager sendet die folgenden GA4-Events an den DataLayer. Jedes Event hat einen eigenen Schalter, alle sind standardmäßig aktiv, und „GA4 E-Commerce Events aktivieren“ ist der Hauptschalter für die zehn E-Commerce-Events.

• view_item_list und select_item in Produkt-Listings, zum Beispiel auf Kategorieseiten und in Suchergebnissen
• view_item auf der Produktdetailseite
• add_to_cart und remove_from_cart, wenn Produkte in den Warenkorb gelegt oder daraus entfernt werden, gesendet mit dem Offcanvas-Warenkorb oder dem nächsten Seitenaufruf
• view_cart auf der Warenkorbseite
• begin_checkout, add_shipping_info und add_payment_info auf der Checkout-Seite „Bestellung abschließen“, mit der gewählten Versand- und Zahlungsart
• purchase auf der Danke-Seite nach der Bestellung, mit Bestellnummer, Wert, Steuern und Versandkosten
• search mit dem Suchbegriff auf der Suchergebnisseite
• login und sign_up für Kundenkonten

GA4-Artikeldaten ohne Doppelungen

Artikel enthalten die Produktnummer als item_id, den Namen, den Stückpreis und die Währung, dazu die Menge (außer in Produkt-Listings) und den Hersteller als item_brand, sofern einer zugeordnet ist.

• item_category mit der SEO-Kategorie auf der Produktdetailseite
• die Position in der Liste als index und in Suchergebnissen den Suchbegriff als item_list_name
• add_to_cart zählt nur die hinzugefügte Menge, auch wenn das Produkt schon im Warenkorb liegt
• begin_checkout feuert einmal pro Warenkorbstand, die Versand- und Zahlungs-Events einmal pro Warenkorbstand und Methode und purchase einmal pro Bestellung, auch wenn die Seite in derselben Sitzung neu geladen wird
• das vorherige ecommerce-Objekt wird vor dem nächsten E-Commerce-Event geleert

Consent-Prüfung, bevor Tag Manager lädt

„GTM erst nach Einwilligung laden“ ist standardmäßig aktiv: Der Container lädt erst, wenn der Besucher das Cookie „Google Tag Manager“ in der Gruppe „Statistiken“ des Shopware-Cookie-Banners akzeptiert. Mit dem Banner von Shopware lädt Tag Manager direkt nach der Einwilligung, ohne die Seite neu zu laden.

• Consent-Tools von Drittanbietern: Cookiebot (Cookie CookieConsent, Kategorie statistics) oder ein Cookie mit URL-kodiertem JSON, das pro Kategorie true oder false enthält
• „Name des Consent-Cookies“ und „Benötigte Consent-Kategorie“ legen das zu prüfende Cookie und die Kategorie fest
• das Cookie „Google Tag Manager (Marketing)“ in der Gruppe „Marketing“ für die Werbesignale von Consent Mode v2
• DataLayer-Einträge werden schon vor der Einwilligung geschrieben, und der Container verarbeitet sie, sobald er lädt

Google Consent Mode v2 für GA4

„Google Consent Mode v2 aktivieren“ (optional) sendet Consent-Signale, bevor der Container lädt. Alle vier Consent-Typen stehen zunächst auf „verweigert“ (denied) und wechseln auf „erteilt“ (granted), wenn der Besucher zustimmt.

• mit dem Cookie-Banner von Shopware folgt analytics_storage dem Cookie „Google Tag Manager“ und ad_storage, ad_user_data und ad_personalization folgen „Google Tag Manager (Marketing)“
• „Auf Consent-Aktualisierung warten (ms)“ mit standardmäßig 500 ms
• consent_status-Event mit der Einwilligung pro Kategorie (analytics, marketing, functional) bei Seitenaufrufen und Consent-Änderungen (optional)

Nutzerdaten und Enhanced Conversions für GA4

„Nutzerdaten in den DataLayer senden“ ist standardmäßig aktiv und ergänzt den Login-Status und den Nutzertyp sowie für angemeldete Kunden die Kundengruppe und eine SHA-256-gehashte Kunden-ID als user_id.

• „Enhanced Conversions (gehashte E-Mail)“ ergänzt die E-Mail-Adresse des Kunden als SHA-256-Hash für Google Ads (optional)
• Seiten mit kundenspezifischen Werten werden vom HTTP-Cache ausgenommen

Eigener DataLayer für Tag Manager

Unter „Benutzerdefinierte DataLayer-Variablen“ fügst du eigene Werte im Format key = value hinzu, einen pro Zeile. Tag Manager ergänzt sie im Basis-DataLayer der Storefront-Seiten.

• Zahlen und true/false werden zu Zahlen und Booleans
• Twig-Platzhalter wie {{ page.product.name }} werden pro Seite gefüllt, und leere Ergebnisse fallen weg
• page_type, shop_name, currency_code und page_language kommen automatisch hinzu
• deine eigenen Werte sind Teil des Konfigurationsexports

Export, Import und Dokumentation für Tag Manager

Unter Marketing > Tag Manager lädt die Seite „Export / Import“ die für einen Verkaufskanal gespeicherten Werte oder die globale Konfiguration als JSON-Datei herunter und importiert sie wieder, zum Beispiel vom Staging- ins Produktivsystem.

• der Import prüft die Werte vor dem Speichern gegen die Typen der Einstellungen
• die Seite „Dokumentation“ behandelt Übersicht, Installation, Konfiguration, Events, Consent, eigenen DataLayer und FAQ