Felddaten abrufen und festlegen

Für das Abrufen und Festlegen von Felddaten auf einem Tracker ist manchmal ein Verweis auf das Tracker-Objekt selbst erforderlich. Da Befehle, die der ga()-Befehlswarteschlange hinzugefügt werden, asynchron ausgeführt werden und keinen Wert zurückgeben, und da Tracker in der Regel mit dem Befehl create erstellt werden, muss für den Abruf eines Verweises auf ein Tracker-Objekt gewartet werden, bis der create-Befehl ausgeführt wurde. Dazu können Sie den bereits Callback verwenden.

Der Bereitschafts-Callback

Der bereite Callback ist eine Funktion, die Sie der ga()-Befehlswarteschlange hinzufügen können. Die Funktion wird aufgerufen, sobald die analytics.js-Bibliothek vollständig geladen ist und alle vorherigen Befehle, die der Warteschlange hinzugefügt wurden, ausgeführt wurden.

Da alle Befehle in der Warteschlange der Reihe nach ausgeführt werden, sorgt das Hinzufügen eines Bereitschafts-Callbacks nach dem Hinzufügen des create-Befehls dafür, dass der Bereitschafts-Callback ausgeführt wird, nachdem der Tracker erstellt wurde. Wenn beim Aufrufen eines Callbacks, der bereit ist, ein Standard-Tracker erstellt wurde, wird dieser als erstes (und einziges) Argument des Callbacks übergeben.

Der folgende Code zeigt, wie Sie auf das Standard-Tracker-Objekt zugreifen und es in der Konsole protokollieren:

ga('create', 'UA-XXXXX-Y', 'auto');

ga(function(tracker) {
  // Logs the tracker created above to the console.
  console.log(tracker);
});

Tracker über GA-Objektmethoden abrufen

Wenn Sie keinen Standard-Tracker verwenden oder mehrere Tracker auf der Seite vorhanden sind, können Sie über eine der ga-Objektmethoden auf diese Tracker zugreifen.

Sobald die analytics.js-Bibliothek vollständig geladen wurde, werden dem ga-Objekt selbst weitere Methoden hinzugefügt. Zwei dieser Methoden, getByName und getAll, werden für den Zugriff auf Tracker-Objekte verwendet.

getByName

Wenn Sie den Namen des Trackers kennen, auf den Sie zugreifen möchten, können Sie dies mit der Methode getByName tun:

ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');

ga(function() {
  // Logs the "myTracker" tracker object to the console.
  console.log(ga.getByName('myTracker'));
});

getAll

Verwenden Sie die Methode getAll, um ein Array aller erstellten Tracker abzurufen:

ga('create', 'UA-XXXXX-Y', 'auto', 'tracker1');
ga('create', 'UA-XXXXX-Z', 'auto', 'tracker2');

ga(function() {
  // Logs an array of all tracker objects.
  console.log(ga.getAll());
});

Daten auf einem Tracker speichern

Sobald Sie einen Verweis auf ein Tracker-Objekt haben, können Sie mit seiner get-Methode auf den Wert eines beliebigen Felds zugreifen, das derzeit auf dem Tracker gespeichert ist.

ga('create', 'UA-XXXXX-Y', 'auto');

ga(function(tracker) {
  // Logs the trackers name.
  // (Note: default trackers are given the name "t0")
  console.log(tracker.get('name'));

  // Logs the client ID for the current user.
  console.log(tracker.get('clientId'));

  // Logs the URL of the referring site (if available).
  console.log(tracker.get('referrer'));
});

Daten aktualisieren

Tracker-Objekte können mit der set-Methode aktualisiert werden. Die set-Methode eines Trackers kann für das Tracker-Objekt selbst oder durch Hinzufügen eines set-Befehls zur ga()-Befehlswarteschlange aufgerufen werden.

Da für das Abrufen eines Verweises auf ein Tracker-Objekt der Bereitschafts-Callback verwendet werden muss, wird zum Aktualisieren eines Trackers die ga()-Befehlswarteschlange empfohlen.

Die ga()-Befehlswarteschlange

Der Befehl set kann auf zwei Arten aufgerufen werden: durch Übergeben von zwei Parametern, einem Feld und dem entsprechenden Wert, oder durch Übergeben eines Objekts aus Feld/Wert-Paaren.

Im folgenden Beispiel wird das Feld page im Standard-Tracker auf '/about' gesetzt:

ga('set', 'page', '/about');

In diesem Beispiel werden die Felder page und title gleichzeitig festgelegt:

ga('set', {
  page: '/about',
  title: 'About Us'
});

Benannten Tracker verwenden

Wenn Sie anstelle des Standard-Trackers einen benannten Tracker verwenden, können Sie dessen Namen in der Befehlszeichenfolge übergeben.

Mit dem folgenden Aufruf wird das Feld page auf dem Tracker „myTracker“ festgelegt:

ga('myTracker.set', 'page', '/about');

Im Tracker-Objekt selbst

Wenn Sie einen Verweis auf das Tracker-Objekt haben, können Sie die set-Methode dieses Trackers direkt aufrufen:

ga(function(tracker) {
  tracker.set('page', '/about');
});

Kaufmännische Und-Zeichen

Tracker-Felder werden normalerweise anhand ihrer Feldnamen abgerufen und festgelegt. Eine vollständige Liste der analytics.js-Felder und ihrer Namen finden Sie in der Feldreferenz.

Alternativ können Sie Felder auch über die entsprechenden Measurement Protocol-Parameternamen abrufen und festlegen.

Beispiel: Die beiden folgenden console.log-Ausdrücke protokollieren beide den Dokumenttitel in der Konsole:

ga(function(tracker) {
  // Gets the title using the analytics.js field name.
  console.log(tracker.get('title'));

  // Gets the title using the measurement protocol
  // parameter name, prefixed with an ampersand.
  console.log(tracker.get('&dt'));
});

Im Allgemeinen wird die kaufmännische Und-Syntax nicht empfohlen und sollte nur verwendet werden, wenn der Feldname "analytics.js" für einen Measurement Protocol-Parameter nicht vorhanden ist. Dies kann gelegentlich der Fall sein, wenn dem Measurement Protocol eine neue Funktion hinzugefügt wird, bevor sie in analytics.js implementiert wird.

Nächste Schritte

Sie wissen jetzt, wie Sie Tracker erstellen und die darauf gespeicherten Daten aktualisieren. Im nächsten Schritt erfahren Sie, wie Sie diese Daten zur Verarbeitung an Google Analytics senden können.