Code de suivi: configuration de base

Ce document de référence décrit les méthodes à utiliser pour personnaliser tous les aspects des rapports Google Analytics.

Méthodes de base de ga.js

Informations sur la méthode

_deleteCustomVar().

_deleteCustomVar(index)

Cette méthode supprime la variable attribuée à l'index fourni, le cas échéant. Par exemple, vous pouvez définir une variable personnalisée au niveau du visiteur, puis décider plus tard de ne plus l'utiliser.

Extrait asynchrone (recommandé)

_gaq.push(['_deleteCustomVar', 1]);

paramètres

Int   index : index de la variable personnalisée à supprimer.

_getName()

_getName()

Renvoie le nom donné à l'outil de suivi lors de sa création.

Extrait asynchrone (recommandé)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var trackerName = pageTracker._getName();
});

retours

String Nom de l'outil de suivi.

_getAccount()

_getAccount()

Renvoie l'ID Google Analytics de cet objet de suivi. Si vous suivez les pages de votre site Web dans plusieurs comptes, vous pouvez utiliser cette méthode pour déterminer le compte associé à un objet de suivi spécifique.

Extrait asynchrone (recommandé) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var accountId = pageTracker._getAccount();
});

retours

String ID de compte avec lequel cet objet de suivi est instancié.

_getVersion()

_getVersion()

Renvoie le numéro de version GATC.

Extrait asynchrone (recommandé) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var version = pageTracker._getVersion();
});

retours

Numéro de version GATC String.

_getVisitorCustomVar()

_getVisitorCustomVar(index)

Renvoie la valeur de la variable personnalisée de niveau visiteur attribuée à l'index spécifié.

Extrait asynchrone (recommandé) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var visitorCustomVar1Value = pageTracker._getVisitorCustomVar(1);
});

paramètres

Int   index Index de la variable personnalisée au niveau du visiteur

retours

String : valeur de la variable personnalisée au niveau du visiteur. Renvoie "non défini" s'il est impossible de récupérer la variable pour l'index spécifié.

_initData().

_initData()Obsolète. initData() s'exécute désormais automatiquement dans le code de suivi ga.js.

Initialise ou réinitialise l'objet GATC (Google Analytics Tracker Code).

var pageTracker = _gat._getTracker("UA-12345-1");
pageTracker._trackPageview();

_setAccount()

_setAccount(accountId)

Utilisé exclusivement pour le suivi asynchrone. Définit l'ID de propriété Web de l'objet de suivi.

_gaq.push(['_setAccount', 'UA-XXXXX-X']);

paramètres

String accountID : ID de propriété Web complet (par exemple, UA-65432-1) pour l'objet de suivi.

_setCookiePersistence()

_setCookiePersistence(milliseconds)

Cette méthode est obsolète. Veuillez utiliser _setVisitorCookieTimeout(cookieTimeoutMillis) à la place.

Définit le délai d'expiration du cookie Google Analytics du visiteur, en millisecondes. Par défaut, le cookie du visiteur expire au bout de deux ans. Si vous le souhaitez, vous pouvez modifier la date d'expiration du cookie du visiteur à l'aide de cette méthode. Par exemple, pour définir le délai d'expiration du cookie du visiteur sur sept jours, vous devez utiliser le code suivant:

pageTracker._setCookiePersistence(604800000);

paramètres

Number   milliseconds Délai d'expiration des cookies du nouveau visiteur.

_setCustomVar()

_setCustomVar(index, name, value, opt_scope)

Définit une variable personnalisée avec le nom, la valeur et le champ d'application fournis. La longueur combinée de name et de value est limitée à 128 octets.

Extrait asynchrone (recommandé) 

_gaq.push(['_setCustomVar', 1, 'Section', 'Life & Style', 3]);

retours

Boolean Cette méthode renvoie true si la variable personnalisée a bien été définie, et false dans le cas contraire (par exemple, si la longueur de la chaîne de votre nom/valeur dépasse 128 octets ou si vous utilisez un emplacement incorrect).

paramètres

Int      index       Obligatoire. Espace utilisé pour la variable personnalisée. Les valeurs possibles sont 1-5, inclus.

String   name        Obligatoire. Nom de la variable personnalisée.

String   value       Obligatoire. Valeur de la variable personnalisée.

Int      opt_scope   Facultatif. Champ d'application utilisé pour la variable personnalisée. Les valeurs possibles sont 1 pour le niveau du visiteur, 2 pour le niveau de la session et 3 pour le niveau de la page.

_setSampleRate()

_setSampleRate(newRate)

Définit le nouveau taux d'échantillonnage. Si votre site Web est particulièrement volumineux et qu'il fait l'objet de pics de trafic importants, la définition du taux d'échantillonnage vous permet de suivre sans interruption les rapports. Dans Google Analytics, l'échantillonnage est effectué régulièrement pour les visiteurs uniques. Par conséquent, les tendances et les rapports sont préservés même lorsque l'échantillonnage est activé, car les visiteurs uniques restent inclus ou exclus de l'échantillon, tel que défini au début de l'échantillonnage.

Vous ne devez spécifier cette méthode qu'en même temps que la fonction _setAccount(), généralement une fois par page ou par application (où vous initialisez le code de suivi lui-même). N'oubliez pas que la valeur de taux d'échantillonnage que vous spécifiez reste en vigueur tant que l'objet de suivi est conservé.

Extrait asynchrone (recommandé) 

_gaq.push(['_setSampleRate', '2.5']);

paramètres

String newRate Nouveau taux d'échantillonnage à définir. Saisissez une chaîne numérique comprise entre 0 et 100 (avec deux chiffres après la virgule).

_setSessionTimeout()

_setSessionTimeout(newTimeout)

Cette méthode est obsolète. Veuillez utiliser _setSessionCookieTimeout(cookieTimeoutMillis) à la place.

Définit le nouveau délai avant expiration de la session, en secondes. Par défaut, le délai avant expiration de la session est défini sur 30 minutes (1 800 secondes). Le délai avant expiration de la session est utilisé pour calculer les visites (voir Définition d'une session dans Analytics). Si vous souhaitez modifier la définition d'une "session" en fonction de vos besoins particuliers, vous pouvez transmettre le nombre de secondes pour définir une nouvelle valeur. Cela aura un impact sur les rapports "Visites" dans chaque section où le nombre de visites est calculé et où les visites sont utilisées pour calculer d'autres valeurs. Par exemple, le nombre de visites augmente généralement si vous raccourcissez le délai d'expiration de la session, mais il diminue lorsque vous l'augmentez.

paramètres

String newTimeout Nouveau délai avant expiration de la session à définir en secondes.

_setSessionCookieTimeout()

_setSessionCookieTimeout(cookieTimeoutMillis)

Définit le délai d'expiration du nouveau cookie de session, en millisecondes. Par défaut, le délai avant expiration d'une session est défini sur 30 minutes. Le délai avant expiration de la session est utilisé pour calculer les visites, car celles-ci se terminent au bout de 30 minutes d'inactivité du navigateur ou à la fermeture du navigateur. Si vous souhaitez modifier la définition d'une "session" en fonction de vos besoins spécifiques, vous pouvez indiquer le nombre de millisecondes pour définir une nouvelle valeur. Cela aura un impact sur les rapports "Visites", dans chaque section où le nombre de visites est calculé et où les visites sont utilisées pour calculer d'autres valeurs. Par exemple, le nombre de visites augmente si vous raccourcissez le délai d'expiration de la session, mais il diminue si vous l'augmentez. Vous pouvez définir le délai d'expiration sur 0 pour indiquer que ce cookie doit être supprimé à la fermeture du navigateur.

Extrait asynchrone (recommandé) 

_gaq.push(['_setSessionCookieTimeout', 1800000]);


paramètres

Number cookieTimeoutMillis Nouveau délai avant expiration de la session en millisecondes ou 0 pour supprimer le cookie à la fermeture du navigateur.

_setSiteSpeedSampleRate()

_setSiteSpeedSampleRate(sampleRate)

Définit une nouvelle taille d'échantillon pour la collecte de données "Vitesse du site". Par défaut, les métriques "Vitesse du site" proviennent d'un groupe de données issues d'un échantillon fixe de 1% des visiteurs de votre site. Si le nombre de visiteurs quotidiens de votre site est relativement faible (100 000 ou moins, par exemple), vous pouvez augmenter le taux d'échantillonnage. Le temps de chargement des pages et d'autres métriques de vitesse du site seront ainsi plus précises. Pour en savoir plus sur les rapports "Vitesse du site", consultez l'article Vitesse du site du centre d'aide.

La méthode _setSiteSpeedSampleRate() doit être appelée avant _trackPageview() pour être efficace.

Analytics limite les appels de collecte de la vitesse du site pour une seule propriété à 1% d'utilisateurs ou 10 000 appels par jour, selon le plus élevé, afin d'assurer une répartition équitable des ressources système pour cette fonctionnalité.

Remarque:Nous recommandons vivement aux sites enregistrant plus d'un million d'appels par jour de conserver la sélection d'échantillons sur le taux par défaut de 1 %. Augmenter la taille de l'échantillon n'augmente pas la taille de l'échantillon.

Extrait asynchrone (recommandé) 

_gaq.push(['_setSiteSpeedSampleRate', 5]);
_gaq.push(['_trackPageview']);

paramètres

Number sampleRate Valeur comprise entre 0 et 100 permettant de définir le pourcentage de visiteurs de votre site mesuré pour la vitesse du site. Par exemple, la valeur 5 définit l'échantillon de collecte "Vitesse du site" sur 5%.

_setVisitorCookieTimeout()

_setVisitorCookieTimeout(cookieTimeoutMillis)

Définit le délai d'expiration du cookie Google Analytics du visiteur, en millisecondes. Par défaut, le cookie du visiteur expire au bout de deux ans. Si vous le souhaitez, vous pouvez modifier la date d'expiration du cookie visiteur à l'aide de cette méthode. Vous pouvez définir le délai d'expiration sur 0 pour indiquer que ce cookie doit être supprimé à la fermeture du navigateur.

Extrait asynchrone (recommandé) 

_gaq.push(['_setVisitorCookieTimeout', 63072000000]);

paramètres

Number cookieTimeoutMillis Délai d'expiration du cookie du nouveau visiteur en millisecondes ou 0 pour supprimer le cookie à la fermeture du navigateur.

_setVar()

_setVar(newVal)

Cette méthode est obsolète. Veuillez utiliser _setCustomVar() à la place.

Définit ou définit un segment de visiteurs personnalisé à l'aide de la chaîne fournie. Vous pouvez utiliser cette valeur pour fournir une segmentation supplémentaire des utilisateurs de votre site Web. Par exemple, il peut s'agir d'une page de connexion ou d'un formulaire qui déclenche une valeur en fonction des informations saisies par le visiteur, comme une préférence choisie par le visiteur ou une option de confidentialité. Cette variable est ensuite mise à jour dans le cookie de ce visiteur. Une fois implémenté sur votre site et collecté via cette méthode, le segment nouvellement défini apparaît dans les rapports Personnalisés de la section "Visiteurs" des rapports Analytics. Vous pouvez également accéder au segment Valeur définie par l'utilisateur dans le rapport "Détail du contenu" pour connaître le pourcentage de visiteurs d'une page appartenant à un segment particulier que vous définissez.

paramètres

String newVal Nouvelle valeur personnalisée à définir.

_trackPageLoadTime()

_trackPageLoadTime()

Cette méthode est obsolète, car la création de rapports "Vitesse du site" est activée automatiquement pour tous les utilisateurs. Veuillez utiliser _setSiteSpeedSampleRate() afin d'ajuster le taux d'échantillonnage des rapports "Vitesse du site".

Active les rapports "Vitesse du site" pour cette page. Insérez cette méthode pour chaque page de votre site pour laquelle vous souhaitez générer des rapports "Vitesse du site". Pour en savoir plus sur les rapports "Vitesse du site" dans Analytics, consultez l'article Vitesse du site dans notre centre d'aide.

Vérification de vos modifications

Si des données apparaissent dans les rapports, cela signifie que votre configuration est correcte. Si aucune donnée ne s'affiche après 24 heures, vérifiez votre personnalisation pour vous assurer qu'elle n'a commis aucune erreur. Consultez la page Résoudre les problèmes liés au code de suivi pour obtenir la liste des erreurs courantes concernant le code de suivi. Ce guide de dépannage contient également les étapes de débogage de base et plus d'informations sur le débogage.

Sachez que l'activation du suivi de la vitesse de votre site entraîne une demande supplémentaire auprès des serveurs Google Analytics, distincte de la demande GIF de suivi des pages effectuée pour les pages vues. Pour limiter l'impact sur la latence globale du site, cette demande n'est envoyée que sur un échantillon de pages vues sur votre site. C'est pourquoi vous risquez de ne pas toujours voir la demande GIF de vitesse du site lorsque vous tentez de déboguer cette fonctionnalité dans Firebug ou d'autres outils. Ceci est normal et prévu.

Extrait asynchrone (recommandé) 

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview']);
_gaq.push(['_trackPageLoadTime']);

_trackPageview()

_trackPageview(opt_pagePath)

Logique principale pour GATC (Google Analytics Tracker Code). Si les fonctionnalités Linker sont activées, il tente d'extraire les valeurs des cookies de l'URL. Sinon, il tente d'extraire les valeurs des cookies de document.cookie. Il met également à jour ou crée des cookies si nécessaire, puis les réécrit dans l'objet Document. Elle rassemble toutes les métriques appropriées à envoyer à l'interface UCFE (Urchin Collector).

Extrait asynchrone (recommandé) 

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview', '/home/landingPage']);

paramètres

String opt_pagePath Paramètre facultatif permettant d'indiquer le chemin de la page sous lequel effectuer le suivi des métriques. Lorsque vous utilisez cette option, utilisez une barre oblique initiale (/) pour indiquer le chemin de la page.