[UA→GA4] Tipps für den Wechsel von Analytics.js zu gtag.js
Über das gtag.js-Snippet
Wenn Sie Analytics.js für Ihre aktuelle Universal Analytics-Property verwenden, müssen Sie das gtag.js-Snippet für Ihre neue Google Analytics 4-Property hinzufügen. Das gtag.js-Snippet hat die folgende Struktur:
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>
02: <script>
03: window.dataLayer = window.dataLayer || [];
04: function gtag(){dataLayer.push(arguments);}
05: gtag('js', new Date());
06:
07: gtag('config', '<Some Property ID A>');
08:
09: gtag('config', '<Some Property ID B>');
10:
11: gtag('event', 'sign_up', { 'method': 'email' });
12:
13: gtag('event', 'view_video', { 'send_to': '<Some Property ID B>' });
14:
15: </script>
Zeile 7: Die gtag-Anweisung „config" ermöglicht die Datenerfassung für die Eigenschaft, die mit <Some Property ID A> verknüpft ist. Wenn Sie beispielsweise diese Anweisung mit einer Tag-ID für eine Google Analytics 4-Property hinzufügen, werden page_view Ereignisse an diese Property gesendet.
Die Property-ID kann verschiedene Google-Produkte repräsentieren, darunter UA-Property („UA-XXXXXXXX"), Google Analytics 4-Property („G-XXXXXXXX"), Ads („AW-XXXXXXXX") oder Floodlight („DC-XXXXXXXX").
Zeile 11: Die gtag-Direktive „event" sendet ein Ereignis. In Snippets, in denen mehrere „config"-Anweisungen für mehrere Eigenschaften vorhanden sind, wird das Ereignis an alle Eigenschaften gesendet.
In diesem Beispiel ist der Parameter „sign_up" der Ereignisname. Der letzte Parameter ist ein Objekt, das eine Reihe von Ereignisparametern enthält. In diesem Fall ist „Methode" ein Parameter mit dem Wert „E-Mail".
Zeile 13: Das Event hier hat „send_to" als Parameter. Dies ist ein spezieller Parameter, der das zugehörige Ereignis an eine bestimmte Eigenschaft „weiterleitet". Mit anderen Worten: Dieses Ereignis wird nur an die durch <Some Property ID B> angegebene Eigenschaft gesendet.
Die grundlegende Datenerfassung für eine Google Analytics 4-Property wird über die gtag-Anweisung „config" aktiviert und ermöglicht die Erfassung von page_view-Ereignissen als automatisch erfasstes Ereignis, wenn es auf einer Seite geladen wird.
Der Seitenaufruf-Treffer oder das page_view-Ereignis kann mithilfe bestimmter Parameter geändert oder blockiert werden.
Eigenschaftsbezeichner
Universal Analytics-Property-IDs haben das Format „UA-XXXXXXXX". Dies wird manchmal als Tracking-ID bezeichnet. In diesem Handbuch bezeichnen wir sie als UA-Property-ID.
Webdatenströme für Google Analytics 4-Eigenschaften verwenden eine Tag-ID im Format „G-XXXXXXXX".
In einigen Codebeispielen und in der Dokumentation werden beide möglicherweise als „TAG_ID" bezeichnet.
Grundlegende Datenerfassung
Durch die Aktivierung der grundlegenden Datenerfassung für eine Google Analytics 4-Property können folgende Daten erfasst werden:
- page_view-Ereignisse
- automatisch erfasste Ereignisse
- erweiterte Messereignisse (falls in der Benutzeroberfläche aktiviert)
Um die grundlegende Datenerfassung für Ihre Google Analytics 4-Property zu aktivieren, fügen Sie das gtag.js-Snippet (das Google-Tag) zum Abschnitt <head> jeder Seite hinzu.
gtag.js-Snippet im Vergleich zum Analytics.js-Snippet
Das gtag.js-Snippet für eine Google Analytics 4-Property dient einem ähnlichen Zweck wie das Analytics.js-Snippet für eine Universal Analytics-Property.
Der größte Unterschied zwischen diesen beiden Snippets besteht darin, dass der Analytics.js-Code einen separaten „Send Pageview"-Aufruf enthält, während der gtag.js-Code dies nicht tut. In gtag.js ist der Seitenaufruf ein automatisch erfasstes Ereignis, das zusammen mit der „config"-Direktive gesendet wird.
Universal Analytics-Eigenschaft (analytics.js)
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'TAG_ID', 'auto');
ga('send', 'pageview');
</script>
Google Analytics 4-Property (gtag.js)
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'TAG_ID');
</script>
Konfigurationseinstellungen für gtag.js
Sie können das grundlegende gtag.js-Snippet konfigurieren, um Datenerfassungseinstellungen wie IP-Maskierung, Cookie-Anpassungen und Google-Signale ähnlich wie Analytics.js zu steuern. Sie tun dies über die Direktiven „config" oder „set" in gtag.js (im Gegensatz zu den Direktiven „set", „create" und „require" in Analytics.js).
Google Analytics 4-Eigenschaften („G-XXXXXXXX") unterstützen die Implementierung ähnlicher Konfigurationseinstellungen über gtag.js. Es gibt Unterschiede zwischen diesen Einstellungen für Universal Analytics- und Google Analytics 4-Properties. Beachten Sie die folgenden Überlegungen:
- Die IP-Maskierung ist auf „true" standardisiert und in einer Google Analytics 4-Property nicht konfigurierbar. Daher wird die IP-Adresse automatisch mit dem Standardereignis für die Google Analytics 4-Eigenschaft („G-XXXXXXXX") maskiert .
- Wenn globale Einstellungen auf alle konfigurierten Eigenschaften angewendet werden müssen, sollte der Befehl „set" in gtag.js verwendet werden, um sie auf alle Tag-IDs und/oder Eigenschafts-IDs anzuwenden.
- Achten Sie besonders auf Werbe- und Anzeigenpersonalisierungsfunktionen in Analytics.js, die meist mit einer „set"-Zeile implementiert werden.
Wenn Sie in Ihrer aktuellen Analytics.js-Implementierung die Direktiven „set", „create" und „require" verwenden, prüfen Sie, welche automatisch in einer Google Analytics 4-Property festgelegt werden und welche im Google Analytics 4-Property-Code angegeben werden müssen ( Parameterzuordnung).
Einige Beispielkonfigurationen mit ihren Codebeispielen in Analytics.js (für die UA-Eigenschaft) und gtag.js (für die Google Analytics 4-Eigenschaft) sind unten aufgeführt:
Grundlegende Datenerfassung aktivieren; Benutzer-ID konfigurieren
Analytics.js
ga('create', 'TAG_ID', 'auto', {
userId: USER_ID
});
ga('send', 'pageview');
gtag.js
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID'
});
Cookie-Einstellungen konfigurieren
Analytics.js
ga('create', 'TAG_ID', {
'cookieName': 'gaCookie',
'cookieDomain': 'blog.example.co.uk',
'cookieExpires': 60 * 60 * 24 * 28 // Time in seconds.
});
gtag.js
gtag('config', 'TAG_ID', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 days, in seconds
});
Blockieren Sie ein page_view-Ereignis
Wenn beim Laden des Konfigurationscodes kein page_view-Ereignis gesendet werden muss (z. B. wenn ein Iframe geladen wird), können Sie die Konfigurationseinstellung anpassen, um das page_view-Ereignis zu blockieren . Stellen Sie sich ein Szenario vor, in dem ein page_view-Ereignis gesendet wird und sich anschließend ein Benutzer bei der Site anmeldet. Für die Anmeldeinteraktion würden Sie eine „config"-Direktive verwenden, um die Benutzer-ID festzulegen, aber Sie möchten kein weiteres page_view-Ereignis senden. Der folgende Code veranschaulicht, wie verhindert werden kann, dass das Ereignis „page_view" gesendet wird.
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
Tag-Namen
Tag-Namen (sogenannte „Tracker") werden verwendet, wenn Sie Daten an verschiedene Universal Analytics-Properties in Analytics.js senden möchten. In Analytics.js definieren die Tracker, an welche Property Sie die Daten senden möchten. Bei Treffern nach dem ersten „Erstellen"-Treffer muss nicht mehr die Universal Analytics-Property-ID, sondern nur noch der Tracker-Name angegeben werden.
In gtag.js sind Tracker weder für Google Analytics 4- noch für Universal Analytics-Properties verfügbar. Wenn Sie alle Treffer an mehrere Properties (verschiedene Datenströme in einer Google Analytics 4-Property) senden möchten, geben Sie in der Zeile „config" alle Tag-IDs bzw. Property-IDs an.
Veranstaltungen
Weitere Informationen finden Sie im Leitfaden zur Ereignismigration .Benutzerdefinierte Dimensionen und Metriken
Benutzerdefinierte Dimensionen und Metriken werden verwendet, um die auf der Website gemessenen Informationen zu erweitern und um Offline-Daten beispielsweise aus CRM-Systemen zu importieren. In einer Universal Analytics-Property („UA-XXXXXXXX") müssen benutzerdefinierte Dimensionen und Metriken in der Benutzeroberfläche erstellt werden, ihnen wird eine ID zugewiesen und sie können dann implementiert oder importiert werden. Sie können mit vier verschiedenen Geltungsbereichen erstellt werden: Treffer, Sitzung, Benutzer, Produkt.
In einer Google Analytics 4-Property („G-XXXXXXXX") wird der Anwendungsfall für benutzerdefinierte Dimensionen und Messwerte auf andere Weise implementiert. Benutzerdefinierte Dimensionen und Metrikmessungen in UA-Property, die über Analytics.js implementiert wurden, müssen als Parameter in einer Google Analytics 4-Property erneut implementiert werden.
Eine benutzerdefinierte Dimension für eine Universal Analytics-Property kann über Analytics.js wie folgt implementiert werden:
ga('send', 'event', 'category_value', 'action_name', {'dimension5': 'custom data'
});
ODER
ga('set', 'dimension5', 'custom data');
Diese benutzerdefinierten Dimensionen können über gtag.js wie folgt in eine Google Analytics 4-Property übersetzt werden:
gtag('event', 'action_name', {'eventCategory': 'category_value',
'dimension5': 'custom data'
});
ODER
gtag('set', {'dimension5': 'custom data'});
Es gibt zwei Vorbehalte:
- Parameter müssen in der Benutzeroberfläche registriert werden, damit sie in Berichten angezeigt werden. Dies ist ein vergleichbarer Prozess mit der Registrierung benutzerdefinierter Dimensionen in Universal Analytics (es gelten Einschränkungen). Sie müssen sie nicht registrieren, wenn Sie sich nur exportierte Daten ansehen oder den Parameter nur zur Zielgruppenaktivierung verwenden.
- Der Umfang benutzerdefinierter Parameter liegt immer auf Ereignisebene, vergleichbar mit dem Trefferumfang. Dies gilt auch für benutzerdefinierte Dimensionen, die automatisch in Parameter übersetzt werden (für gtag.js „UA-XXXXXXXX"-Implementierungen), unabhängig von der ursprünglichen Einstellung des benutzerdefinierten Dimensionsbereichs.
Die gleichen Zuordnungen und Überlegungen gelten für benutzerdefinierte Metriken, mit der Ausnahme, dass sie bei der Registrierung für die Berichterstellung auf numerische Parametergrenzen und nicht auf Textparametergrenzen angerechnet werden.
Konzeptionell werden benutzerdefinierte Dimensionen und Messwerte unterschiedlichen Umfangs in einer Universal Analytics-Property einer Google Analytics 4-Property zugeordnet als:
- Benutzerdefinierte Dimension auf Trefferebene: Parameter (maximal 25 Gesamtparameter, die pro Ereignis während der Datenerfassung protokolliert werden; max. 50 benutzerdefinierte Dimensionen/50 benutzerdefinierte Metriken)
Bitte beachten Sie, dass automatisch erfasste Ereignisse und Parameter möglicherweise bereits einige Anwendungsfälle abdecken, in denen zuvor benutzerdefinierte Dimensionen mit Trefferbereich verwendet wurden - Benutzerbezogene benutzerdefinierte Dimension: Benutzereigenschaften (maximal 25 registriert für die Berichterstellung über die Benutzeroberfläche). Automatisch erfasste Benutzerdimensionen werden nicht auf dieses Limit angerechnet.
- Benutzerdefinierte Dimension im Sitzungsbereich: keine Entsprechung in der Google Analytics 4-Property; Suchen Sie stattdessen nach benutzerdefinierten Parametern oder Benutzereigenschaften.
Best Practices für Benutzereigenschaften
Benutzereigenschaften bleiben einem Benutzer über verschiedene Plattformen hinweg erhalten (z. B. über alle Datenstromtypen hinweg) und sollten daher nur verwendet werden, wenn die Daten auf Benutzerebene gelten sollen. Benutzereigenschaften sollten nicht für Daten auf Sitzungs- oder Geräteebene (z. B. Bildschirmgröße) verwendet werden.
Beispiel für eine Google Analytics 4-Eigenschaft
gtag('set', 'user_properties', {
favorite_composer: 'Mahler',
favorite_instrument: 'double bass',
season_ticketholder: 'true'
});
No comments:
Post a Comment