Ce document de référence décrit les méthodes que vous utilisez pour personnaliser le fonctionnement des rapports Google Analytics sur plusieurs domaines, différents hôtes ou dans des sous-répertoires d'un site Web.
Méthodes du domaine/annuaire GATC
_cookiePathCopy(newPath)
_getLinkerUrl(targetUrl, useHash)
_link(targetUrl, useHash)
_linkByPost(formObject, useHash)
_setAllowHash(bool)
obsolète_setAllowLinker(bool)
_setCookiePath(newCookiePath)
_setDomainName(newDomainName)
_storeGac(bool)
Informations sur la méthode
_cookiePathCopy()
_cookiePathCopy(newPath)
Remplace les chemins d'accès de tous les cookies GATC par le chemin d'accès nouvellement spécifié. Utilisez cette fonctionnalité pour suivre le comportement des utilisateurs d'une structure de répertoires à une autre sur le 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 de tous les 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 qui peuvent avoir une incidence sur les valeurs des cookies ou les valeurs des campagnes (par exemple, _setCampaignCookieTimeout()
ou _setReferrerOverride()
).
_gaq.push(['_cookiePathCopy', '/newSubDirectory/']);
paramètres
String newPath
Nouveau chemin d'accès pour le stockage des cookies GATC.
_getLinkerUrl()
_getLinkerUrl(targetUrl, useHash)
Cette méthode fonctionne conjointement avec les méthodes _setDomainName()
et _setAllowLinker()
pour permettre le suivi des utilisateurs sur plusieurs domaines, en particulier pour les cadres iFrame et les liens qui s'ouvrent dans une nouvelle fenêtre. Cette méthode renvoie une chaîne de toutes les données du cookie GATC du lien de lancement en l'ajoutant au paramètre d'URL. Il peut ensuite être transmis à un autre site ou iFrame.
_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 de cookies.
Boolean useHash
Défini sur "true" pour la transmission des variables de code de suivi à l'aide du séparateur de balise d'ancrage # au lieu de la valeur par défaut ? séparateur de chaîne de requête.
returns
String
URL Linker.
_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.
<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 de cookies.
Boolean useHash
Défini sur "true" pour la transmission des variables de code de suivi à l'aide du séparateur de balise d'ancrage # au lieu de la valeur par défaut ? 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 sur plusieurs domaines. La méthode _linkByPost()
transmet les cookies GATC du formulaire de référence à un autre site dans une chaîne ajoutée à la valeur d'action du formulaire (HTTP POST). Cette méthode est généralement utilisée pour le suivi du comportement des utilisateurs d'un site vers un site de panier tiers, mais également pour l'envoi de données de cookies à d'autres domaines dans des fenêtres pop-up ou des cadres iFrame.
<form action="http://www.shoppingcartsite.com/myService/formProcessor.php" name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);">
...
</form>
De plus, _setAllowLinker()
doit être défini sur true
sur la page Web de destination pour que l'association fonctionne.
paramètres
HTMLFormElement formObject
Objet de formulaire encapsulant la requête POST.
Boolean useHash
Défini sur"true"pour la transmission des variables de code de suivi à l'aide du séparateur de balise d'ancrage # au lieu de la valeur par défaut ? séparateur de chaîne de requête.
_setAllowHash()
_setAllowHash(bool)
Définit l'option de hachage de domaine autorisée. 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 pour votre domaine et utilise ce nombre pour vérifier l'intégrité des cookies des visiteurs.
Si vous disposez de 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 un cookie utilisateur provenant d'un domaine à un autre. Vous pouvez également désactiver cette fonctionnalité pour optimiser les performances du suivi des pages.
paramètres
Boolean true
ou false
: la valeur par défaut est true
. Si ce paramètre est défini sur true
, le hachage du domaine est activé. Sinon, le hachage du domaine est désactivé.
_setAllowLinker()
_setAllowLinker(bool)
Définit l'indicateur de fonctionnalité Linker dans le cadre de l'activation du suivi des utilisateurs sur 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 pour que celui-ci utilise les données du cookie dans le paramètre d'URL plutôt que la logique de session standard.
_gaq.push(['_setAllowLinker', true]);
paramètres
Boolean true
ou false
La valeur par défaut est false
. Si ce paramètre est défini sur true
, Linker est activé. Sinon, l'association de domaines est désactivée.
_setCookiePath()
_setCookiePath(newCookiePath)
Définit le nouveau chemin de cookie de votre site. Par défaut, Google Analytics définit le chemin d'accès au cookie à la 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 annuaire d'entreprise. Toutefois, dans les cas où l'accès des utilisateurs 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.
En règle générale, vous devez vous en servir si vous n'effectuez pas le suivi de vos données et que vous vous êtes abonné à un service de blog et que vous n'avez accès qu'au sous-répertoire que vous avez défini, ou si vous êtes sur le réseau d'une entreprise ou d'une université et que vous n'avez accès qu'à votre répertoire d'accueil.
_gaq.push(['_setCookiePath', '/myBlogDirectory']);
paramètres
String newCookiePath
Nouveau chemin de cookie à définir.
_setDomainName()
_setDomainName(newDomainName)
Définit le nom de domaine des cookies GATC. Il existe trois modes pour cette méthode: ("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
du DOM.
Spécifier un domaine
Reportez-vous au Guide sur le suivi de plusieurs domaines pour obtenir divers exemples qui illustrent 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
:
_gaq.push(['_setDomainName', 'example.com']);
Isolement des domaines de premier niveau
Définir cette méthode sur none
garantit que les cookies d'un domaine donné ne sont accessibles par aucun sous-domaine.
_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 script GAC est écrit par le script, et aucune action de votre part n'est requise. Vous pouvez désactiver la définition de ce cookie à l'aide de la commande ci-dessous.
_gaq.push(['_storeGac', false]);