In diesem Leitfaden wird beschrieben, wie Sie eine analytics.js
-Universal Analytics-Implementierung zur Verwendung von gtag.js
migrieren.
Überblick
analytics.js hat zwei Hauptmechanismen zum Senden von Daten an Google Analytics:
-
Tracker geben an, welche Eigenschaft Sie messen.
-
Mit Treffertypen wird angegeben, welche Art von Interaktion erfasst wird.
Unter gtag.js
werden Attribute mit dem Befehl config
oder als Parameter für einen Befehl angegeben.
Im Gegensatz zu analytics.js werden bei gtag.js keine Tracker verwendet, um Daten an Google Analytics zu senden. Er sendet Daten an Google Analytics-Properties, die anhand ihrer mit dem Befehl config
festgelegten IDs identifiziert werden. Mit den Ereignisnamen, die für gtag.js bereitgestellt werden, werden die Arten von Daten angegeben, die an Google Analytics gesendet werden.
Wenn Sie von analytics.js zu gtag.js migrieren möchten, müssen Sie für jede Webseite Ihrer Website folgende Schritte ausführen:
Ersetzen Sie das analytics.js-Snippet durch das gtag.js-Snippet.
Ersetzen Sie den analytics.js-Code durch den entsprechenden gtag.js-Code:
analytics.js-Snippet durch gtag.js-Snippet ersetzen
Ersetzen Sie das analytics.js-Snippet auf Ihrer Webseite:
<!-- Google Analytics -->
<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>
<!-- End Google Analytics -->
mit dem folgenden gtag.js-Snippet:
<!-- Google tag (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>
Seitenaufrufe messen
analytics.js verwendet Tracker, um Seitenaufrufe an Google Analytics zu senden. Ein Tracker hat die Mess-ID einer Google Analytics-Property. gtag.js sendet Seitenaufrufe an eine Google Analytics-Property, die durch den in einem config
-Befehl angegebenen TAG_ID
identifiziert wird.
Seitenaufrufe mit dem Standard-Tracker messen
Entfernen Sie den folgenden analytics.js-Code, der den Standard-Tracker verwendet, um send
-Seitenaufrufe an Google Analytics zu senden:
// Creates the default tracker.
ga('create', 'TAG_ID', 'auto');
// Uses the default tracker to send a pageview to the
// Google Analytics property with tag ID of 'TAG_ID'.
ga('send', 'pageview');
Mit dem folgenden Code im gtag.js-Snippet wird automatisch ein Seitenaufruf mit der Tag-ID TAG_ID
an die Google Analytics-Property gesendet:
gtag('config', 'TAG_ID');
Seitenaufrufe mit bestimmten Trackern messen
Ersetzen Sie den folgenden analytics.js-Code, der über den angegebenen Tracker Seitenaufrufe an Google Analytics sendet:
ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'pageview');
mit dem folgenden gtag.js-Befehl event
:
gtag('event', 'page_view', { 'send_to': 'TAG_ID' });
Ereignisse erfassen
Wie bereits erwähnt, werden bei analytics.js Tracker verwendet, um Ereignisse an Google Analytics zu senden. Ein Tracker hat die Tracking-ID einer Google Analytics-Property. Im Gegensatz dazu sendet gtag.js Ereignisse an eine Google Analytics-Property, die durch den in einem config
-Befehl angegebenen TAG_ID
identifiziert wird.
Ereignisse mit dem Standard-Tracker erfassen
Ersetzen Sie den folgenden analytics.js-Code, der den Standard-Tracker für send
-Ereignisse in Google Analytics verwendet:
ga('create', 'TAG_ID', 'auto');
ga('send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);
mit dem folgenden gtag.js-Befehl event
:
gtag('event', eventName, eventParameters);
Dabei ist eventName
der Name des Ereignisses, das Sie protokollieren möchten.
Beispiel:
analytics.js:
// Creates the default tracker.
ga('create', 'TAG_ID', 'auto');
// Uses the default tracker to send the event to the
// Google Analytics property with a tag ID of `TAG_ID`.
ga('send', 'event', 'Videos', 'play', 'Fall Campaign');
gtag.js:
// Sends the event to the Google Analytics property with a
// tag ID of `TAG_ID` set by the config command in
// the gtag.js snippet.
gtag('event', 'play', {
'event_category': 'Videos',
'event_label': 'Fall Campaign'
});
Ereignisse mit bestimmten Trackern messen
Ersetzen Sie den folgenden analytics.js-Code, der über den angegebenen Tracker Ereignisse an Google Analytics sendet:
ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);
mit dem folgenden gtag.js-Befehl event
:
gtag('event', eventName, {
'send_to': 'TAG_ID',
'parameter1': 'value1',
'parameter2': 'value2',
// ...
});
Beispiel:
analytics.js:
// Creates a tracker named <b>clientTracker</b>.
ga('create', 'TAG_ID', 'auto', 'clientTracker');
// Uses tracker clientTracker to send the event to the
// Google Analytics property with a tag ID of TAG_ID.
ga('clientTracker.send', 'event', 'Videos', 'play', 'Fall Campaign');
gtag.js:
// Send the event to the Google Analytics property
// with a tag ID of 'TAG_ID'.
gtag('event', 'play', {
'send_to': 'TAG_ID',
'event_category': 'Videos',
'event_label': 'Fall Campaign'
});
Benutzerdefinierte Dimensionen und Messwerte senden
Ersetzen Sie alle analytics.js-send
-Befehle auf Ihren Webseiten, die benutzerdefinierte Dimensionen an Google Analytics senden:
ga('send', 'hitType', { 'dimension<Index>': 'dimension_value'});
durch den folgenden gtag.js-Code:
gtag('config', 'TAG_ID', {
'custom_map': {'dimension<Index>': 'dimension_name'}
});
gtag('event', 'any_event_name', {'dimension_name': 'dimension_value'});
Ersetzen Sie TAG_ID
durch Ihre eigene Analytics-ID.
Ersetzen Sie alle analytics.js-send
-Befehle auf Ihren Webseiten, die benutzerdefinierte Messwerte an Google Analytics senden:
ga('send', 'hitType', { 'metric<Index>': 'metric_value'});
durch den folgenden gtag.js-Code:
gtag('config', 'TAG_ID', {
'custom_map': {'metric<Index>': 'metric_name'}
});
gtag('event', 'any_event_name', {'metric_name': 'metric_value'});
Ersetzen Sie TAG_ID
durch Ihre Tag-ID.
Nutzertiming messen
Ersetzen Sie alle analytics.js-send
-Befehle auf Ihren Webseiten, mit denen das Nutzertiming erfasst wird:
ga('send', 'timing', 'timingCategory', 'timingVar', timingValue, 'timingLabel');
mit dem folgenden gtag.js event
-Befehl:
gtag('event', 'timing_complete', {
'name': 'timingVar',
'value': timingValue,
'event_category': 'timingCategory',
'event_label': 'timingLabel'
});
Ausnahmen messen
Ersetzen Sie alle analytics.js-send
-Befehle auf Ihren Webseiten, mit denen Ausnahmen erfasst werden:
ga('send', 'exception', {
'exDescription': 'error_message',
'exFatal': false // set to true if the exception is fatal
});
mit dem folgenden gtag.js-Befehl event
:
gtag('event', 'exception', {
'description': 'error_message',
'fatal': false // set to true if the exception is fatal
});
analytics.js-Felder gtag.js-Parametern zuordnen
In den folgenden Tabellen werden analytics.js-Felder den entsprechenden gtag.js-Parametern zugeordnet.
Veranstaltungen
Feld „analytics.js“ | gtag.js-Parameter |
---|---|
eventAction |
event_action |
eventCategory |
event_category |
eventLabel |
event_label |
eventValue |
value |
Benutzerdefinierte Dimensionen und Messwerte
Feld „analytics.js“ | gtag.js-Parameter |
---|---|
dimension<Index> |
dimension<Index> |
metric<Index> |
metric<Index> |
Dabei ist <Index>
eine nicht negative Ganzzahl, die den Index der benutzerdefinierten Dimension oder des benutzerdefinierten Messwerts darstellt.
Nutzertiming
Feld „analytics.js“ | gtag.js-Parameter |
---|---|
timingCategory |
event_category |
timingLabel |
event_label |
timingValue |
value |
timingVar |
name |
Messung von Ausnahmen
Feld „analytics.js“ | gtag.js-Parameter |
---|---|
exDescription |
description |
exFatal |
fatal |
Erweiterte E-Commerce-Aktionsdaten
Feld „analytics.js“ | gtag.js-Parameter |
---|---|
id |
transaction_id |
affiliation |
affiliation |
revenue |
value |
tax |
tax |
shipping |
shipping |
coupon |
coupon |
list |
list_name |
step |
checkout_step |
option |
checkout_option |
Angebotsdaten
Feld „analytics.js“ | gtag.js-Parameter |
---|---|
creative |
creative_name |
position (Impression, Produkt) |
list_position |
position (Angebot) |
creative_slot |
Aktionen für Produkte und Angebote
Feld „analytics.js“ | gtag.js-Ereignis |
---|---|
add |
add_to_cart |
checkout (erster Schritt) |
begin_checkout |
checkout (beliebiger Folgeschritt) |
checkout_progress |
checkout_option |
set_checkout_option |
click |
select_content (ohne Angebote) |
detail |
view_item |
promo_click |
select_content (mit Angeboten) |
purchase |
purchase |
refund |
refund |
remove |
remove_from_cart |
Client-ID und User-ID
Feld „analytics.js“ | gtag.js-Parameter |
---|---|
clientId |
client_id |
userId |
user_id |