Tracking-Code: Das globale Objekt „_gat“

ga.js ist eine Legacy-Bibliothek. Wenn Sie eine neue Implementierung starten, sollten Sie die neueste Version dieser Bibliothek verwenden: analytics.js. Informationen zur Implementierung von bestehenden Implementierungen finden Sie unter Von ga.js zu analytics.js migrieren.

Mit dem globalen Objekt _gat werden Tracker-Objekte erstellt und abgerufen, von denen alle anderen Methoden aufgerufen werden. Daher sollten die Methoden in dieser Liste nur für ein Tracker-Objekt ausgeführt werden, das mit der globalen Variable _gat erstellt wurde. Alle anderen Methoden sollten mit dem globalen Objekt _gaq für asynchrones Tracking aufgerufen werden.

_gat-Objektmethoden

• _getTracker(account) eingestellt
• _createTracker(opt_account, opt_name)
• _getTrackerByName(opt_name)
• _anonymizeIp()
• _forceSSL(bool)

Die Methoden im Detail

_getTracker()

_getTracker(account)

Diese Methode wurde eingestellt. Bitte verwende stattdessen _gat._createTracker(opt_account, opt_name).

Erstellt ein Tracker-Objekt für die angegebene Web-Property-ID Wenn diese Methode mehrmals für dieselbe Analysekonto-ID aufgerufen wird, wird für jeden Aufruf ein neues Objekt erstellt.

_gat._getTracker('UA-65432-1');

Parameter

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

Rückgabe

Tracker Das erstellte Tracking-Objekt

---

_createTracker()

_createTracker(opt_account, opt_name)

Erstellt ein neues Tracker-Objekt und weist ihm den angegebenen Namen zu. Wenn kein Name angegeben wird, wird ein Name generiert. Tracker-Objekte werden unter ihren Namen gespeichert, damit sie über _getTrackerByName abgerufen werden können. Wenn zwei Tracker mit demselben Namen erstellt werden, überschreibt der zweite den ersten und der erste kann nicht mehr über _getTrackerByName abgerufen werden.

_gat._createTracker('UA-65432-1');

_gat._createTracker('UA-65432-2', 't2');

Parameter

String opt_account Die vollständige Web-Property-ID (z.B. UA-XXXXX-X) für das Tracker-Objekt.
String opt_name Optionaler Name, unter dem der Tracker gespeichert wird. Verwende diesen Namen, um den Tracker über _getTrackerByName abzurufen.

Rückgabe

Tracker Das erstellte Tracking-Objekt

---

_getTrackerByName()

_getTrackerByName(opt_name)

Ruft das Tracker-Objekt mit dem angegebenen Namen ab. Wenn kein Name angegeben wird, wird die Standardeinstellung verwendet. Dies ist der leere String (''). Wenn kein Tracker mit dem angegebenen Namen vorhanden ist, wird ein neuer Tracker erstellt, diesem Namen zugewiesen und zurückgegeben.

_gat._getTrackerByName();

_gat._getTrackerByName('t2');

Parameter

String opt_name Optionaler Name des abzurufenden Trackers. Die Standardeinstellung ist der leere String ('').

Rückgabe

Tracker Das abgerufene oder erstellte Tracking-Objekt.

---

_anonymisierenIp()

_anonymizeIp()

Weist Google Analytics an, die von den Tracker-Objekten gesendeten Informationen zu anonymisieren. Dazu wird das letzte Oktett der IP-Adresse vor dem Speichern entfernt. Beachten Sie, dass dies zu einer geringeren Präzision bei der Erstellung geografischer Berichte führt.

Wenn Sie diese Funktion zum Anonymisieren von Tracking-Methoden verwenden, müssen Sie die Funktion push verwenden und die Funktion wie unten dargestellt mit dem Tracker-Objekt verknüpfen.

Asynchrones Snippet (empfohlen)

var _gaq = _gaq || [];
_gaq.push (['_setAccount', 'UA-XXXXXXX-YY']);
_gaq.push (['_gat._anonymizeIp']);
_gaq.push (['_trackPageview']);

Herkömmliches Snippet (ga.js)

<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
try{
var pageTracker = _gat._getTracker("UA-xxxxxx-x");
_gat._anonymizeIp();
pageTracker._trackPageview();
} catch(err) {}</script>

---

_forceSSL()

_forceSSL(bool)

Konfiguriert Google Analytics so, dass alle Treffer über SSL gesendet werden, auch von unsicheren HTTP-Seiten.

Asynchrones Snippet (empfohlen)

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_gat._forceSSL']);       // Send all hits using SSL, even from insecure (HTTP) pages.
_gaq.push(['_trackPageview']);

Herkömmliches Snippet (ga.js)

var pageTracker = _gat._getTracker("UA-12345-1");
// Send all hits using SSL even from insecure (HTTP) pages.
_gat._forceSSL();
pageTracker._trackPageview();