Tracking-Code: Domains und Verzeichnisse

Hier werden die Methoden beschrieben, mit denen Sie anpassen können, wie Google Analytics-Berichte domainübergreifend, auf verschiedenen Hosts oder in Unterverzeichnissen einer Website funktionieren.

GATC-Domain-/Verzeichnismethoden

Die Methoden im Detail

_cookiePathCopy()

_cookiePathCopy(newPath)

Ändert die Pfade aller GATC-Cookies in den neu angegebenen Pfad. Mit dieser Funktion können Sie das Nutzerverhalten von einer Verzeichnisstruktur zur anderen in derselben Domain verfolgen.

Wenn diese Funktion aufgerufen wird, werden alle Cookies sofort in den neuen Cookie-Pfad kopiert. Wird die Methode _trackPageview() nicht aufgerufen, werden daher die Werte für alle vorhandenen Analytics-Cookies bereitgestellt. Daher empfehlen wir, diese Methode nach _trackPageview() sowie nach anderen Konfigurationsmethoden aufzurufen, die sich möglicherweise auf die Cookie- oder Kampagnenwerte auswirken, die Sie weitergeben möchten, z. B. _setCampaignCookieTimeout() oder _setReferrerOverride().

Asynchrones Snippet (empfohlen)
_gaq.push(['_cookiePathCopy', '/newSubDirectory/']);

Parameter

String   newPath Neuer Pfad zum Speichern von GATC-Cookies.

_getLinkerUrl()

_getLinkerUrl(targetUrl, useHash)

Diese Methode funktioniert in Verbindung mit den Methoden _setDomainName() und _setAllowLinker(), um domainübergreifendes Nutzer-Tracking speziell für iFrames und Links zu ermöglichen, die in einem neuen Fenster geöffnet werden. Diese Methode gibt einen String aller GATC-Cookie-Daten vom initiierenden Link zurück, indem sie an den URL-Parameter angehängt wird. Diese kann dann an eine andere Website oder einen anderen iFrame übergeben werden.

Asynchrones Snippet (empfohlen)
  _gaq.push(function() {
    var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
    var linkerUrl = pageTracker._getLinkerUrl('http://www.my-example-iframecontent.com/');
  });

Parameter

String   targetUrl URL der Zielwebsite, an die Cookiewerte gesendet werden sollen.

Boolean   useHash Wird zum Übergeben von Tracking-Code-Variablen auf „true“ gesetzt. Dazu wird das Trennzeichen „#“ und nicht das standardmäßige ? als Trennzeichen für Abfragezeichenfolge.

Gibt zurück

String Die Verknüpfungs-URL.

_link(targetUrl, useHash)

Diese Methode funktioniert in Verbindung mit den Methoden _setDomainName() und _setAllowLinker(), um domainübergreifendes Nutzer-Tracking zu ermöglichen. Bei der Methode _link() werden die GATC-Cookies über URL-Parameter (HTTP GET) von dieser Website an eine andere weitergeleitet. Außerdem wird „document.location“ geändert und der Nutzer zur neuen URL weitergeleitet.

Asynchrones Snippet (empfohlen)
<a href="http://example.com/test.html"
onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>

Parameter

String   targetUrl URL der Zielwebsite, an die Cookiewerte gesendet werden sollen.

Boolean   useHash Wird zum Übergeben von Tracking-Code-Variablen auf „true“ gesetzt. Dazu wird das Trennzeichen „#“ und nicht das standardmäßige ? als Trennzeichen für Abfragezeichenfolge.


_linkByPost()

_linkByPost(formObject, useHash)

Diese Methode funktioniert in Verbindung mit den Methoden _setDomainName() und _setAllowLinker(), um domainübergreifendes Nutzer-Tracking zu ermöglichen. Die Methode _linkByPost() übergibt die GATC-Cookies aus dem verweisenden Formular in einem String, der an den Aktionswert des Formulars angehängt wird (HTTP POST), an eine andere Website. Diese Methode wird normalerweise verwendet, um das Nutzerverhalten zwischen einer Website und der Einkaufswagen-Website eines Drittanbieters zu erfassen, kann aber auch zum Senden von Cookie-Daten an andere Domains in Pop-ups oder iFrames verwendet werden.

Asynchrones Snippet (empfohlen)
    <form action="http://www.shoppingcartsite.com/myService/formProcessor.php"
    name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);">
...
</form>

Außerdem muss _setAllowLinker() auf der Zielwebseite auf true gesetzt sein, damit die Verknüpfung funktioniert.

Parameter

HTMLFormElement   formObject Formobjekt, das die POST-Anfrage einschließt.

Boolean   useHash Wird zum Übergeben von Tracking-Code-Variablen auf „true“ gesetzt. Dazu wird das Trennzeichen „#“ und nicht das standardmäßige ? als Trennzeichen für Abfragezeichenfolge.


_setAllowHash()

_setAllowHash(bool)

Legt das Flag für das Zulassen von Domain-Hashs fest. Standardmäßig ist dieser Wert auf true festgelegt. Die Domain-Hash-Funktion in Google Analytics erstellt einen Hash-Wert aus Ihrer Domain und verwendet diesen Wert, um die Cookie-Integrität für Besucher zu prüfen. Wenn Sie mehrere Subdomains wie example1.example.com und example2.example.com haben und das Nutzerverhalten über beide Subdomains hinweg erfassen möchten, deaktivieren Sie die Domain-Hash-Technologie, damit die Cookie-Integritätsprüfung ein Nutzer-Cookie, das von einer Domain zu einer anderen kommt, nicht ablehnt. Außerdem können Sie die Funktion deaktivieren, um die Leistung des Trackings pro Seite zu optimieren.

Parameter

Boolean   true oder false. Der Standardwert ist true. Wenn dieser Parameter auf true gesetzt ist, ist das Domain-Hashing aktiviert. Andernfalls ist die Domain-Hash-Technologie deaktiviert.

_setAllowLinker()

_setAllowLinker(bool)

Legt das Verknüpfungs-Funktions-Flag als Teil der Aktivierung des domainübergreifenden Nutzer-Trackings fest. Diese Methode ist standardmäßig auf false festgelegt und die Verknüpfung ist deaktiviert. Weitere Informationen zum domainübergreifenden Tracking finden Sie unter den Methoden _link(), _linkByPost() und _setDomainName(). Verwenden Sie auf der Zielwebsite die Methode _setAllowLinker, sodass die Zielwebsite die Cookiedaten im URL-Parameter anstelle der Standardsitzungslogik verwendet.

Asynchrones Snippet (empfohlen)
_gaq.push(['_setAllowLinker', true]); 

Parameter

Boolean  true oder false. Der Standardwert ist false. Wenn dieser Parameter auf true gesetzt ist, ist die Verknüpfung aktiviert. Andernfalls ist die Domainverknüpfung deaktiviert.

_setCookiePath()

_setCookiePath(newCookiePath)

Legt den neuen Cookie-Pfad für Ihre Website fest. Standardmäßig wird der Cookie-Pfad in Google Analytics auf die Stammebene (/) festgelegt. In den meisten Fällen ist diese Option die richtige Option und funktioniert ordnungsgemäß mit dem Tracking-Code, den Sie auf Ihrer Website, in Ihrem Blog oder im Webverzeichnis Ihres Unternehmens installieren. In einigen Fällen, in denen der Nutzerzugriff jedoch auf ein Unterverzeichnis einer Domain beschränkt ist, können mit dieser Methode Tracking-Probleme behoben werden, indem ein Unterverzeichnis als Standardpfad für das gesamte Tracking festgelegt wird.

In der Regel verwenden Sie diese Option, wenn Ihre Daten nicht verfolgt werden und Sie einen Blogdienst abonniert haben und nur Zugriff auf das von Ihnen definierte Unterverzeichnis haben, oder wenn Sie sich in einem Unternehmens- oder Universitätsnetzwerk befinden und nur Zugriff auf Ihr Basisverzeichnis haben.

Asynchrones Snippet (empfohlen)
_gaq.push(['_setCookiePath', '/myBlogDirectory']); 

Parameter

String   newCookiePath Es muss ein neuer Cookie-Pfad festgelegt werden.

_setDomainName()

_setDomainName(newDomainName)

Legt den Domainnamen für die GATC-Cookies fest. Für diese Methode gibt es drei Modi: ("auto" | "none" | [domain]). Standardmäßig ist die Methode auf auto festgelegt, wodurch versucht wird, den Domainnamen anhand des Attributs document.domain im DOM aufzulösen.

Domain angeben

Im Leitfaden zum domainübergreifenden Tracking finden Sie eine Vielzahl von Beispielen, die veranschaulichen, wann und wie eine Domain mit dieser Methode angegeben wird. Das folgende Beispiel zeigt, wie Sie den Domainnamen auf example.com festlegen würden:

Asynchrones Snippet (empfohlen)
_gaq.push(['_setDomainName', 'example.com']); 

Top-Level-Domains isolieren

Wenn diese Methode auf none gesetzt ist, sind die Cookies in einer bestimmten Domain nicht für Subdomains zugänglich.

Asynchrones Snippet (empfohlen)
_gaq.push(['_setDomainName', 'none']); 

Parameter

String   newDomainName Es wird ein neuer Standarddomainname festgelegt.

_storeGac(bool)

Legt fest, ob das GAC-Cookie erstellt werden soll oder nicht. Standardmäßig wird das GAC-Cookie vom Skript geschrieben und Sie müssen nichts weiter tun, um es zu schreiben. Sie können die Einstellung dieses Cookies mit dem folgenden Befehl deaktivieren.

Asynchrones Snippet (empfohlen)
_gaq.push(['_storeGac', false]);