Tracker erstellen

Tracker-Objekte (auch als „Tracker“ bezeichnet) sind Objekte, mit denen Daten erfasst, gespeichert und anschließend 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, die festlegt, wie Cookies gespeichert werden. Der empfohlene Wert 'auto' gibt die automatische Cookie-Domainkonfiguration an.

Ist für die angegebene Domain kein Cookie vorhanden, wird eine Client-ID generiert und im Cookie gespeichert. Der Nutzer wird als neu identifiziert. Wenn ein Cookie mit einem Client-ID-Wert vorhanden ist, 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. Am häufigsten wird jedoch 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 den Tracker auch benennen, indem Sie das Feld name als viertes Argument im Befehl create übergeben. 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 ist, findest du unten im Abschnitt Mit mehreren Trackern arbeiten.

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

Wenn du einen Tracker erstellst, ohne das Feld name festzulegen, wird auch ein „Standard“-Tracker erstellt. 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 eines der analytics.js-Felder bei der Erstellung festlegen können, damit sie auf dem Tracker gespeichert werden und auf alle gesendeten Treffer angewendet werden.

ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker', {
  userId: '12345'
});

Wie bei allen Aufrufen der ga()-Funktion kann das fields-Objekt auch dazu verwendet werden, alle Felder zusammen anzugeben:

ga('create', {
  trackingId: 'UA-XXXXX-Y',
  cookieDomain: 'auto',
  name: 'myTracker',
  userId: '12345'
});

Ausführliche Informationen finden Sie in der Referenz zur create.

Mit mehreren Trackern arbeiten

In manchen Fällen möchten Sie möglicherweise Daten von einer einzelnen Seite an mehrere Properties senden. Dies ist nützlich bei Websites, auf denen mehrere Inhaber die Bereiche einer Website verwalten. Jeder Inhaber kann seine eigene Property aufrufen.

Um Daten für zwei separate Properties zu verfolgen, müssen Sie zwei separate Tracker erstellen, von denen mindestens einer ein benannter Tracker sein muss. 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 voran, gefolgt von einem Punkt. 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 für die Ausführung bestimmter Befehle ausführlicher beschrieben. Die vollständige Befehlssyntax für alle analytics.js-Befehle finden Sie in der Referenz zu Befehlswarteschlangen.

Nächste Schritte

Nachdem Sie einen Tracker erstellt haben, müssen Sie möglicherweise auf die Daten zugreifen, die auf diesem Tracker-Objekt gespeichert sind. Im nächsten Leitfaden wird erläutert, wie Sie Tracker-Daten abrufen und festlegen.