Statistiques et dimensions personnalisées

Ce guide explique comment envoyer des dimensions et des métriques personnalisées à l'aide d'analytics.js.

Présentation

Les dimensions et métriques personnalisées constituent un moyen efficace d'envoyer des données personnalisées à Google Analytics. Les développeurs Web peuvent utiliser des dimensions et des métriques personnalisées pour segmenter et mesurer les différences entre les utilisateurs connectés et non, les auteurs de pages, les niveaux de jeux ou toute autre donnée d'entreprise disponible sur une page.

Pour obtenir un aperçu complet de cette fonctionnalité, consultez la documentation de référence sur les dimensions et métriques personnalisées.

Vous envoyez des données de dimensions et de métriques personnalisées à l'aide de l'une des valeurs suivantes, ou des deux:

Nom du champ Type de valeur Obligatoire Description
dimension[0-9]+ text Non Index de dimension. Chaque dimension personnalisée est associée à un index.Le nombre de dimensions personnalisées est limité à 20 (200 pour les comptes Analytics 360). Le suffixe d'index doit être un entier positif supérieur à 0 (ex. dimension3).
métrique[0-9]+ integer Non Indice de métrique. Chaque métrique personnalisée est associée à un index. Le nombre de métriques personnalisées est limité à 20 (200 pour les comptes Analytics 360). Le suffixe d'index doit être un entier positif supérieur à 0 (par exemple, metric5).

Implémentation

Vous devez commencer par configurer une dimension ou une métrique personnalisée via l'interface de gestion de Google Analytics. Une fois configurée, la dimension ou la métrique personnalisée se voit attribuer un index unique qui identifie et différencie une dimension ou une métrique personnalisée d'une autre. Vous pouvez ensuite utiliser l'index de la bibliothèque analytics.js pour envoyer des données pour une dimension ou une métrique personnalisée spécifique.

Envoi de données en cours…

Les données de dimensions ou de métriques personnalisées ne peuvent être envoyées qu'avec un appel existant. Par exemple, pour envoyer une dimension personnalisée pour un appel de type pageview avec l'index 15, vous devez utiliser:

ga('send', 'pageview', {
  'dimension15':  'My Custom Dimension'
});

Pour envoyer une métrique personnalisée pour un appel de type event avec l'index 18, vous devez utiliser:

ga('send', 'event', 'category', 'action', {
  'metric18': 8000
});

Si la métrique personnalisée est configurée de façon à utiliser un type de devise, vous pouvez envoyer des valeurs décimales:

ga('send', 'event', 'category', 'action', {
  'metric19': 24.99
});

Dans certains cas, vous pouvez envoyer une dimension ou une métrique personnalisée avec tous les appels d'une page donnée (ou pour la durée de vie de l'objet de suivi). Dans ce cas, vous pouvez définir la dimension ou les métriques personnalisées à l'aide de la commande set:

ga('set', 'dimension5', 'custom data');

Pour set les valeurs d'une dimension et d'une métrique, vous pouvez utiliser:

ga('set', {
  'dimension5': 'custom dimension data',
  'metric5': 'custom metric data'
});

Consultez la section Dimensions et métriques personnalisées du document de référence sur les champs pour connaître le format spécifique d'envoi de ces données.

Exemple

Les dimensions personnalisées sont un bon exemple de cas où votre site est axé sur le contenu et comprend de nombreux auteurs. En tant qu'analyste, vous voudrez peut-être savoir quels auteurs ont le contenu le plus populaire. Pour répondre à cette question, vous pouvez afficher un rapport qui compare les pages vues par auteur. Bien que les données sur les auteurs ne soient pas disponibles par défaut dans Google Analytics, vous pouvez envoyer ces données en tant que dimension personnalisée pour chaque page vue.

La première étape de la solution consiste à configurer une nouvelle dimension personnalisée dans l'interface de gestion. Le nom doit être author et le champ d'application sera de type hit. Une fois configurée, la nouvelle dimension personnalisée se voit attribuer un index. Pour cet exemple, supposons que l'index soit 5.

Maintenant que la dimension personnalisée author a été configurée et qu'un index lui a été attribué, vous pouvez l'utiliser avec la bibliothèque analytics.js pour envoyer des données sur l'auteur en tant que dimension personnalisée. Par exemple, si votre page est écrite en PHP, son auteur sera probablement stocké dans une variable PHP telle que $author. Dans votre modèle PHP, vous pouvez utiliser cette variable d'auteur pour transmettre la valeur de l'auteur à la dimension personnalisée:

ga('send', 'pageview', {
  'dimension5': '<?=$author?>'
});