Variables personnalisées - Suivi Web (ga.js)

Les variables personnalisées sont des balises de paire nom/valeur que vous pouvez insérer dans votre code de suivi afin d'affiner le suivi Google Analytics. Les variables personnalisées vous permettent de définir des segments supplémentaires à appliquer à vos visiteurs, en plus de ceux déjà fournis par Analytics. Ce document décrit les variables personnalisées et explique comment les configurer.

Présentation

Pour tirer pleinement parti des variables personnalisées, vous devez comprendre le modèle d'interaction de base des visiteurs utilisé dans Google Analytics. Dans ce modèle, l'utilisateur interagit avec votre contenu sur une période donnée, et cet engagement est hiérarchisé.

Ce diagramme illustre ce modèle pour un seul visiteur de votre site. Chaque bloc représente le nombre de sessions utilisateur et d'interactions de cet utilisateur.

Chaque niveau de ce modèle est défini comme suit:

  • Visiteur : client qui visite le site (par exemple, le navigateur ou le téléphone mobile utilisé par une personne).
  • Session : période pendant laquelle l'internaute est actif sur le site.
  • Page : activité au nom de l'utilisateur qui envoie une demande GIF aux serveurs Analytics. Cela se caractérise généralement par une page vue, mais cela peut inclure les éléments suivants :
    • Une page vue
    • Un événement (par exemple, un clic sur le bouton de lecture d'un film)

Chacun de ces trois niveaux d'interaction définit une portée spécifique de l'engagement des visiteurs. Cette distinction est importante pour les variables personnalisées, car chaque variable personnalisée est limitée à un champ d'application particulier. Par exemple, vous pouvez connaître le nombre de sessions au cours desquelles les visiteurs ont supprimé un article de leur panier. Dans ce cas, vous devez définir la variable personnalisée au niveau de la session, de sorte que toute la session de ce visiteur soit signalée comme une session dans laquelle des articles ont été supprimés du panier en ligne.

Haut de page

Utiliser des variables personnalisées

Étant donné que vous pouvez configurer diverses variables personnalisées pour suivre l'activité des utilisateurs sur votre site, vous créerez le plus souvent vos propres utilitaires JavaScript pour les gérer. Votre script utilisera la méthode de base pour créer une variable personnalisée comme suit:

_setCustomVar(index, name, value, opt_scope)

Cette méthode accepte quatre paramètres:

  • index : emplacement de la variable personnalisée. Obligatoire. Il s'agit d'un nombre dont la valeur peut être comprise entre 1 et 5 inclus. Une variable personnalisée doit être placée dans un seul emplacement et ne doit pas être réutilisée pour différents emplacements.
  • name : nom de la variable personnalisée. Obligatoire. Cette chaîne identifie la variable personnalisée et apparaît dans le rapport Variables personnalisées de premier niveau des rapports Analytics.
  • valeur : valeur de la variable personnalisée. Obligatoire. Il s'agit d'une chaîne associée à un nom. Vous pouvez associer plusieurs valeurs à un nom de variable personnalisée. La valeur apparaît dans la liste des tableaux de l'interface utilisateur pour un nom de variable sélectionné. Généralement, vous avez au moins deux valeurs pour un nom donné. Par exemple, vous pouvez définir un nom de variable personnalisée gender et fournir male et female comme deux valeurs possibles.
  • opt_scope : champ d'application de la variable personnalisée. Facultatif. Comme décrit ci-dessus, le champ d'application définit le niveau d'engagement des utilisateurs sur votre site. Il s'agit d'un nombre dont les valeurs possibles sont 1 (au niveau du visiteur), 2 (au niveau de la session) ou 3 (au niveau de la page). Lorsqu'elle n'est pas définie, le champ d'application de la variable personnalisée est défini par défaut sur l'interaction au niveau de la page.

L'extrait de code suivant montre comment définir une variable personnalisée pour suivre les visites au cours desquelles les utilisateurs ont supprimé des articles de leur panier. Ici, la méthode _setCustomVar() est appelée juste avant une méthode _trackEvent(), afin d'être diffusée dans la requête GIF envoyée par la méthode _trackEvent(). Il utilise le nom Items Removed avec la valeur Yes afin de définir cette activité des utilisateurs du site Web. Il est également judicieux de définir également une variable personnalisée par défaut pour Items Removed et No. Cette méthode permet d'obtenir le nombre de visites au cours desquelles des articles ont été supprimés du panier et le nombre de visites n'incluant pas la suppression de l'article.

Extrait asynchrone (recommandé)

 _gaq.push(['_setCustomVar',
      1,                   // This custom var is set to slot #1.  Required parameter.
      'Items Removed',     // The name acts as a kind of category for the user activity.  Required parameter.
      'Yes',               // This value of the custom variable.  Required parameter.
      2                    // Sets the scope to session-level.  Optional parameter.
   ]);
 _gaq.push(['_trackEvent',
      'Shopping', // category of activity
      'Item Removal', // Action
   ]);

Une fois que vous avez configuré les variables personnalisées, vous pouvez les supprimer à l'aide de la méthode _deleteCustomVar(index).

Haut de page

Exemples de cas d'utilisation

Vous pouvez implémenter les variables personnalisées de différentes manières, en fonction du modèle de votre site Web et des besoins de votre entreprise. Les exemples explorent différents cas d'utilisation, chacun illustrant un niveau de champ d'application différent:

Variables personnalisées au niveau de la page

Utilisez des variables personnalisées au niveau de la page pour définir un ensemble d'activités au niveau de la page par vos utilisateurs.

Par exemple, supposons que vous gériez le site Web d'un journal en ligne, où les visiteurs consultent de nombreux articles différents. Bien qu'il soit facile d'identifier les articles les plus populaires, vous pouvez désormais utiliser des variables personnalisées pour déterminer quelles rubriques du journal sont les plus populaires. Pour ce faire, définissez une variable personnalisée au niveau de la page pour chaque article, la section correspondant à cet article étant définie en tant que variable personnalisée. Par exemple, il peut y avoir des sections telles que Vie et style, Opinion et Économie. Vous pouvez définir une variable personnalisée pour suivre tous vos articles par section.

Extrait asynchrone (recommandé)

_gaq.push(['_setCustomVar',
      1,                   // This custom var is set to slot #1.  Required parameter.
      'Section',           // The top-level name for your online content categories.  Required parameter.
      'Life & Style',  // Sets the value of "Section" to "Life & Style" for this particular aricle.  Required parameter.
      3                    // Sets the scope to page-level.  Optional parameter.
   ]);

Poursuivons avec cet exemple et supposons que vous souhaitiez non seulement ajouter un tag à la section d'un article spécifique, mais aussi à la sous-section. Par exemple, la rubrique Vie et style de votre journal peut également comporter plusieurs sous-sections, telles que Alimentation et boissons, Mode et Sports. Ainsi, pour un article particulier, vous pouvez suivre à la fois la section et la sous-section. Vous pouvez définir une variable personnalisée supplémentaire pour suivre tous vos articles par sous-section.

Extrait asynchrone (recommandé)

_gaq.push(['_setCustomVar',
          2,                   // This custom var is set to slot #2.  Required parameter.
          'Sub-Section',       // The 2nd-level name for your online content categories.  Required parameter.
          'Fashion',           // Sets the value of "Sub-section" to "Fashion" for this particular article.  Required parameter.
          3                    // Sets the scope to page-level.  Optional parameter.
         ]);

Dans cet exemple, vous définissez deux variables personnalisées au niveau de la page simultanées pour une seule page. Pour chaque page, vous pouvez suivre jusqu'à cinq variables personnalisées, chacune avec un emplacement distinct. Cela signifie que vous pouvez attribuer trois variables personnalisées supplémentaires sur cette même page. Vous pouvez configurer un tableau de variables personnalisées au niveau de la page pour tous les articles de votre site Web afin d'en effectuer le suivi selon différentes sections et sous-sections. Pour en savoir plus sur l'utilisation correcte des variables personnalisées au niveau de la page, consultez les consignes d'utilisation ci-dessous.

Haut de page

Variables personnalisées au niveau de la session

Utilisez des variables personnalisées au niveau de la session pour distinguer les différentes expériences des visiteurs d'une session à l'autre.

Par exemple, si votre site Web permet aux utilisateurs de se connecter, vous pouvez utiliser une variable personnalisée limitée au niveau de la session pour l'état de connexion des utilisateurs. Vous pouvez ainsi segmenter les visites selon qu'elles proviennent de membres connectés ou non.

Extrait asynchrone (recommandé)

_gaq.push(['_setCustomVar',
      1,             // This custom var is set to slot #1.  Required parameter.
      'User Type',   // The name of the custom variable.  Required parameter.
      'Member',      // Sets the value of "User Type" to "Member" or "Visitor" depending on status.  Required parameter.
       2             // Sets the scope to session-level.  Optional parameter.
   ]);

Supposons que vous souhaitiez suivre à la fois le type d'utilisateur et si une tentative d'achat a eu lieu pour une session donnée. Si nous supposons que chaque page permet à l'utilisateur de se connecter, nous pouvons réserver l'emplacement n°1 pour la variable personnalisée Type d'utilisateur et utiliser un autre emplacement pour la tentative d'achat:

Extrait asynchrone (recommandé)

_gaq.push(['_setCustomVar',
      2,                   // This custom var is set to slot #2.  Required parameter.
      'Shopping Attempts', // The name of the custom variable.  Required parameter.
      'Yes',               // The value of the custom variable.  Required parameter.
                           //  (you might set this value by default to No)
      2                    // Sets the scope to session-level.  Optional parameter.
   ]);

Haut de page

Variables personnalisées au niveau du visiteur

Utilisez des variables personnalisées de niveau visiteur pour distinguer les catégories de visiteurs sur plusieurs sessions.

Par exemple, si vos sites Web proposent du contenu premium aux abonnés payants, vous pouvez définir une variable personnalisée au niveau des visites. Cela vous permettra d'analyser quels utilisateurs sont abonnés payants, à quel niveau de paiement et quels utilisateurs bénéficient du niveau de service sans frais pour le site. Vous définirez probablement cette variable personnalisée comme une fonction ponctuelle, car la valeur sera conservée pendant la durée de vie du cookie du visiteur.

Extrait asynchrone (recommandé)

_gaq.push(['_setCustomVar',
      1,                // This custom var is set to slot #1.  Required parameter.
      'Member Type',    // The name of the custom variable.  Required parameter.
      'Premium',        // The value of the custom variable.  Required parameter.
                        //  (possible values might be Free, Bronze, Gold, and Platinum)
      1                 // Sets the scope to visitor-level.  Optional parameter.
 ]);

Consignes d'utilisation

Cette section décrit les différences entre les différents types de variables personnalisées et explique comment les utiliser correctement:

Types de variables personnalisées

Le tableau ci-dessous définit les principales caractéristiques des différents types de variables. N'oubliez pas qu'il existe certaines restrictions lorsque les mêmes emplacements sont utilisés par différentes variables.

La longueur totale combinée d'un nom et d'une valeur de variable personnalisée ne doit pas dépasser 128 caractères.

Haut de page

  Durée Lorsque vous partagez un emplacement avec d'autres variables Nombre autorisé
Au niveau de la page

Un seul appel de page vue, d'événement ou de transaction.

 La dernière variable au niveau de la page à appeler sur une page est celle qui lui est appliquée.

Pour toute propriété Web (ensemble de pages), de nombreuses variables uniques au niveau de la page peuvent être définies et les emplacements peuvent être réutilisés. Limité uniquement par le nombre d'appels au cours d'une session donnée.

Pour chaque page, vous pouvez définir jusqu'à cinq variables personnalisées simultanées.

Au niveau de la session

Session actuelle du visiteur.

La dernière variable au niveau de la session appelée dans une session est celle utilisée pour cette session.
Exemple : Si login=false pour l'emplacement 1 au début de la session et login=true ultérieurement pour l'emplacement 1, la session est définie sur true pour login.

Ignore toute variable au niveau de la page précédemment définie et appelée au cours de la même session.
Exemple: Si l'emplacement n°1 est d'abord utilisé pour category=sports, puis pendant login=true pour une session, category=sports ne sera pas enregistré pour cette session.

Pour chaque propriété Web, vous pouvez créer autant de variables personnalisées au niveau de la session distinctes que possible (avec une limite de 128 caractères pour la paire clé-valeur).

Pour chaque session utilisateur, vous pouvez définir jusqu'à cinq variables au niveau de la session.
Au niveau du visiteur

Session en cours et toutes les sessions futures pendant la durée de vie du cookie du visiteur.

La dernière valeur définie pour un visiteur est celle qui s'applique aux sessions en cours et futures.

Pour chaque propriété Web, vous pouvez créer jusqu'à cinq variables distinctes au niveau du visiteur.

Haut de page

Soyez prudent lorsque vous combinez différents types de variables

En règle générale, il est déconseillé de combiner le même emplacement de variable personnalisée avec différents types, car cela peut entraîner des calculs de métriques étranges.

Lorsque vous utilisez plusieurs variables personnalisées de niveau page, session et visiteur pour votre propriété Web, vous devez déterminer avec soin la réutilisation des emplacements. En cas de situation sur votre site Web où une variable personnalisée au niveau de la page ou de la session utilise le même emplacement en même temps qu'une variable au niveau de la page est définie, seule la variable au niveau de la session (ou au niveau de la page) sera enregistrée.

Les scénarios suivants illustrent une combinaison de variables au niveau de la page, de la session et du visiteur définies par un seul utilisateur dans le même navigateur. Dans chaque exemple, l'emplacement est indiqué par le numéro entre parenthèses, et S: indique le champ d'application de la variable.

Cas 1 : la dernière variable définie au niveau de la session est prioritaire

Ici, la dernière page réutilise une variable personnalisée de niveau session dans l'emplacement 1 afin qu'elle soit prioritaire.

Visite 1 Page 1
(1) S:au niveau de la page
section=opinion		 Page 2
(1) S: au niveau de la session
login=true		 Page 3
(1) S: au niveau de la session
converted=true

Le rapport sur les visites serait le suivant:

  • Nombre de visites pour section=opinion: 0
  • Nombre de visites pour login=true: 0
  • # visite pour convertie=true: 1

Cas 2 : la variable initiale au niveau du visiteur est prioritaire

Ici, l'emplacement 1 est d'abord utilisé par une variable personnalisée de niveau visiteur lors de la visite 1, suivie d'une variable personnalisée au niveau de la page dans la visite 3. Dans cet ordre, la variable au niveau du visiteur n'écrase pas la variable au niveau de la page.

Visite 1 Page 1
(1) S:niveau visiteur
gender=male
Visite 2 Page 1
(2) S:Au niveau de la session
converted=false
Visite 3 Page 1
(1) S:au niveau de la page
section=opinion

Le rapport sur les visites serait le suivant:

  • Nombre de visites pour sexe=homme: 2
  • # visite pour convertie=false: 1
  • Nombre de visites pour section=opinion: 1
  • N'utilisez pas de noms de clé en double dans les emplacements.
  • Appelez la fonction _setCustomVar() lorsqu'elle peut être définie avant une requête de page vue ou une requête GIF d'événement.
    Dans certains cas, cela n'est pas toujours possible. Vous devrez définir une autre requête _trackPageview() après avoir défini une variable personnalisée. En règle générale, cette opération n'est nécessaire que dans les cas où l'utilisateur déclenche une variable personnalisée au niveau de la session ou de la visite, lorsqu'il n'est pas possible de grouper cette méthode avec un appel de suivi de page vue, d'événement ou d'e-commerce.
  • Utilisez une matrice d'emplacements pour suivre un grand nombre de variables personnalisées.
    Si vous avez des exigences de suivi complexes, avec une combinaison de variables au niveau de la page et de la session qui peuvent entrer en conflit, vous devez créer une matrice d'emplacements pour vous assurer que les variables au niveau de la session ne surchargent pas par inadvertance les variables au niveau de la page.
  • Envisagez d'utiliser le suivi des événements pour certaines applications plutôt que les variables personnalisées.
    Par exemple, supposons que vous possédiez une boutique de musique en ligne et que vous souhaitiez suivre à la fois les sessions de connexion, les tentatives d'achat et les sessions au cours desquelles des extraits musicaux ont été écoutés. Pour ce faire, il est judicieux d'utiliser le suivi des événements pour suivre le nombre de tentatives de lecture de musique plutôt que d'utiliser des variables au niveau de la session. Ici, vous pouvez utiliser le paramètre de la quatrième valeur de l'appel de suivi des événements pour transmettre les données de session à partir de vos propres cookies.
  • N'utilisez pas de variables au niveau de la session pour suivre un comportement que vous pouvez suivre avec des variables au niveau de la page.
    Par exemple, supposons que vous effectuiez le suivi de l'état de la connexion et des tentatives d'achat par session, et que votre site propose une page "Offre spéciale membres" que vous souhaitez également suivre. Étant donné qu'une variable personnalisée au niveau de la page indique le nombre de visites pour cette variable spécifique, vous connaîtrez déjà au moins une fois le nombre de visites incluant cette page.

Haut de page