Von analytics.js zu gtag.js (Universal Analytics) migrieren

In diesem Leitfaden wird Schritt für Schritt erklärt, wie Sie eine analytics.js Universal Analytics-Implementierung zur Verwendung mit gtag.js migrieren.

Überblick

analytics.js hat zwei Hauptmechanismen zum Senden von Daten an Google Analytics:

  1. Tracker

    Tracker geben an, welche Property erfasst wird.

  2. Treffertypen

    Mit Treffertypen wird angegeben, welche Art von Interaktion erfasst wird.

In 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 durch ihre mit dem Befehl config festgelegten IDs identifiziert werden. Die an gtag.js gesendeten Ereignisnamen geben die Datentypen an, 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 Folgendes tun:

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. Über gtag.js werden Seitenaufrufe an eine Google Analytics-Property gesendet, die durch TAG_ID in einem config-Befehl 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 analysieren

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 TAG_ID in einem config-Befehl identifiziert wird.

Ereignisse mit dem Standard-Tracker messen

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]);

Führen Sie den folgenden gtag.js-Befehl event aus:

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 jeden analytics.js-send-Befehl auf Ihren Webseiten, der benutzerdefinierte Dimensionen an Google Analytics sendet:

ga('send', 'hitType', { 'dimension&lt;Index&gt;':  'dimension_value'});

mit dem folgenden gtag.js:

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'});

mit dem folgenden gtag.js:

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, die Nutzertimings erfassen:

ga('send', 'timing', 'timingCategory', 'timingVar', timingValue, 'timingLabel');

Führen Sie den folgenden gtag.js event-Befehl aus:

gtag('event', 'timing_complete', {
  'name': 'timingVar',
  'value': timingValue,
  'event_category': 'timingCategory',
  'event_label': 'timingLabel'
});

Ausnahmen messen

Ersetzen Sie alle analytics.js-send-Befehle in Ihren Webseiten, die Ausnahmen verfolgen:

ga('send', 'exception', {
  'exDescription': 'error_message',
  'exFatal': false  // set to true if the exception is fatal
});

Führen Sie folgenden gtag.js-Befehl event aus:

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 nachfolgender Schritt) 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