Google Tag Manager: Einrichtung und Hilfe

Folgen Sie den Schritten unter Schnellstart.

Öffnen Sie "Configure" in "Module Manager". Das Formular hat die Tabs "Core", "Server-side", "Events", "Traffic" und "Consent". Verwenden Sie die separate Seite Diagnose für Prüfungen. Controller für Lizenz, Support, Aktualisieren und "Integrity" sind ebenfalls vorhanden.

Entfernen Sie doppelte manuelle Container-Lader aus Theme oder anderen Modulen. Das Modul prüft außerdem, welche MPR-Integration für den konfigurierten Container und das GA4-Ziel zuständig ist. Klären Sie die Zuständigkeit vor dem Übermittlungstest.

Konfigurieren Sie Ihren GTM-Arbeitsbereich selbst. Ordnen Sie die dataLayer-Ereignisnamen und Parameter des Moduls Ihren gewünschten Tags zu und legen Sie die passenden Einwilligungsanforderungen fest. Die Modulinstallation veröffentlicht diese GTM-Tags nicht.

Das Modul lädt gtm.js über die gemeinsame Browserlaufzeit. Der Hook displayAfterBodyOpeningTag bleibt registriert, seine aktuelle Body-Vorlage enthält jedoch kein noscript-iframe. Verwenden Sie kein iframe als Installationsprüfung.

Jeder Standardschalter steht standardmäßig auf Ja. Deaktivieren Sie nicht benötigte Ereignisse.

Warenkorbereignisse erfassen erfolgreiche Mengenänderungen. Erfolglose Versuche, ein Produkt hinzuzufügen, werden nicht erfasst. Testen Sie erfolgreiche Mengenänderungen in Ihrem Theme.

Kontakt und Produktinteraktion

Produktinteraktion verwendet standardmäßig 3 Galerieinteraktionen, 1 Variantenwechsel, 1 Detailinteraktion oder 45 Sekunden. Hohes Interesse wird in dieser GTM-Integration pro Produkt und Seite ohne Deduplizierung über Sitzungsspeicher begrenzt. Verwenden Sie GTM-Einwilligungsanforderungen für alle empfangenden Tags.

"Enhanced Conversions" wird an zulässige Kaufdaten angehängt. Es ist kein bedingungsloses separates Ereignis enhanced_conversions_data auf jeder angemeldeten Seite. Das Modul prüft vor der Erstellung dieser Daten die Berechtigung zur Käuferzuordnung.

Eigene Ereignisregeln

[
  {"event":"gallery_browse","trigger":"click","selector":".product-images img,.images-container img","params":{"component":"product_gallery"},"once":false},
  {"event":"promo_page_seen","trigger":"url","contains":["/special-offer"],"params":{"campaign_area":"landing_page"}},
  {"event":"checkout_seen","trigger":"controller","controllers":["order","order-opc"]},
  {"event":"gallery_open","trigger":"event","dom_event":"mpr:gallery-open","params":{"component":"product_gallery"}}
]

document.dispatchEvent(new CustomEvent('mpr:gallery-open'));

Namen müssen mit einem Buchstaben beginnen, Buchstaben, Ziffern oder Unterstriche verwenden und höchstens 40 Zeichen haben. Reservierte Namen/Präfixe und personenbezogen wirkende Parameterschlüssel werden gefiltert oder abgelehnt. Klickselektoren sind auf 500 Zeichen begrenzt. once ist standardmäßig false für Klicks und true für URL-, Controller- und DOM-Ereignisregeln. Konfigurieren Sie GTM-Auslöser für die exakten eigenen Namen.

"Exclude logged-in employees" steht standardmäßig auf Ja. Die Laufzeit prüft beim Senden Mitarbeiter-/Opt-out-Richtlinien; gemeinsames öffentliches HTML kann dennoch statische Konfiguration für einen ausgeschlossenen Besucher enthalten. Der private Ereignisendpunkt wendet eigene Zulässigkeitsprüfungen an.

Der Verkehrshelfer erkennt User-Agents von Bots, Crawlern, Audit-Werkzeugen und Headless-Browsern. Eine Anfrage mit curl entspricht keinem normalen Kundenbrowser-Test.

So schließen Sie einen Browser aus:

document.cookie = 'mpr_notrack=1; path=/; max-age=31536000; SameSite=Lax';

"Emit Consent Mode fallback (when no CMP installed)" steht standardmäßig auf Ja. Das Formular beschreibt den standardmäßig verweigernden Fallback für einen Shop ohne Cookies Revolution. Hook-Reihenfolge reparieren verschiebt dieses Modul auf displayHeader hinter die CMP an die letzte Stelle. Es ist kein gespeicherter Schalter.

Die aktive gemeinsame Google-Laufzeit setzt ebenfalls verweigerte Standardwerte und liest die aktuelle Einwilligung. Der GTM-Container-/dataLayer-Pfad überlässt die Einwilligung nachgelagerter Tags Ihrer GTM-Konfiguration. Private Warenkorb-/ausstehende Ereignisse und Kaufautorisierung verlangen die entsprechende explizite Analyse-/Dienstentscheidung. Konfigurieren Sie das Einwilligungsverhalten des Containers und Ihre CMP; ein Fallback ist kein Einwilligungsbanner.

Testen Sie Ablehnung, Erteilung und Widerruf mit der tatsächlichen CMP und den GTM-Tags. Die Laufzeit unterstützt weitere CMP-Leser, aber der Hook-Reihenfolge-Helfer dieses Moduls erkennt speziell Cookies Revolution. Eine fehlende Käuferentscheidung hält private/serverseitige Kaufübermittlung zurück.

Speichern Sie beide Zugangsdaten vor dem Aktivieren des Fallbacks. Er gilt nur für purchase. Das Modul speichert bei der Bestellvalidierung die GA-Client-ID und die Analyse-Einwilligung des Käufers und prüft sie vor dem Senden erneut. Ein Kauf ohne eigene GA-Client-ID des Käufers wird nicht gesendet; eine Ersatz-ID wird nicht erzeugt. Mitarbeiterbestellungen, fehlende Käuferdaten, Zuständigkeitskonflikte, Ausgangsbeschränkungen oder ein Widerruf können einen Kauf zurückhalten.

Die Bestellvalidierung nimmt Käufe in eine dauerhafte Warteschlange auf; sie sendet keine direkte HTTP-Anfrage an GA4. Der registrierte Worker findet auch zulässige neue Käufe:

task: send_ga4_measurement_protocol
callable: mprgoogletagmanager::cronProcessMeasurementProtocolQueue
schedule: every:300
context: cron
timeout: 30

Stellen Sie sicher, dass Ihr gemeinsamer MPR-Cron-Runner diese Aufgabe ausführt. Der Worker sendet Batches von 20; diese Einstellungsseite hat kein Feld für die Batchgröße. Der Worker verwendet die beim Checkout gespeicherten Käuferdaten, nie die Cookies der Person, die Cron ausführt.

Browser- und Serverdaten verwenden die Bestellreferenz als transaction_id, und ein gemeinsames Register verhindert, dass dieselbe Bestellung zweimal gesendet wird. Geben Sie eine Testbestellung auf und prüfen Sie, wie sie in Ihrem Ziel erscheint, einschließlich Werten und Artikeln.

Verwenden Sie Diagnose > Prüfungen ausführen, um Konfiguration, doppelte Container, Hook-Reihenfolge, Modulgruppensichtbarkeit, eigenes JSON und Serverstatus zu prüfen. Verwenden Sie bei Bedarf Hook-Reihenfolge reparieren oder Modulgruppe reparieren.

Bestätigen Sie in GTM Preview jeden Ereignisnamen und prüfen Sie ecommerce.currency, ecommerce.value und ecommerce.items. Kaufdaten enthalten Transaktionsreferenz, Steuern, Versand, Gutscheine und verfügbare Artikelfelder wie ID, Name, Marke, Kategorie, Variante, Preis und Menge. Die Integration leert das vorherige E-Commerce-Objekt vor dem Einfügen eines weiteren E-Commerce-Ereignisses.

Die öffentliche Ausgabe enthält statische Konfiguration. Kunden-/Warenkorb-/ausstehende Daten werden über den authentifizierten privaten Endpunkt abgerufen. Prüfen Sie, dass Ihr Cache private Antworten keinem anderen Besucher liefert. Prüfen Sie nach Konfiguration und Veröffentlichung des Containers eine Testbestellung in Preview und im empfangenden Analysekonto.

Fehlt der Container, prüfen Sie Hauptschalter, "Container ID", Zielzuständigkeit, Mitarbeiter-Browserrichtlinie, blockierte Skripte und fehlende gemeinsame Dateien. Die aktuelle Body-Vorlage ist absichtlich leer.

Fehlen Ereignisse, prüfen Sie deren Schalter, Theme-Hook-Ausführung, Antwort des privaten Endpunkts und Einwilligung. Verwenden Sie eine erfolgreiche Warenkorbänderung; der beibehaltene Before-Update-Hook gibt keine Ereignisse aus. Ein eigener Checkout kann eine eigene Regel oder Integration erfordern.

Werden Serverkäufe zurückgehalten, prüfen Sie gespeicherte Zugangsdaten, ob der Worker läuft, die gespeicherten Käuferdaten, die ursprüngliche GA-Client-ID und Widerrufe. Prüfen Sie Diagnose und aktuelle Ereignisprotokolle. Die Protokolltabelle verwendet Ihr konfiguriertes Datenbankpräfix gefolgt von mpr_analytics_events.

Setzen Sie "Enable Google Tag Manager" auf Nein und speichern Sie, um die Modulintegration zu pausieren. Deinstallieren Sie über "Module Manager", um Menü, Modulkonfiguration und Cron-Registrierung zu entfernen. Diese Deinstallationsmethode löscht Ereignisprotokoll- oder Warteschlangenzeilen nicht ausdrücklich. Gemeinsame Infrastruktur folgt ihren Schema-Aufbewahrungsregeln; löschen Sie Tabellen nicht manuell. Ihr GTM-Container und Google-Analytics-Verlauf bleiben in diesen Diensten.

Verwenden Sie die obigen Einstellungsnamen, wenn ein Referenzbild von Ihrer installierten Version abweicht.