StartseiteDokumentationGoogle Tag Manager

    Google Tag Manager

    Nahtlose GTM-Integration mit GA4-Events für Shopware 6

    Zur Plugin-Seite →Anleitung & Konfiguration →

    Überblick

    BronnGoogleTagManager integriert den Google Tag Manager nahtlos in Shopware 6. Das Plugin bindet das GTM-Script automatisch im <head> ein und fügt den noscript-Fallback direkt nach <body> ein. Vier GA4-Standardereignisse (page_view, add_to_cart, begin_checkout, purchase) werden per dataLayer ausgelöst.

    Keine Datenbankmigrationen, kein Admin-Modul erforderlich. Konfiguration ausschließlich über die Shopware Plugin-Einstellungen.

    Aktuelle Version: 1.0.0

    Kompatibel mit Shopware 6.7+.

    Systemvoraussetzungen

  1. •Shopware 6.7 oder höher
  2. •PHP 8.1 oder höher
  3. •Google Tag Manager Account mit Container-ID (Format: GTM-XXXXXXX)

    4. Installation

  4. 1.Plugin in custom/plugins/BronnGoogleTagManager ablegen
  5. 2.Plugin-Installation:
    6. php bin/console plugin:refresh
php bin/console plugin:install BronnGoogleTagManager
php bin/console plugin:activate BronnGoogleTagManager
php bin/console cache:clear
  6. 3.Kein build-administration.sh erforderlich – das Plugin hat kein Admin-Modul.

    7. Konfiguration

    Die Plugin-Konfiguration befindet sich unter Erweiterungen > Meine Erweiterungen > Bronn Google Tag Manager > Konfiguration.

    Einstellungen:

  7. •**GTM Container-ID** (`gtmContainerId`, Typ: `text`): Die Google Tag Manager Container-ID im Format GTM-XXXXXXX. Wenn leer, wird kein Script eingebunden.
  8. •**page_view tracken** (`trackPageView`, Typ: `bool`, Standard: `true`): Löst bei jedem Seitenaufruf ein page_view-Event aus.
  9. •**add_to_cart tracken** (`trackAddToCart`, Typ: `bool`, Standard: `true`): Löst beim Hinzufügen zum Warenkorb ein add_to_cart-Event mit Produktdaten aus.
  10. •**begin_checkout tracken** (`trackBeginCheckout`, Typ: `bool`, Standard: `true`): Löst beim Checkout-Start ein begin_checkout-Event mit allen Warenkorb-Items aus.
  11. •**purchase tracken** (`trackPurchase`, Typ: `bool`, Standard: `true`): Löst nach erfolgreicher Bestellung ein purchase-Event mit Bestell-ID und Produktpositionen aus.

    12. Alle Einstellungen sind Sales-Channel-spezifisch konfigurierbar.

    GA4 Events

    Alle Events werden GA4-konform über den dataLayer mit ecommerce-Objekt ausgelöst:

    | Event | Trigger | Daten |

    |---|---|---|

    | page_view | Jeder Seitenaufruf | Seitentitel, URL |

    | add_to_cart | Klick auf Warenkorb-Button | product_id, product_name, price, quantity, currency |

    | begin_checkout | Checkout-Start | Alle Cart-Items (ohne Gutscheine/Versand) |

    | purchase | Bestellbestätigung | order_id, value, alle Produktpositionen |

    Alle Geldwerte werden auf 2 Dezimalstellen gerundet. Das ecommerce-Objekt wird vor jedem Push geleert, um Datenüberlagerung zu vermeiden.

    Technische Architektur

    StorefrontSubscriber:

    Reagiert auf StorefrontRenderEvent und stellt Template-Variablen für die Container-ID und die aktiven Tracking-Optionen bereit.

    Templates:

  12. •`base.html.twig`: GTM-Script im `<head>` + noscript nach `<body>` (nur wenn Container-ID gesetzt)
  13. •`buy-widget.html.twig`: Erweitert das Kauf-Widget mit data-Attributen (product-id, product-name, product-price, currency)

    14. JavaScript:

  14. •`GtmAddToCart` Plugin: Registriert via PluginManager, lauscht auf Warenkorb-Button-Klicks und pusht add_to_cart-Events

    15. Snippets:

  15. •Namespace: `bronn-google-tag-manager`
  16. •Sprachen: DE (de_DE) + EN (en_GB)

    17. Kein CSRF-Token erforderlich. Keine eigenen Datenbanktabellen. Kein Admin-Modul.

    DSGVO & Datenschutz

    Das Plugin selbst setzt keine Cookies. Google Tag Manager und die darüber eingebundenen Tags können jedoch Cookies setzen. Es wird empfohlen, das Plugin mit einer Consent Management Platform (CMP) zu kombinieren, die den GTM-Container erst nach Zustimmung des Nutzers lädt.

    Die Verantwortung für die datenschutzkonforme Konfiguration der Tags im GTM-Container liegt beim Shop-Betreiber.

    Kompatibilität

  17. •Shopware 6.7+
  18. •Kein Conflict mit anderen Bronner-Plugins
  19. •Theme-kompatibel (Standard-Twig-Block-Erweiterungen)
  20. •Multi-Sales-Channel-fähig
  21. •Kein Admin-Modul – daher keine Abhängigkeit von Vue-Versionen

    22. FAQ

    Weitere Plugin-Dokumentationen

    B2B PlattformPreise ausblendenMindermengenzuschlagAngebotsanfragen