Tracker-Objekte (auch „Tracker“ genannt) sind Objekte, mit denen Daten erfasst, gespeichert und dann an Google Analytics gesendet werden können.
Wenn Sie einen neuen Tracker erstellen, müssen Sie eine Tracking-ID (die mit der Property-ID übereinstimmt, die einer Ihrer Google Analytics-Properties entspricht) sowie eine Cookie-Domain angeben, über die festgelegt wird, wie Cookies gespeichert werden. Der empfohlene Wert 'auto' gibt die automatische Konfiguration der Cookie-Domain an.
Wenn für die angegebene Domain kein Cookie vorhanden ist, wird eine Client-ID generiert und im Cookie gespeichert, und der Nutzer wird als neu identifiziert. Ist ein Cookie mit einem Client-ID-Wert vorhanden, wird diese Client-ID auf dem Tracker gesetzt und der Nutzer als wiederkehrend identifiziert.
Bei der Erstellung erfassen Tracker-Objekte auch Informationen über den aktuellen Browser-Kontext, wie etwa den Seitentitel und die URL, sowie Informationen über das Gerät, wie Bildschirmauflösung, Größe des Darstellungsbereichs und Dokumentcodierung. Wenn Daten an Google Analytics gesendet werden sollen, werden alle derzeit auf dem Tracker gespeicherten Informationen gesendet.
Die create-Methode
Die analytics.js-Bibliothek bietet verschiedene Möglichkeiten zum Erstellen von Trackern. In den meisten Fällen wird der Befehl create verwendet und die Felder Tracking-ID und Cookie-Domain als zweiten und dritten Parameter übergeben:
ga('create', 'UA-XXXXX-Y', 'auto');
Tracker benennen
Optional können Sie dem Tracker auch einen Namen geben. Übergeben Sie dazu das Feld name als viertes Argument im Befehl create. Das Benennen eines Trackers ist erforderlich, wenn Sie mehr als einen Tracker für dieselbe Seite erstellen müssen. Weitere Informationen dazu, warum das erforderlich sein kann, findest du im folgenden Abschnitt zum Arbeiten mit mehreren Trackern.
ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');
Wenn Sie einen Tracker erstellen, ohne das Feld name festzulegen, wird dies als „Standard-Tracker“ bezeichnet. Ein Standard-Tracker erhält intern den Namen „t0“.
Felder bei der Erstellung angeben
Sie können auch ein optionales fields-Objekt übergeben, mit dem Sie bei der Erstellung beliebige analytics.js-Felder festlegen können. Diese werden dann auf dem 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ührlichere Informationen finden Sie in der Methodenreferenz zu create.
Mit mehreren Trackern arbeiten
Es kann vorkommen, dass Sie Daten von einer einzelnen Seite an mehrere Properties senden möchten. Dies ist nützlich bei Websites, die von mehreren Inhabern beaufsichtigt werden. Jeder Inhaber kann seine eigene Property aufrufen.
Wenn Sie Daten für zwei separate Properties erfassen möchten, müssen Sie zwei separate Tracker erstellen. Mindestens einer davon muss ein benannter Tracker sein. Mit den folgenden beiden 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 Befehlsnamen den Namen des Trackers gefolgt von einem Punkt voran. Wenn Sie keinen Trackernamen angeben, wird der Befehl auf dem Standard-Tracker ausgeführt.
Um Seitenaufrufe für die beiden oben genannten Tracker zu senden, würden Sie die beiden folgenden Befehle ausführen:
ga('send', 'pageview');
ga('clientTracker.send', 'pageview');
In zukünftigen Leitfäden wird die Syntax zum Ausführen bestimmter Befehle ausführlicher beschrieben. In der Referenz zu Befehlswarteschlangen 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 wird beschrieben, wie Sie Tracker-Daten abrufen und festlegen.