Für das Abrufen und Festlegen von Felddaten auf einem Tracker ist manchmal ein Verweis auf das Tracker-Objekt selbst erforderlich. Befehle, die der ga()-Befehlswarteschlange hinzugefügt werden, werden asynchron ausgeführt und geben keinen Wert aus. Tracker werden in der Regel mit dem create-Befehl erstellt. Um einen Verweis auf ein Tracker-Objekt abzurufen, muss daher gewartet werden, bis der create-Befehl ausgeführt wurde. Sie können dies über den fertigen Callback tun.
Der Bereitschafts-Callback
Die bereite Callback-Funktion 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 ausgeführt wurden, die der Warteschlange hinzugefügt wurden.
Da alle Befehle in der Warteschlange der Reihe nach ausgeführt werden, sorgt das Hinzufügen eines „ready“-Callbacks zur Warteschlange nach dem Hinzufügen eines create-Befehls dafür, dass der „Ready“-Callback ausgeführt wird, nachdem der Tracker erstellt wurde. Wenn ein Standard-Tracker erstellt wurde, wenn ein Bereitschafts-Callback aufgerufen wird, wird er 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-Objekt-Methoden abrufen
Wenn Sie keinen Standard-Tracker verwenden oder mehrere Tracker auf der Seite haben, 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 ihn mit der Methode getByName abrufen:
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 werden auf einem Tracker gespeichert
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 vom Tracker-Objekt selbst oder durch Hinzufügen eines set-Befehls zur ga()-Befehlswarteschlange aufgerufen werden.
Da für den Abruf einer Referenz auf ein Tracker-Objekt die Verwendung des Bereitschafts-Callbacks erforderlich ist, wird die Verwendung der ga()-Befehlswarteschlange zur Aktualisierung eines Trackers 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 einen benannten Tracker anstelle des Standard-Trackers 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ännisches Und-Zeichen
Tracker-Felder werden normalerweise anhand ihrer Feldnamen abgerufen und festgelegt. In der Referenz für Felder finden Sie eine vollständige Liste der analytics.js-Felder und ihrer Namen.
Alternativ können Sie Felder auch abrufen und festlegen, indem Sie mit den entsprechenden Measurement Protocol-Parameternamen auf sie verweisen.
Die folgenden beiden console.log-Ausdrücke protokollieren beispielsweise 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 Name des analytics.js-Felds für einen Measurement Protocol-Parameter nicht vorhanden ist. Das kann gelegentlich vorkommen, wenn dem Measurement Protocol eine neue Funktion hinzugefügt wird, bevor die Implementierung in analytics.js erfolgt ist.
Nächste Schritte
Sie wissen nun, 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.