Sunday, September 3, 2023

[UA→GA4] Wie gtag.js für UA GA4 zugeordnet wird – Analytics-Hilfe [gg-analytics-en]

[UA→GA4] Wie gtag.js für UA GA4 zugeordnet wird

Dies ist ein Implementierungsleitfaden für Websitebesitzer, die die gtag.js-Bibliothek verwenden und verstehen möchten, wie gtag.js für Universal Analytics (UA) Google Analytics 4 zugeordnet wird. Es wird davon ausgegangen, dass Sie bereits eine Google Analytics 4-Property erstellt haben. Wenn Sie nur den grundlegenden Messcode zu Ihrer Website hinzufügen müssen, lesen Sie stattdessen diesen Artikel .
In diesem Artikel :

Ü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:

  1. 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.
  2. 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:

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.
Wenn auf Ihrer Seite sowohl ein gtag.js-Tag als auch ein GTM-Container implementiert sind, muss das gtag.js-Tag über dem GTM-Container platziert werden, damit verbundene Site-Tags funktionieren.

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.

  • 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.

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