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

Les variables personnalisées sont des balises de paires 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, autres que ceux déjà fournis par Analytics. Ce document décrit les variables personnalisées et explique comment les configurer.

Présentation

Vous tirerez le meilleur parti des variables personnalisées si vous comprenez le modèle d'interaction de base des visiteurs utilisé dans Google Analytics. Dans ce modèle, le visiteur interagit avec votre contenu au cours d'une période donnée, et l'engagement avec votre site est divisé en une hiérarchie.

Le schéma illustre ce modèle pour un seul visiteur de votre site, où chaque bloc représente le nombre de sessions utilisateur et d'interactions de cet utilisateur spécifique.

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

  • Visiteur : client qui consulte le site (par exemple, le navigateur ou le téléphone mobile utilisé par une personne).
  • Session : période pendant laquelle le visiteur est actif sur le site.
  • Page : activité pour le compte de l'utilisateur qui envoie une demande GIF aux serveurs Analytics. Elle se caractérise généralement par une page vue, mais 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 un champ d'application 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 précis, vous devez définir la variable personnalisée au niveau de la session afin que toute la session de ce visiteur soit signalée comme celle pour laquelle des articles ont été supprimés des paniers en ligne.

Haut de page

Utiliser des variables personnalisées

Vous pouvez configurer différentes variables personnalisées pour suivre l'activité des internautes sur votre site. C'est pourquoi vous créerez le plus souvent vos propres utilitaires JavaScript pour les gérer. Votre script va utiliser 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 pas être réutilisée sur différents emplacements.
  • name : nom de la variable personnalisée. Obligatoire. Il s'agit d'une chaîne qui identifie la variable personnalisée et qui apparaît dans le rapport Variables personnalisées de premier niveau des rapports Analytics.
  • value : valeur de la variable personnalisée. Obligatoire. Il s'agit d'une chaîne associée à un nom. Vous pouvez associer un certain nombre de valeurs à un nom de variable personnalisée. La valeur apparaît dans la liste de tables de l'interface utilisateur pour le nom d'une variable sélectionnée. Généralement, vous disposez d'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 utilisateur avec 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). Si aucune valeur n'est définie, le champ d'application de la variable personnalisée correspond par défaut à 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(), de sorte qu'elle soit 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é sur les utilisateurs du site Web. En outre, il serait judicieux de définir également une variable personnalisée par défaut pour Items Removed et No. Ainsi, vous comptabiliseriez le nombre de visites au cours desquelles les articles ont été supprimés des paniers d'achat, ainsi que le nombre de visites n'incluant pas la suppression des articles.

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 les variables personnalisées configurées, vous pouvez les supprimer à l'aide de la méthode _deleteCustomVar(index).

Haut de page

Exemples d'utilisation

Les variables personnalisées peuvent être implémentées de différentes manières, en fonction du modèle de votre site Web et des besoins de votre entreprise. Les exemples présentés ici présentent différents cas d'utilisation, chacun illustrant un niveau de portée 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 pour vos utilisateurs.

Par exemple, supposons que vous gériez le site Web d'un journal en ligne, dans lequel 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 identifier les rubriques les plus populaires. Pour ce faire, définissez une variable personnalisée au niveau de la page pour chaque article, où la section est définie en tant que variable personnalisée. Par exemple, vous pouvez avoir des sections comme Life & Style, Opinion et Business. Vous pouvez définir une variable personnalisée pour suivre tous vos articles par rubrique.

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 souhaitez non seulement baliser la section d'un article particulier, mais également la sous-section. Par exemple, la section Vie et style de votre journal peut comporter un certain nombre de sous-sections, telles que Alimentation et boissons, Mode et Sports. Pour un article particulier, vous pouvez suivre la section et la sous-section. Vous pouvez définir une variable personnalisée supplémentaire pour effectuer le suivi de 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 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. Pour tous les articles de votre site Web, vous pouvez configurer un tableau de variables personnalisées au niveau de la page afin de les suivre à l'aide de différentes sections et sous-sections. Pour savoir comment utiliser correctement les variables personnalisées au niveau de la page, consultez la section 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 différencier les expériences utilisateur lors des sessions.

Par exemple, si votre site Web permet aux utilisateurs de se connecter, vous pouvez utiliser une variable personnalisée dont la portée est définie au niveau de la session. De cette façon, vous pouvez segmenter les visites en fonction des visiteurs connectés et des visiteurs anonymes.

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 la tentative d'achat au cours d'une session donnée. Si nous partons du principe que chaque page offre à l'utilisateur la possibilité de se connecter, nous souhaitons réserver l'emplacement 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 au niveau du visiteur pour distinguer les catégories de visiteurs au cours de plusieurs sessions.

Par exemple, si votre site Web propose du contenu premium aux abonnés payants, vous pouvez définir une variable personnalisée au niveau de la visite pour analyser les utilisateurs payants, le niveau de paiement et le niveau de service offert à vos visiteurs. Vous définirez probablement cette variable personnalisée comme une fonction unique, car la valeur sera persistante tout au long 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 des emplacements identiques sont utilisés par différentes variables.

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

Haut de page

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

Une seule page vue, événement ou appel de transaction.

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

Pour toute propriété Web (ensemble de pages), vous pouvez définir de nombreuses variables uniques au niveau de la page et réutiliser des emplacements. Limité par le nombre d'appels au cours d'une session donnée

Pour chaque page, vous pouvez configurer 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 pour l'emplacement 1 plus tard, la session est définie sur true pour login.

Ignore toute variable au niveau de la page précédemment définie, appelée dans la même session.
Exemple : Si l'emplacement n°1 est d'abord utilisé pour category=sports, puis pour 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 distinctes que vous définissez au niveau de la session (128 caractères au maximum).

Pour chaque session utilisateur, vous pouvez configurer jusqu'à cinq variables au niveau de la session.

Au niveau du visiteur

La session actuelle et toutes les futures sessions pendant la durée de vie du cookie du visiteur.

La dernière valeur définie pour un visiteur est celle appliquée aux sessions actuelles 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 mélangez différents types de variables

En règle générale, il n'est pas recommandé 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 au niveau de la page, de la session et du visiteur pour votre propriété Web, vous devez déterminer soigneusement la réutilisation des emplacements. Si une variable personnalisée au niveau de la page ou de la session utilise le même espace en même temps se produit sur votre site Web, seule la variable au niveau de la session (ou au niveau de la page) est 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 un chiffre entre parenthèses, et S: indique la portée de la variable.

Scénario 1 – La variable finale au niveau de la session est prioritaire

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

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

Le rapport sur les visites est le suivant:

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

Scénario 2 – La variable initiale de niveau visiteur prévaut

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

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

Le rapport sur les visites est le suivant:

  • Nombre de visites pour "sexe=homme" : 2
  • Nombre de visites pour "convert=false" : 1
  • # visites pour section=opinion: 1
  • N'utilisez pas de noms de clés en double dans les emplacements.
  • Appelez la fonction _setCustomVar() lorsqu'elle peut être définie avant une requête de page vue ou d'événement GIF.
    Dans certains cas, ce n'est pas toujours possible. Vous devez alors définir une autre requête _trackPageview() après avoir défini une variable personnalisée. Cela n'est généralement nécessaire que lorsque l'utilisateur déclenche une variable personnalisée au niveau de la session ou de la visite, lorsqu'il n'est pas possible de regrouper cette méthode avec un appel de suivi de page vue, d'événement ou de commerce électronique.
  • Utilisez une matrice d'emplacements pour suivre un grand nombre de variables personnalisées.
    Si vous avez des exigences complexes en termes de suivi, dans lesquelles un mélange de variables au niveau de la page et de la session peut entrer en conflit, vous devez créer une matrice d'emplacements pour vous assurer que les variables au niveau de la session ne se superposent pas par inadvertance aux variables au niveau de la page.
  • Envisagez d'utiliser le suivi des événements pour certaines applications plutôt que des variables personnalisées.
    Par exemple, supposons que vous possédiez une boutique de musique en ligne et que vous souhaitiez effectuer le suivi des sessions de connexion, des tentatives d'achat et des sessions au cours desquelles des extraits musicaux ont été lus. Il serait logique d'utiliser le suivi des événements pour suivre le nombre de tentatives de lecture de musique au lieu d'utiliser des variables au niveau de la session. Ici, vous pouvez utiliser le quatrième paramètre de valeur de l'appel de suivi des événements pour transmettre les données de session de vos propres cookies.
  • N'utilisez pas de variables au niveau de la session pour suivre le comportement que vous pouvez suivre avec les variables au niveau de la page.
    Imaginons par exemple que vous suiviez l'état de la connexion et de la tentative d'achat par session, et que votre site propose une page"Membres"dont vous souhaitez également effectuer le suivi. Étant donné qu'une variable personnalisée au niveau de la page affiche le nombre de visites de cette variable spécifique, vous disposez déjà du nombre de visites incluant cette page au moins une fois.

Haut de page