Tracking-Code: Das globale _gaq-Objekt

Das globale _gaq-Objekt kann über die push(...)-Methode direkt für das asynchrone Seiten-Tracking verwendet werden. Es verfügt auch über Methoden zum Erstellen von Tracker-Objekten, die jedoch nur in seltenen Fällen verwendet werden sollten.

Verwenden Sie für das traditionelle Seiten-Tracking stattdessen das globale Objekt _gat.

_gaq-Objektmethoden

Die Methoden im Detail

_createAsyncTracker()

    _createAsyncTracker(accountId, opt_name)
    Erstellt ein Tracker-Objekt, auf das bei asynchronen Tracking-Aufrufen namentlich verwiesen werden kann. Wenn kein Name angegeben wird, ist der leere String '' der Standardtracker in der asynchronen Syntax. Wenn mit dem angegebenen Namen bereits ein asynchroner Tracker vorhanden ist, wird er mit dem neuen Tracker überschrieben.

    Hinweis: Diese Methode kann im Allgemeinen nur innerhalb einer Funktion verwendet werden, die in _gaq übernommen wurde. Es sollte nur in seltenen Fällen verwendet werden. 
    _gaq._createAsyncTracker('UA-65432-1');

    Parameter

      String accountId Die vollständige Web-Property-ID (z.B. UA-65432-1) für das Tracker-Objekt.
      String opt_name Der Name, unter dem das Tracker-Objekt gespeichert werden soll. Verwenden Sie diesen Namen, um später in asynchronen Tracking-Aufrufen auf das Tracker-Objekt zu verweisen.

    Gibt zurück

      Tracker Das erstellte Tracking-Objekt

_getAsyncTracker()

    _getAsyncTracker(opt_name)
    Gibt das zuvor unter dem angegebenen Namen erstellte Tracker-Objekt zurück. Wenn kein Name angegeben wird, wird der Standard-Tracker-Name (der leere String '') verwendet. Ist kein Tracker-Objekt mit dem angegebenen Namen vorhanden, wird ein neuer Tracker erstellt, diesem Namen zugewiesen und zurückgegeben.

    Hinweis: Diese Methode kann im Allgemeinen nur innerhalb einer Funktion verwendet werden, die in _gaq übernommen wurde. Es sollte nur in seltenen Fällen verwendet werden. 
    _gaq._getAsyncTracker();

    Parameter

      String opt_name Der Name des abzurufenden Tracker-Objekts.

    Gibt zurück

      Tracker Abgerufenes oder erstelltes Tracking-Objekt

push

    push(commandArray)
    Führt das angegebene command array aus, bei dem es sich einfach um ein JavaScript-Array mit dem folgenden Format handelt. Das erste Element des Arrays muss der Name einer Tracker-Objektmethode sein, die als String übergeben wird. Die restlichen Arrayelemente sind die Werte, die als Argumente an die Funktion übergeben werden sollen.

    Typische Verwendung ist Folgendes:
    var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-65432-1']);
_gaq.push(['_trackPageview']);

    Diese Funktion heißt push, damit ein Array anstelle von _gaq verwendet werden kann, bevor Analytics vollständig geladen wurde. Während Analytics wird geladen, werden Befehle per Push in das Array übertragen bzw. in die Warteschlange gestellt. Nach dem Laden von Analytics wird das Array durch das Objekt _gaq ersetzt und alle Befehle in der Warteschlange ausgeführt. Die nachfolgenden Aufrufe von _gaq.push werden in diese Funktion aufgelöst, die bei Übertragung Befehle ausführt.

    Tracker können durch Voranstellen des Tracker-Namens (zusammen mit einem Punkt) vor dem Methodennamen benannt werden. Wenn ein Funktionsname mit dem Namen eines Trackers qualifiziert ist, wird er auf diesem Tracker ausgeführt.

    Im folgenden Beispiel wird ein Tracker mit dem Namen „myTracker“ erstellt und verwendet.
    var _gaq = _gaq || [];
_gaq.push(['myTracker._setAccount', 'UA-65432-2']);
_gaq.push(['myTracker._setDomainName', 'foo.com']);
_gaq.push(['myTracker._trackPageview']);

    Hinweis:Tracker werden erstellt, wenn ein Befehl zum ersten Mal auf sie verweist. Der Standard-Tracker wird über den ersten Befehl erstellt, in dem der Tracker nicht explizit benannt wird. Der Name des Standard-Trackers ist der leere String ''.

    Sie können nicht nur Befehls-Arrays, sondern auch Funktionsobjekte übertragen. Dies kann besonders bei Tracker-Methoden nützlich sein, die Werte zurückgeben. Diese Funktionen können sowohl auf _gat als auch auf _gaq verweisen.
    var _gaq = _gaq || [];
_gaq.push(function() {
  var tracker = _gat._getTracker('UA-65432-1');
  tracker._trackPageview();
});

    Sie können die Push-Syntax auch direkt im HTML-Code Ihrer Seite verwenden.
    onclick="_gaq.push(['_trackEvent', 'name', value]);"

    Solange sich das asynchrone Analytics-Snippet über dem Link befindet, werden Klicks ohne Fehler erfasst, auch wenn Analytics zum Zeitpunkt des Klicks noch nicht vollständig geladen wurde. Dies ist einer der vielen Vorteile des asynchronen Trackings.

    Anstatt für jedes Befehlsarray _gaq.push(...) einzugeben, können Sie alle Befehle auf einmal übertragen. Der folgende Code veranschaulicht diese Technik. Weitere Informationen finden Sie im Nutzungsleitfaden für asynchrone Snippets. 

    _gaq.push(
  ['_setAccount', 'UA-XXXXX-X'],
  ['_setDomainName', 'example.com'],
  ['_setCustomVar', 1, 'Section', 'Life & Style', 3],
  ['_trackPageview']
);

      Parameter

        Array commandArray Der auszuführende Befehl. Mindestens eines davon kann im selben Aufruf übertragen werden.

      Gibt zurück

        Number Die Anzahl der Befehle, die nicht ausgeführt werden konnten.