Tracking-Code: Grundlegende Konfiguration

In diesem Artikel werden die Methoden beschrieben, mit denen Sie alle Aspekte der Google Analytics-Berichte anpassen können.

Grundlegende Methoden von ga.js

Die Methoden im Detail

_deleteCustomVar()

_deleteCustomVar(index)

Mit dieser Methode wird die Variable gelöscht, die dem angegebenen Index zugewiesen ist, sofern vorhanden. Sie können beispielsweise eine benutzerdefinierte Variable auf Besucherebene festlegen und später entscheiden, diese Variable auf Besucherebene nicht mehr zu verwenden.

Asynchrones Snippet (empfohlen)

_gaq.push(['_deleteCustomVar', 1]);

Parameter

Int   index Der Index der benutzerdefinierten Variablen, die gelöscht werden soll.


_getName()

_getName()

Gibt den Namen zurück, der dem Tracker bei seiner Erstellung gegeben wurde

Asynchrones Snippet (empfohlen)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var trackerName = pageTracker._getName();
});

Gibt zurück

String Der Name des Trackers.


_getAccount()

_getAccount()

Gibt die Google Analytics-ID für dieses Tracker-Objekt zurück Wenn Sie Seiten Ihrer Website in mehreren Konten erfassen, können Sie mit dieser Methode das Konto ermitteln, das mit einem bestimmten Tracker-Objekt verknüpft ist.

Asynchrones Snippet (empfohlen)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var accountId = pageTracker._getAccount();
});

Gibt zurück

String-Konto-ID, mit der dieses Tracker-Objekt instanziiert wird.


_getVersion()

_getVersion()

Gibt die GATC-Versionsnummer zurück.

Asynchrones Snippet (empfohlen)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var version = pageTracker._getVersion();
});

Gibt zurück

String GATC-Versionsnummer.


_getVisitorCustomVar()

_getVisitorCustomVar(index)

Gibt den Wert der benutzerdefinierten Variablen auf Besucherebene zurück, die für den angegebenen Index zugewiesen ist

Asynchrones Snippet (empfohlen)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var visitorCustomVar1Value = pageTracker._getVisitorCustomVar(1);
});

Parameter

Int   index Der Index der benutzerdefinierten Variablen auf Besucherebene.

Gibt zurück

String Der Wert der benutzerdefinierten Variablen auf Besucherebene. Gibt "undefiniert" zurück, wenn die Variable für den angegebenen Index nicht abgerufen werden kann


_initData()

_initData()Eingestellt. „initData()“ wird jetzt automatisch im ga.js-Tracking-Code ausgeführt.

Initialisiert oder neu initialisiert das GATC-Objekt (Google Analytics Tracker Code)

var pageTracker = _gat._getTracker("UA-12345-1");
pageTracker._trackPageview();

_setAccount()

_setAccount(accountId)

Wird ausschließlich im asynchronen Tracking verwendet. Legt die Web-Property-ID für das Tracking-Objekt fest

_gaq.push(['_setAccount', 'UA-XXXXX-X']);

Parameter

String accountID Die vollständige Web-Property-ID (z.B. UA-65432-1) für das Tracker-Objekt.


_setCookiePersistence()

_setCookiePersistence(milliseconds)

Diese Methode wird nicht mehr unterstützt. Verwenden Sie stattdessen _setVisitorCookieTimeout(cookieTimeoutMillis).

Legt die Ablaufzeit des Besucher-Cookies in Google Analytics in Millisekunden fest. Standardmäßig läuft das Besucher-Cookie nach 2 Jahren ab. Sie können das Ablaufdatum des Besucher-Cookies auch mit dieser Methode ändern. Wenn Sie beispielsweise die Ablaufzeit des Besucher-Cookies auf 7 Tage festlegen möchten, verwenden Sie den folgenden Code:

pageTracker._setCookiePersistence(604800000); 

Parameter

Number   milliseconds Ablaufzeit des Cookies für neuen Besucher.


_setCustomVar()

_setCustomVar(index, name, value, opt_scope)

Legt eine benutzerdefinierte Variable mit dem angegebenen Namen, Wert und Umfang für die Variable fest. Für name und value zusammen gilt eine Zeichenbeschränkung von 128 Byte.

Asynchrones Snippet (empfohlen)

_gaq.push(['_setCustomVar', 1, 'Section', 'Life & Style', 3]);

Gibt zurück

Boolean Diese Methode gibt true zurück, wenn die benutzerdefinierte Variable festgelegt wurde. Wenn dies nicht der Fall ist, z. B. wenn die Länge des Namens-/Wertstrings 128 Byte überschreitet oder ein falscher Slot verwendet wird, wird false zurückgegeben.

Parameter

Int      index       Erforderlich. Die Fläche, die für die benutzerdefinierte Variable verwendet wird. Mögliche Werte sind 1-5 (einschließlich).

String   name        Erforderlich. Der Name der benutzerdefinierten Variablen.

String   value       Erforderlich. Wert für die benutzerdefinierte Variable.

Int      opt_scope   Optional. Umfang, der für die benutzerdefinierte Variable verwendet wird. Mögliche Werte sind 1 für Besucher, 2 für Sitzungsebene und 3 für Seitenebene.


_setSampleRate()

_setSampleRate(newRate)

Legt die neue Abtastrate fest. Falls Ihre Website besonders groß ist und starken Traffic-Spitzen unterliegt, sorgt das Festlegen der Stichprobenrate für eine unterbrechungsfreie Berichterstellung. Die Stichprobenerhebung in Google Analytics erfolgt konsistent für einzelne Besucher. Daher werden Trends und Berichte auch dann fehlerfrei erstellt, wenn die Stichprobenerhebung aktiviert ist. Dies liegt daran, dass eindeutige Besucher zu Beginn der Stichprobenerhebung in der Stichprobe eingeschlossen oder davon ausgeschlossen werden können.

Sie müssen diese Methode nur zur selben Zeit angeben, zu der _setAccount() aufgerufen wird, und zwar in der Regel einmal pro Seite oder Anwendung (wobei Sie den Tracking-Code selbst initialisieren). Der von Ihnen angegebene Wert für die Abtastrate bleibt so lange gültig, wie das Tracking-Objekt selbst bestehen bleibt.

Asynchrones Snippet (empfohlen)

_gaq.push(['_setSampleRate', '2.5']);

Parameter

String newRate Neue Abtastrate festzulegen. Geben Sie eine numerische Zeichenfolge zwischen 0 und 100 (mit bis zu zwei Dezimalstellen) an.


_setSessionTimeout()

_setSessionTimeout(newTimeout)

Diese Methode wird nicht mehr unterstützt. Verwenden Sie stattdessen _setSessionCookieTimeout(cookieTimeoutMillis).

Legt das neue Zeitlimit für Sitzungen in Sekunden fest. Standardmäßig ist das Zeitlimit für Sitzungen auf 30 Minuten (1.800 Sekunden) eingestellt. Die Zeitüberschreitung für Sitzungen wird verwendet, um Besuche zu berechnen. Weitere Informationen finden Sie unter Definition einer Sitzung in Analytics. Wenn Sie die Definition einer „Sitzung“ an Ihre speziellen Anforderungen anpassen möchten, können Sie die Anzahl von Sekunden übergeben, um einen neuen Wert zu definieren. Dies wirkt sich auf die Berichte zu Besuchen in jedem Abschnitt aus, in dem die Anzahl der Besuche berechnet wird und wo Besuche zur Berechnung anderer Werte verwendet werden. Beispielsweise steigt die Anzahl der Besuche in der Regel, wenn Sie das Zeitlimit für Sitzungen verkürzen, und im Allgemeinen ab, wenn Sie das Zeitlimit für Sitzungen erhöhen.

Parameter

String newTimeout Neues Zeitlimit für Sitzungen in Sekunden.


_setSessionCookieTimeout()

_setSessionCookieTimeout(cookieTimeoutMillis)

Legt das neue Zeitlimit für Sitzungscookies in Millisekunden fest. Standardmäßig ist das Zeitlimit für Sitzungen auf 30 Minuten eingestellt. Die Zeitüberschreitung für Sitzungen wird zur Berechnung von Besuchen verwendet, da ein Besuch nach 30 Minuten Inaktivität oder nach Schließen des Browsers endet. Wenn Sie die Definition eines „Sitzung“ für Ihre speziellen Anforderungen ändern möchten, können Sie die Anzahl von Millisekunden übergeben, um einen neuen Wert zu definieren. Dies wirkt sich auf die Berichte zu Besuchen in jedem Bereich aus, in dem die Anzahl der Besuche berechnet wird und wo Besuche zur Berechnung anderer Werte verwendet werden. Beispielsweise erhöht sich die Anzahl der Besuche, wenn Sie das Zeitlimit für Sitzungen verkürzen, und die Anzahl der Besuche, wenn Sie das Zeitlimit für Sitzungen erhöhen. Sie können das Zeitlimit auf 0 setzen, um anzugeben, dass dieses Cookie beim Schließen des Browsers gelöscht werden soll.

Asynchrones Snippet (empfohlen)

_gaq.push(['_setSessionCookieTimeout', 1800000]);


Parameter

Number cookieTimeoutMillis Neues Zeitlimit für Sitzungen in Millisekunden oder 0 zum Löschen des Cookies beim Schließen des Browsers.


_setSiteSpeedSampleRate()

_setSiteSpeedSampleRate(sampleRate)

Definiert eine neue Stichprobengröße für die Datenerhebung zur Websitegeschwindigkeit. Standardmäßig besteht der Datenpool, mit dem die Messwerte zur Websitegeschwindigkeit ermittelt werden, immer aus 1% der Besucher Ihrer Website. Wenn Ihre Website nur von relativ wenigen Besuchern pro Tag besucht wird (z. B. 100.000 oder weniger), sollten Sie die Stichprobe auf eine höhere Rate erhöhen. Dadurch erhalten Sie einen höheren Detaillierungsgrad für die Seitenladezeit und andere Messwerte zur Websitegeschwindigkeit. Weitere Informationen zu den Berichten zur Websitegeschwindigkeit findest du in der Hilfe unter Websitegeschwindigkeit.

Die Methode _setSiteSpeedSampleRate() muss vor _trackPageview() aufgerufen werden, damit sie wirksam ist.

In Analytics werden die Treffer für die Erhebung der Websitegeschwindigkeit für eine einzelne Property auf 1% der Nutzer oder auf 10.000 Treffer pro Tag beschränkt, damit die Systemressourcen für diese Funktion gleichmäßig verteilt werden.

Hinweis: Für Websites mit mehr als einer Million Treffer pro Tag empfehlen wir dringend, für die Stichprobenauswahl die Standardrate von 1% beizubehalten. Wenn Sie die Stichprobengröße auf eine größere Zahl einstellen, erhöht sich dadurch nicht die Stichprobengröße.

Asynchrones Snippet (empfohlen)

_gaq.push(['_setSiteSpeedSampleRate', 5]);
_gaq.push(['_trackPageview']);

Parameter

Number sampleRate Ein Wert zwischen 0 und 100, mit dem der Prozentsatz der Besucher Ihrer Website definiert wird, der im Hinblick auf die Websitegeschwindigkeit gemessen wird. Beispielsweise wird beim Wert 5 die Stichprobe für die Erfassung der Websitegeschwindigkeit auf 5 % gesetzt.


_setVisitorCookieTimeout()

_setVisitorCookieTimeout(cookieTimeoutMillis)

Legt die Ablaufzeit des Besucher-Cookies in Google Analytics in Millisekunden fest. Standardmäßig läuft das Besucher-Cookie nach 2 Jahren ab. Sie können das Ablaufdatum des Besuchercookies aber auch mit dieser Methode ändern. Sie können das Ablaufzeitlimit in 0 ändern, um anzugeben, dass dieses Cookie beim Schließen des Browsers gelöscht werden soll.

Asynchrones Snippet (empfohlen)

_gaq.push(['_setVisitorCookieTimeout', 63072000000]);

Parameter

Number cookieTimeoutMillis Ablaufzeit des Cookies für neuen Besucher in Millisekunden oder 0, wenn das Cookie beim Schließen des Browsers gelöscht wird.


_setVar()

_setVar(newVal)

Diese Methode wird nicht mehr unterstützt. Bitte stattdessen "_setCustomVar()" verwenden.

Legt ein benutzerdefiniertes Besuchersegment mit dem angegebenen String fest oder definiert es. Mit diesem Wert können Sie die Nutzer Ihrer Website zusätzlich segmentieren. Sie können beispielsweise eine Anmeldeseite oder ein Formular einrichten, das basierend auf der Eingabe eines Besuchers einen Wert auslöst, z. B. durch eine vom Besucher ausgewählte Einstellung oder eine Datenschutzoption. Diese Variable wird dann im Cookie für diesen Besucher aktualisiert. Wenn es auf Ihrer Website implementiert ist und Daten mithilfe dieser Methode erfasst werden, wird das neu definierte Segment in den benutzerdefinierten Berichten im Bereich "Besucher" der Analytics-Berichte angezeigt. Außerdem können Sie im Bericht „Inhaltsdetails“ auf das Segment Benutzerdefinierter Wert zugreifen, um zu sehen, welcher Prozentsatz der Besucher einer Seite zu einem bestimmten von Ihnen definierten Segment gehört.

Parameter

String newVal Neuer benutzerdefinierter Wert zum Festlegen.


_trackPageLoadTime().

_trackPageLoadTime()

Diese Methode wurde eingestellt, da die Berichte zur Websitegeschwindigkeit automatisch für alle Nutzer aktiviert sind. Verwenden Sie _setSiteSpeedSampleRate(), um die Stichprobe für Berichte zur Websitegeschwindigkeit anzupassen.

Aktiviert Berichte zur Websitegeschwindigkeit für diese Seite. Füge diese Methode für jede Seite deiner Website ein, für die Berichte zur Websitegeschwindigkeit erstellt werden sollen. Weitere Informationen zu den Berichten zur Websitegeschwindigkeit in Analytics finden Sie hier.

Änderungen überprüfen

Wenn in den Berichten Daten angezeigt werden, ist die Einrichtung korrekt. Wenn Sie nach 24 Stunden keine Daten sehen, prüfen Sie Ihre Anpassung auf Fehler. Eine Liste häufiger Tracking-Code-Fehler finden Sie unter Fehlerbehebung beim Tracking-Code. Diese Anleitung zur Fehlerbehebung enthält auch grundlegende Debugging-Schritte und weitere Informationen zur Fehlerbehebung.

Durch die Aktivierung des Trackings der Geschwindigkeit für Ihre Website wird eine zusätzliche Anfrage an die Google Analytics-Server gesendet. Diese Anfrage erfolgt separat von der GIF-Anfrage für das Tracking von Seiten in Bezug auf Seitenaufrufe. Zur Minimierung der Auswirkung auf die Latenz der gesamten Website wird die Anfrage nur anhand von Stichproben zu Seitenaufrufen Ihrer Website gesendet. Folglich ist beim Versuch, Fehler dieser Funktion in Firebug oder anderen Tools zu beheben, unter Umständen nicht immer die GIF-Anfrage zur Website-Geschwindigkeit sichtbar. Dies ist normal und entspricht den Erwartungen.

Asynchrones Snippet (empfohlen)

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview']);
_gaq.push(['_trackPageLoadTime']);

_trackPageview()

_trackPageview(opt_pagePath)

Hauptlogik für GATC (Google Analytics Tracker Code). Wenn Verknüpfungsfunktionen aktiviert sind, wird versucht, Cookiewerte aus der URL zu extrahieren. Andernfalls wird versucht, Cookiewerte aus document.cookie zu extrahieren. Außerdem werden Cookies bei Bedarf aktualisiert oder erstellt und dann in das Dokumentobjekt zurückgeschrieben. Es werden alle entsprechenden Messwerte erfasst und an das UCFE (Urchin Collector-Frontend) gesendet.

Asynchrones Snippet (empfohlen)

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview', '/home/landingPage']);

Parameter

String opt_pagePath: Optionaler Parameter zur Angabe des Pfades der Seite, auf der Messwerte erfasst werden sollen. Wenn Sie diese Option verwenden, geben Sie den Seitenpfad mit einem Schrägstrich (/) an.