Diese Seite wurde von der Cloud Translation API übersetzt.

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

In diesem Leitfaden wird die Migration einer vorhandenen analytics.js Universal Analytics-Implementierung zur Verwendung von gtag.js beschrieben.

Übersicht

Das Senden von Daten an Google Analytics umfasst zwei Hauptmechanismen: analytics.js

tracker

Mit Trackern wird angegeben, welche Property gemessen wird.
Treffertypen

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

In gtag.js werden Attribute über den 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 an, welche Datentypen an Google Analytics gesendet werden.

So migrieren Sie von analytics.js zu gtag.js:

Ersetzen Sie das analytics.js-Snippet durch das gtag.js-Snippet.
Ersetzen Sie analytics.js-Code durch einen entsprechenden gtag.js-Code, um:

Ersetzen Sie das analytics.js-Snippet durch das gtag.js-Snippet.

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

Mit analytics.js werden Tracker verwendet, um Seitenaufrufe an Google Analytics zu senden. Ein Tracker hat die Mess-ID einer Google Analytics-Property. Mit gtag.js werden Seitenaufrufe an eine Google Analytics-Property gesendet, die durch die in einem config-Befehl angegebene TAG_ID identifiziert wird.

Seitenaufrufe mit dem Standard-Tracker messen

Entfernen Sie den folgenden analytics.js-Code, der den Standard-Tracker verwendet, um Seitenaufrufe send zu Google Analytics zu erfassen:

// 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 an die Google Analytics-Property mit der Tag-ID TAG_ID gesendet:

gtag('config', 'TAG_ID');

Seitenaufrufe mit angegebenen Trackern messen

Ersetzen Sie den folgenden analytics.js-Code mit dem angegebenen Tracker, um Seitenaufrufe an Google Analytics zu senden:

ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'pageview');

mit dem folgenden event-Befehl in gtag.js:

gtag('event', 'page_view', { 'send_to': 'TAG_ID' });

Ereignisse erfassen

Wie bereits erwähnt, sendet analytics.js Tracker, 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 die in einem config-Befehl angegebene TAG_ID identifiziert wird.

Ereignisse mit dem Standard-Tracker messen

Ersetzen Sie den folgenden analytics.js-Code, der den Standard-Tracker verwendet, um send-Ereignisse in Google Analytics zu erfassen:

ga('create', 'TAG_ID', 'auto');
ga('send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);

mit dem folgenden gtag.js-event-Befehl:

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 angegebenen Trackern messen

Ersetzen Sie den folgenden analytics.js-Code mit dem angegebenen Tracker, um Ereignisse an Google Analytics zu senden:

ga('create', 'TAG_ID', 'auto', 'trackerName');
ga('trackerName.send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);

mit dem folgenden event-Befehl in gtag.js:

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 auf Ihren Webseiten einen beliebigen analytics.js-sendBefehl, über den benutzerdefinierte Dimensionenan Google Analytics gesendet werden:

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

mit dem 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-Befehle sendauf Ihren Webseiten, diebenutzerdefinierte Messwerte an Google Analytics senden:

ga('send', 'hitType', { 'metric<Index>':  'metric_value'});

mit dem 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 auf Ihren Webseiten den send-Befehl „analytics.js“, der das Nutzertiming erfasst:

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 analysieren

Ersetzen Sie auf Ihren Webseiten den send-Befehl send, der Ausnahmen erfasst:

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

Die Felder „analytics.js“ gtag.js-Parametern zuordnen

In den folgenden Tabellen werden analytics.js-Felder den entsprechenden gtag.js-Parametern zugeordnet.

Events

analytics.js-Feld	gtag.js-Parameter
`eventAction`	`event_action`
`eventCategory`	`event_category`
`eventLabel`	`event_label`
`eventValue`	`value`

Benutzerdefinierte Dimensionen und Messwerte

analytics.js-Feld	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

analytics.js-Feld	gtag.js-Parameter
`timingCategory`	`event_category`
`timingLabel`	`event_label`
`timingValue`	`value`
`timingVar`	`name`

Ausnahmemessung

analytics.js-Feld	gtag.js-Parameter
`exDescription`	`description`
`exFatal`	`fatal`

Daten zu erweiterten E-Commerce-Aktionen

analytics.js-Feld	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

analytics.js-Feld	gtag.js-Parameter
`creative`	`creative_name`
`position` (Impression, Produkt)	`list_position`
`position` (Angebot)	`creative_slot`

Aktionen für Produkte und Angebote

analytics.js-Feld	gtag.js-Ereignis
`add`	`add_to_cart`
`checkout` (erster Schritt)	`begin_checkout`
`checkout` (alle nachfolgenden Schritte)	`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

analytics.js-Feld	gtag.js-Parameter
`clientId`	`client_id`
`userId`	`user_id`