8
0
GoogleAnalytics4/Docs/README.md
2024-01-22 14:30:59 +01:00

4.1 KiB

Technische Doku

GA4 Events / Customizing

Für alle implementierten GA4 Events existieren Templates unter source/modules/d3/googleanalytics4/Application/views/event/, dabei entspricht der Dateiname dem Eventnamen in GA4. Die Einbindung dieser Event-Templates erfolgt über TPL-Blöcke unter source/modules/d3/googleanalytics4/Application/views/blocks/.
*Hinweis: nicht alle templates sind bereits gefüllt. Wünschen Sie die Implementierung eines unausgefüllten templates? Kommen Sie auf uns zu unter https://www.d3data.de/

Steuerungsparameter

Tragen Sie hier im Normalfall die ID des zu prüfenden Cookies ein.
In bestimmten Fällen, müssen Sie hier alternative Werte eintragen. Diese Fälle sind bedingt nach der gewählten CMP (Consent Manager Platform).

nähere Infos unter CMP

Verfügbare Datalayer Variablen

Für die einfachste Übersicht der enthaltenen Daten empfehle ich den Vorschau-Modus vom Google Tag Manager.

Bei jedem Seitenaufruf wird die Datenschicht mit einigen wenigen Infos erstellt, die man zum reinen Erfassen der Seitenaufrufe benötigt:

  • page.type - Seitentyp: default / cms / product / listing / checkout (an google analytics angelehnt)
  • page.title - Seitentitel (außer Startseite, sie hat keinen Titel)
  • page.cl - OXID Controller Klasse (start, search, etc)
  • userid - oxId vom Benutzer bzw false falls nicht eingeloggt
  • sessionid - session iD

Alle für Ecommerce Tracking relevanten Daten werden mit speziellen Ecommerce Events in die Datenschicht eingefügt.

Sie nutzen einen eigenen, als Modul im Shop installierten, Cookie-manager?
Dann tragen Sie in den Folgeeinstellungen unter "Cookie Manager Einstellungen", die Cookie-ID des zugehörigen Cookies ein.
Aktivieren Sie anschließend diese Weiche. Setzen Sie den Haken bei "Eigenen Cookie Manager nutzen?".

Unterstützung für

  • aggrosoft - oxid-cookie-compliance

    • https://github.com/aggrosoft/oxid-cookie-compliance
    • die entsprechend gewählte Kategorie in den Moduleinstellungen des 'Google Analytics 4' unter Einstell. > Cookie Manager Einstellungen > Cookie-ID eintragen
    • Default-Werte sind entweder ANALYTICS oder MARKETING. Bitte auf die Großschreibung achten.
  • Netensio - Cookie Consent Manager

    • Modul entsprechend konfigurieren
    • CookieID des angelegten Cookies in den Moduleinstellungen des 'Google Analytics 4' unter Einstell. > Cookie Manager Einstellungen > Cookie-ID eintragen
  • OXID Cookie Management powered by usercentrics

    • In der Usercentrics-Verwaltung die Services "Google Analytics" und "Google Tag Manager" anlegen
    • Den Service Google Tag Manager in den Moduleinstellungen des 'Google Analytics 4' unter Google Tag Manager eintragen
  • Consent Management Provider

    • In der Consentmanager-Oberfläche den Anbieter "Google Tag Manager" mit der ID s905 hinzufügen
    • Im Frontend, im consentmanager-Pop-up nach dem 'Google Tag Manager' suchen
      • kleines Fragezeichen neben den Namen anklicken und ganz runter scrollen
        • prüfen, ob ein Cookie vorgegeben ist
        • sonst, in der Consentmanager-Oberfläche Cookie-Liste entsprechendes Cookie suchen und im Admin unter Einstell. > Cookie Manager Einstellungen > Cookie-ID eintragen
  • Cookiefirst

    • im Cookiefirst-Hub das jeweilige Cookie finden underen zugeordnete Kategorie kopieren
    • die kopierte Kategory wird nun in den Einstellungen des Moduls hinterlegt: Erweiterungen > Module > Google Analytics 4 > Einstell. > Cookie Manager Einstellungen > Steuerungsparameter (vormals CookieID)
    • Wichtig! bei Nutzung des Consent-Managers von Google, muss zwangsläufig die Einstellung "Cookie manager Nutzen?" ausgeschalten! werden