Code de suivi: domaines et répertoires

Ce document de référence décrit les méthodes à utiliser pour personnaliser le fonctionnement des rapports Google Analytics sur plusieurs domaines, différents hôtes ou dans les sous-répertoires d'un site Web.

Méthodes de domaine/annuaire GATC

Informations sur la méthode

_cookiePathCopy()

_cookiePathCopy(newPath)

Remplace les chemins de tous les cookies GATC par le chemin nouvellement spécifié. Utilisez cette fonctionnalité pour suivre le comportement des utilisateurs d'une structure de répertoires à une autre au sein du même domaine.

Lorsque cette fonction est appelée, elle copie immédiatement tous les cookies dans le nouveau chemin de cookie. Par conséquent, si la méthode _trackPageview() n'a pas été appelée, les valeurs des cookies Analytics existants sont fournies. C'est pourquoi nous vous recommandons d'appeler cette méthode après _trackPageview(), ainsi que d'autres méthodes de configuration susceptibles d'avoir un impact sur les valeurs de cookie ou de campagne que vous souhaitez transmettre, telles que _setCampaignCookieTimeout() ou _setReferrerOverride().

Extrait asynchrone (recommandé) 
_gaq.push(['_cookiePathCopy', '/newSubDirectory/']);

paramètres

String   newPath Nouveau chemin de stockage des cookies GATC.

_getLinkerUrl()

_getLinkerUrl(targetUrl, useHash)

Associée aux méthodes _setDomainName() et _setAllowLinker(), cette méthode permet d'activer le suivi des utilisateurs sur plusieurs domaines, spécifiquement pour les cadres iFrame et les liens qui s'ouvrent dans une nouvelle fenêtre. Cette méthode renvoie une chaîne contenant toutes les données du cookie GATC à partir du lien de lancement en l'ajoutant au paramètre d'URL. Il peut ensuite être transmis à un autre site ou iFrame.

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

paramètres

String   targetUrl URL du site cible auquel envoyer les valeurs des cookies.

Boolean   useHash Défini sur "true" pour transmettre les variables du code de suivi en utilisant le séparateur de balise d'ancrage # au lieu du séparateur par défaut ? le séparateur de chaîne de requête.

retours

String URL de l'éditeur de liens.

_link()

_link(targetUrl, useHash)

Cette méthode fonctionne conjointement avec les méthodes _setDomainName() et _setAllowLinker() pour permettre le suivi des utilisateurs sur plusieurs domaines. La méthode _link() transmet les cookies GATC de ce site à un autre via des paramètres d'URL (HTTP GET). Elle modifie également le document.location et redirige l'utilisateur vers la nouvelle URL.

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

paramètres

String   targetUrl URL du site cible auquel envoyer les valeurs des cookies.

Boolean   useHash Défini sur "true" pour transmettre les variables du code de suivi en utilisant le séparateur de balise d'ancrage # au lieu du séparateur par défaut ? le séparateur de chaîne de requête.

_linkByPost()

_linkByPost(formObject, useHash)

Cette méthode fonctionne conjointement avec les méthodes _setDomainName() et _setAllowLinker() pour permettre le suivi des utilisateurs de plusieurs domaines. La méthode _linkByPost() transmet les cookies GATC du formulaire référent à un autre site dans une chaîne ajoutée à la valeur de l'action sous la forme (HTTP POST). Cette méthode est généralement utilisée pour suivre le comportement des utilisateurs d'un site vers un site tiers de panier d'achat, mais elle peut également servir à envoyer des données de cookies à d'autres domaines dans des fenêtres pop-up ou des iFrames.

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

En outre, _setAllowLinker() doit être défini sur true sur la page Web de destination pour que l'association fonctionne.

paramètres

HTMLFormElement   formObject Objet Formulaire encapsulant la requête POST.

Boolean   useHash Défini sur "true" pour transmettre les variables du code de suivi en utilisant le séparateur de balise d'ancrage # au lieu du séparateur par défaut ? le séparateur de chaîne de requête.

_setAllowHash()

_setAllowHash(bool)

Définit l'indicateur d'autorisation de hachage du domaine. Par défaut, cette valeur est définie sur true. La fonctionnalité de hachage de domaine de Google Analytics crée une valeur de hachage à partir de votre domaine et l'utilise pour vérifier l'intégrité des cookies des visiteurs. Si vous possédez plusieurs sous-domaines, tels que example1.example.com et example2.example.com, et que vous souhaitez suivre le comportement des utilisateurs sur ces deux sous-domaines, vous devez désactiver le hachage de domaine afin que la vérification de l'intégrité des cookies ne rejette pas le cookie d'un utilisateur provenant d'un autre domaine. Vous pouvez également désactiver cette fonctionnalité pour optimiser les performances du suivi par page.

paramètres

La valeur par défaut de Boolean   true ou false est true. Si ce paramètre est défini sur true, le hachage de domaine est activé. Sinon, le hachage du domaine est désactivé.

_setAllowLinker()

_setAllowLinker(bool)

Définit l'indicateur de fonctionnalité de l'éditeur de liens dans le cadre de l'activation du suivi des utilisateurs de plusieurs domaines. Par défaut, cette méthode est définie sur false, et l'association est désactivée. Consultez également les méthodes _link(), _linkByPost() et _setDomainName() pour activer le suivi de plusieurs domaines. Utilisez la méthode _setAllowLinker sur le site cible, de sorte que celui-ci utilise les données des cookies dans le paramètre d'URL au lieu de la logique de session standard.

Extrait asynchrone (recommandé) 
_gaq.push(['_setAllowLinker', true]);

paramètres

La valeur par défaut de Boolean  true ou false est false. Si ce paramètre est défini sur true, l'éditeur de liens est activé. Sinon, l'association de domaines est désactivée.

_setCookiePath()

_setCookiePath(newCookiePath)

Définit le nouveau chemin de cookie pour votre site. Par défaut, Google Analytics définit le chemin de cookie sur le niveau racine (/). Dans la plupart des cas, il s'agit de l'option appropriée et fonctionne correctement avec le code de suivi que vous installez sur votre site Web, votre blog ou votre répertoire Web d'entreprise. Toutefois, dans les cas où l'accès de l'utilisateur est limité à un sous-répertoire d'un domaine, cette méthode peut résoudre les problèmes de suivi en définissant un sous-répertoire comme chemin par défaut pour tous les suivis.

Généralement, cette option est utile si vos données ne sont pas suivies, que vous êtes abonné à un service de blog et que vous n'avez accès qu'au sous-répertoire défini, ou si vous êtes sur un réseau d'entreprise ou d'université et que vous n'avez accès qu'à votre répertoire d'accueil.

Extrait asynchrone (recommandé) 
_gaq.push(['_setCookiePath', '/myBlogDirectory']);

paramètres

String   newCookiePath Nouveau chemin de cookie à définir.

_setDomainName()

_setDomainName(newDomainName)

Définit le nom de domaine pour les cookies GATC. Cette méthode comporte trois modes: ("auto" | "none" | [domain]). Par défaut, la méthode est définie sur auto, qui tente de résoudre le nom de domaine en fonction de la propriété document.domain dans le DOM.

Spécifier un domaine

Consultez le Guide de suivi de plusieurs domaines pour obtenir des exemples qui montrent quand et comment spécifier un domaine avec cette méthode. L'exemple suivant montre comment définir le nom de domaine sur example.com:

Extrait asynchrone (recommandé) 
_gaq.push(['_setDomainName', 'example.com']);

Isoler des domaines de premier niveau

Définir cette méthode sur none garantit que les cookies d'un domaine donné ne sont accessibles à aucun sous-domaine.

Extrait asynchrone (recommandé) 
_gaq.push(['_setDomainName', 'none']);

paramètres

String   newDomainName Nouveau nom de domaine par défaut à définir.

_storeGac(bool)

Détermine si le cookie GAC doit être créé ou non. Par défaut, le cookie GAC est écrit par le script, et vous n'avez rien à faire pour l'écrire. Vous pouvez désactiver le paramétrage de ce cookie à l'aide de la commande ci-dessous.

Extrait asynchrone (recommandé) 
_gaq.push(['_storeGac', false]);