Allgemeines
Google Analytics 4 (kurz GA4) ist eine Webanalyse-Plattform von Google, die es Website-Betreibern ermöglicht, detaillierte Informationen über das Verhalten von Nutzern auf ihren Websites und Apps zu erfassen und zu analysieren. GA4 ist die neueste Version von Google Analytics und ersetzt nach und nach die frühere Version Universal Analytics.
Vorgehen
Im folgenden wird gezeigt, wie die Anbindung von GA4 mithilfe von CookieFirst durchgeführt werden kann.
Voraussetzungen:
- Das Shopmerkmal "Google Analytics" muss aktiviert sein.
- optional: Das Shopmerkmal "Google eCommerce Tracking" ist aktiviert.
- Ein CookieFirst API-Key liegt vor.
Um CookieFirst zu aktivieren wird zunächst ein API-Key benötigt, dieser wird mithilfe der Shop-Konfiguration an einen Shop gebunden. Zusätzlich muss ein Custom Script in der Kategorie "performance" in CookieFirst angelegt werden ( CookieFirst ).
Die Shop-Konfiguration sieht wie folgt aus:
# Settings for the CookieFirst consent banner cookieFirst { # The API key for the CookieFirst account; # if filled, CookieFirst will be included automatically when using Google Analytics key = "" } # Settings for Google Analytics google { analytics.autoInitialize = false eCommerceTracking.autoSubmit = false }
Das Custom Script für CookieFirst sieht wie folgt aus:
<script type="text/javascript"> initializeGoogleAnalytics(); sellsite.ga.initializeECommerce(); if (typeof submitECommerceTransaction !== 'undefined') { submitECommerceTransaction(); } </script>
Im folgenden wird gezeigt, wie die Anbindung von GA4 mithilfe von Usercentrics durchgeführt werden kann.
Voraussetzungen:
- Das Shopmerkmal "Google Analytics" muss aktiviert sein.
- optional: Das Shopmerkmal "Google eCommerce Tracking" ist aktiviert.
- Es besteht eine Usercentrics-ID.
- Der Consentname "Google Analytics" wurde in Usercentrics angelegt.
- optional: Der Consentname "Google E-Commerce-Tracking" wurde in Usercentrics angelegt.
Die Shop-Konfiguration:
# Settings for usercentrics data privacy tool usercentrics { # Id from usercentrics id = "<id>" # Determines the version of usercentrics to use (supported values are 1, 2 and 3) version = "2" # name of consent for Google Analytics defined in usercentrics googleAnalytics = "Google Analytics" # name of consent for Google E-Commerce-Tracking defined in usercentrics. Only needed if you use the e-commerce tracking. eCommerceTracking = "Google E-Commerce-Tracking" } # Settings for Google Analytics google { analytics.autoInitialize = false eCommerceTracking.autoSubmit = false }
Im folgenden wird gezeigt, wie die Anbindung von GA4 ohne einen Cookie Consent Manager durchgeführt werden kann.
Voraussetzungen:
- Das Shopmerkmal "Google Analytics" muss aktiviert sein.
- optional: Das Shopmerkmal "Google eCommerce Tracking" ist aktiviert.
Die Shop-Konfiguration:
# Settings for Google Analytics google { analytics.autoInitialize = true eCommerceTracking.autoSubmit = true }
Die Anbindung von Google Analytics 4 erfolgt über die Artefakte desktop/page-customer-head.html.pasta und mobile/page-customer-head.html.pasta. In diesen Artefakten muss die folgende Zeile ergänzt werden:
<f:googleAnalytics4 googleAnalyticsId="G-XXXXX" clickEvents="false" advancedCustomerTracking="false"/>Die Parameter sind dabei wie folgt zu verstehen:
- googleAnalyticsId: Der GA4-Tag aus Google Analytics.
-
clickEvents: Gibt an, ob die Click-Events ebenfalls an Google übertragen werden sollen.
- Angabe von "true oder "false". Der Standardwert ist immer false.
- Diese Angabe ist optional und kann weggelassen werden.
-
advancedCustomerTracking: Gibt an, ob für einen angemeldeten User eine gehashte ID an Google übertragen
werden soll.
- Angabe von "true oder "false". Der Standardwert ist immer false.
- Diese Angabe ist optional und kann weggelassen werden.
Die Anbindung des E-Commerce-Trackings erfolgt über die Artefakte desktop/complete-customer-head.html.pasta und mobile/complete-customer-head.html.pasta. In diesen Artefakten muss die folgende Zeile ergänzt werden:
<f:googleAnalyticsECommerce4 basketInfo="@basketInfo" trackedOrderName=""/>Die Parameter sind dabei wie folgt zu verstehen:
- basketInfo: Übergibt den Basket an die E-Commerce Komponente. Dieser Parameter darf nicht verändert werden!
-
trackedOrderName: Schränkt die Übergabe an Google auf einen Bestelltyp ein.
- Standardmäßig wird der Typ nicht gefiltert.
- Diese Angabe ist optional und kann weggelassen werden.
Google benötigt eine Einwilligung von Sellsite, um Daten zu sammeln. Diese Einwilligung wird von Sellsite standardmäßig auf "denied" gesetzt. Verschiedene Cookiebanner überschreiben diese Einwilligung automatisch. Falls dies nicht passiert, kann es dazu kommen, dass Google keine Personenbezogene Daten sammeln kann. Wenn der Cookiebanner die Einwilligung von Google nicht unterstützt, kann der Sellsite default in der Shop-Konfiguration angepasst werden:
google { # Settings for the consent information consent { # Controls whether Google Analytics should send the consent information. enabled = true # Controls the default consent to informations like user data. # Allowed values are "granted" and "denied" defaultConsent = "denied" # Controls whether Google Analytics should be initialized if the data should be redacted. adsDataRedaction = true } }