[UA→GA4] Wie gtag.js für UA GA4 zugeordnet wird
Über das gtag.js-Snippet und die Property-IDs
Die gtag.js-Snippets für eine Universal Analytics-Property und für eine Google Analytics 4-Property sind grundsätzlich identisch. Beide Snippets haben folgenden Aufbau:
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 1: Wenn Sie eine Universal Analytics-Property über gtag.js implementiert haben, ist diese Codezeile wahrscheinlich bereits auf Ihrer Website vorhanden. Anstelle von <Some Property ID A> sehen Sie „UA-", gefolgt von einer Reihe von Zahlen. Wenn Sie gtag.js für Google Ads oder ein anderes Google Marketing Platform-Produkt implementiert haben, verfügen Sie möglicherweise auch über diese Codezeile auf Ihrer Website, aber <Some Property ID A> beginnt mit „AW-" oder „DC-".
Die durch <Some Property ID A> angegebene Property-ID (oder Tag-ID für Google Analytics 4-Properties) „steuert" dieses gtag.js-Snippet. Dies ist wichtig, weil:
- Wenn diese Zeile bereits vorhanden ist, muss sie nicht ein zweites Mal implementiert werden. Sie müssen lediglich eine „config"-Zeile hinzufügen, um die Tag-ID anzugeben.
- Die Eigenschafts-ID in dieser Zeile ist der „Controller" des gtag.js-Snippets. Wenn eine Universal Analytics-Property-ID („UA-XXXXXXXX") das Tag steuert, können Sie verbundene Website-Tags verwenden, um Messdaten an eine Google Analytics 4-Property zu senden, ohne der Seite neuen Code hinzufügen zu müssen.
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 in einer Google Analytics 4-Property diese Anweisung mit einer Tag-ID hinzufügen, werden page_view-Ereignisse an diese Property gesendet.
Die Property-ID kann eine Messung für verschiedene Google-Produkte darstellen, einschließlich einer Universal Analytics-Property („UA-XXXXXXXX"), einer Google Analytics 4-Property („G-XXXXXXXX"), Google 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 sendet. Mit anderen Worten: Dieses Ereignis wird nur an die durch <Some Property ID B> angegebene Eigenschaft gesendet.
Der Befehl gtag config
ermöglicht die grundlegende Messung.
- Bei einer Universal Analytics-Property sendet die „config" mit einer Universal Analytics-Property-ID einen Seitenaufruf-Treffer.
- Für eine Google Analytics 4-Property ermöglicht die „config" mit einer Tag-ID die Erfassung von page_view-Ereignissen (als automatisch erfasstes Ereignis), wenn sie auf einer Seite geladen wird.
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.
Google Analytics 4-Property-Webdatenströme 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 (sofern in der Benutzeroberfläche aktiviert)
Wenn Ihre bestehende Universal Analytics-Property eine gtag.js-Implementierung verwendet, aktivieren Sie die grundlegende Datenerfassung für Ihre Google Analytics 4-Property, indem Sie:
- Option 1: Hinzufügen einer neuen „config"-Direktive mit der relevanten Tag-ID
ODER - Option 2: Tags für verbundene Websites aktivieren (sofern Ihre vorhandene gtag.js-Implementierung dafür geeignet ist)
Unabhängig davon, für welche Option Sie sich entscheiden, bleibt Ihre bestehende Universal Analytics-Property davon unberührt und erfasst weiterhin Daten.
Option 1: Fügen Sie eine neue „config"-Direktive hinzu
Wenn auf der Seite vorhandener gtag.js-Code vorhanden ist, fügen Sie einfach eine zusätzliche „config"-Anweisung mit der Mess-ID der entsprechenden Google Analytics 4-Property hinzu. Im folgenden Beispiel wurde Zeile 8 zu einer vorhandenen gtag.js-Implementierung hinzugefügt. Es verweist auf die Mess-ID der Google Analytics 4-Property. Dadurch werden page_view-Ereignisse an diese Google Analytics 4-Property gesendet. Außerdem werden automatisch erfasste Ereignisse und erweiterte Messereignisse (sofern Sie die erweiterte Messung aktiviert haben) in dieser Google Analytics 4-Property aktiviert. 1: <script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>
2: <script>
3: window.dataLayer = window.dataLayer || [];
4: function gtag(){dataLayer.push(arguments);}
5: gtag('js', new Date());
6:
7: gtag('config', '<Some Property ID A>');
8: gtag('config', 'G-XXXXXXXX');
9: </script>
Option 2: Aktivieren Sie verbundene Site-Tags
Sie können ein verbundenes Site-Tag verwenden, wenn:
- Das vorhandene gtag.js-Snippet auf der Seite, auf der Sie Benutzerinteraktionen messen möchten, wird von einer Universal Analytics-Eigenschaft „gesteuert" (d. h. die ID, auf die in dieser Zeile des gtag.js-Snippets verwiesen wird, beginnt mit „UA-"):
<script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>
(Verbundene Site-Tags funktionieren auch, wenn das vorhandene gtag.js-Snippet von einer Google Analytics 4-Property gesteuert wird. Diese Situation tritt jedoch nur auf, wenn bereits eine Google Analytics 4-Property implementiert wurde.)
- UND Sie haben Administratorzugriff auf die Universal Analytics-Property, auf die durch die ID im Snippet verwiesen wird.
Konfigurationseinstellungen für gtag.js
Sie können das grundlegende gtag.js-Snippet konfigurieren , um Datenerfassungseinstellungen wie IP-Masking, Cookie-Anpassungen und Google Signals zu steuern. Sie tun dies über die Direktiven „config" oder „set" in gtag.js.
Sowohl Universal Analytics („UA-XXXXXXXX") als auch Google Analytics 4 („G-XXXXXXXX")-Properties unterstützen die Implementierung dieser Konfigurationseinstellungen über gtag.js. Es gibt jedoch einige Unterschiede zwischen diesen Einstellungen für Universal Analytics- und Google Analytics 4-Properties.
- 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" verwendet werden, um sie auf alle Mess-IDs und/oder Eigenschafts-IDs anzuwenden, einschließlich derjenigen, die über verbundene Site-Tags implementiert werden.
- Achten Sie besonders auf die Funktionen zum Deaktivieren der Anzeigenpersonalisierung, die meist mit einer „config"-Zeile implementiert werden.
- Bei Verwendung verbundener Site-Tags: Alle im gtag.js-Code mit „config" vorgenommenen Konfigurationen gelten nur für die Eigenschaft, die mit der Mess-ID in dieser Codezeile verknüpft ist . Diese werden nicht automatisch an die verbundene Google Analytics 4-Property gesendet. Wenn Sie möchten, dass die Konfiguration auf die verbundene Google Analytics 4-Property angewendet wird,
- Erstellen Sie eine separate „config"-Anweisung und wenden Sie sie auf die entsprechende Google Analytics 4-Property an, indem Sie auf die Mess-ID verweisen
ODER - Konfigurieren Sie die Einstellung mithilfe einer „set"-Direktive. In diesem Fall wird die Konfiguration auf alle konfigurierten Eigenschaften angewendet.
- Erstellen Sie eine separate „config"-Anweisung und wenden Sie sie auf die entsprechende Google Analytics 4-Property an, indem Sie auf die Mess-ID verweisen
Konfigurationsbeispiele
Grundlegende Datenerfassung aktivieren; Konfigurieren Sie die Benutzer-ID
gtag('config', 'GA_MEASUREMENT_ID', {
'user_id': 'USER_ID'
});
Cookie-Einstellungen konfigurieren
gtag('config', 'GA_MEASUREMENT_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 verwenden Sie eine „config"-Direktive, um die Benutzer-ID festzulegen, möchten aber kein weiteres page_view-Ereignis senden. Der folgende Code veranschaulicht, wie verhindert werden kann, dass das Ereignis „page_view" gesendet wird.
gtag('config', 'MEASUREMENT_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
Veranstaltungen
Weitere Informationen finden Sie im Leitfaden zur Ereignismigration .
Benutzerdefinierte Dimensionen und Metriken
Benutzerdefinierte Dimensionen und Metriken können zur Erweiterung der Informationen und zum Import von Offline-Daten, z. B. aus CRM-Systemen, verwendet werden.
Bei Verwendung des Google-Tags (gtag.js) werden benutzerdefinierte Dimensionen und Metrikmessungen automatisch in Parameter übersetzt, wenn verbundene Website-Tags oder eine Google Analytics 4-Eigenschaft (z. B. „G-XXXXXXXX") verwendet werden.
Erfahren Sie mehr über benutzerdefinierte Dimensionen und Metriken.
No comments:
Post a Comment