Tracker-Objekte (auch als &trackers" bezeichnet) sind Objekte, die Daten erfassen und speichern und anschließend an Google Analytics senden können.
Beim Erstellen eines neuen Trackers müssen Sie eine Tracking-ID angeben, die mit einer Ihrer Google Analytics-Properties übereinstimmt, sowie eine Cookie-Domain, die angibt, wie Cookies gespeichert werden. Der empfohlene Wert 'auto' gibt die automatische Cookie-Domain-Konfiguration an.
Falls für die angegebene Domain kein Cookie vorhanden ist, wird eine Client-ID generiert und im Cookie gespeichert. Der Nutzer wird dann als neu identifiziert. Wenn ein Cookie mit einem Client-ID-Wert vorhanden ist, wird diese auf dem Tracker festgelegt und der Nutzer wird als wiederkehrend identifiziert.
Bei der Erstellung erfassen Tracker-Objekte auch Informationen über den aktuellen Browserkontext, z. B. den Seitentitel und die URL, sowie Informationen zum Gerät, z. B. die Bildschirmauflösung, die Größe des Darstellungsbereichs und die Dokumentcodierung. Beim Senden von Daten an Google Analytics werden alle derzeit im Tracker gespeicherten Informationen gesendet.
Erstellungsmethode
Die analytics.js-Bibliothek bietet verschiedene Möglichkeiten zum Erstellen von Trackern. Am häufigsten wird jedoch der Befehl create verwendet und die Felder Tracking-ID und Cookie-Domain als zweiter und dritter Parameter übergeben:
ga('create', 'UA-XXXXX-Y', 'auto');
Tracker benennen
Sie können dem Tracker optional auch einen Namen geben, indem Sie das Feld name als viertes Argument im Befehl create übergeben. In den Fällen, in denen du mehrere Tracker für dieselbe Seite erstellen musst, musst du einen Tracker benennen. Weitere Informationen zu den möglichen Gründen dafür findest du unten im Abschnitt Mit mehreren Trackern arbeiten.
ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');
Das Erstellen eines Trackers ohne das Feld name wird als „Standard-Tracker erstellen“ bezeichnet. Ein Standard-Tracker erhält intern den Namen "t0".
Felder bei der Erstellung angeben
Es kann auch ein optionales fields-Objekt übergeben werden, mit dem Sie bei der Erstellung eines der Felder „analytics.js“ festlegen können. Diese werden dann im Tracker gespeichert und auf alle gesendeten Treffer angewendet.
ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker', {
userId: '12345'
});
Wie bei allen Aufrufen der ga()-Funktion kann auch das fields-Objekt verwendet werden, um alle Felder zusammen anzugeben:
ga('create', {
trackingId: 'UA-XXXXX-Y',
cookieDomain: 'auto',
name: 'myTracker',
userId: '12345'
});
Ausführliche Informationen finden Sie in der create-Methodenreferenz.
Mit mehreren Trackern arbeiten
In einigen Fällen möchten Sie möglicherweise Daten von einer einzigen Seite an mehrere Properties senden. Das ist nützlich für Websites, die von mehreren Inhabern betreut werden. Jeder Inhaber kann seine eigene Property sehen.
Um Daten für zwei separate Properties zu erfassen, müssen Sie zwei separate Tracker erstellen. Mindestens eine der Tracker muss ein benannter Tracker sein. Mit den folgenden zwei Befehlen werden ein Standard-Tracker und ein Tracker mit dem Namen "clientTracker" erstellt:
ga('create', 'UA-XXXXX-Y', 'auto');
ga('create', 'UA-XXXXX-Z', 'auto', 'clientTracker');
Befehle für einen bestimmten Tracker ausführen
Wenn Sie analytics.js-Befehle für einen bestimmten Tracker ausführen möchten, stellen Sie dem Befehl den Tracker-Namen voran, gefolgt von einem Punkt. Wenn Sie keinen Trackernamen angeben, wird der Befehl auf dem Standardtracker ausgeführt.
Um Seitenaufrufe für die beiden Tracker oben zu senden, führen Sie die folgenden beiden Befehle aus:
ga('send', 'pageview');
ga('clientTracker.send', 'pageview');
In zukünftigen Leitfäden werden wir uns detaillierter mit der Syntax zum Ausführen bestimmter Befehle befassen. In der Referenz zur Befehlswarteschlange finden Sie die vollständige Befehlssyntax für alle analytics.js-Befehle.
Nächste Schritte
Nachdem Sie einen Tracker erstellt haben, müssen Sie möglicherweise auf die in diesem Tracker-Objekt gespeicherten Daten zugreifen. Im nächsten Leitfaden erfahren Sie, wie Sie Tracker-Daten abrufen und festlegen.