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 sont 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 connectés, les auteurs de pages, les niveaux dans les jeux ou toute autre donnée d'entreprise disponible sur une page.
Pour obtenir un aperçu complet du fonctionnement de cette fonctionnalité, consultez la documentation de référence sur les dimensions et les 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 | L'index de la 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 | L'index de la 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 d'abord 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 avec 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 pendant 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 d'envoi de ces données.
Exemple
Les dimensions personnalisées sont un bon exemple d'utilisation des dimensions personnalisées si votre site est basé sur du contenu et que ses auteurs sont nombreux. En tant qu'analyste, vous voudrez peut-être comprendre quels auteurs ont le contenu le plus populaire. Pour répondre à cette question, vous pouvez consulter 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 sous la forme d'une dimension personnalisée pour chaque page vue.
La première étape consiste à configurer une nouvelle dimension personnalisée dans l'interface de gestion. Le nom doit être author et le champ d'application 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 rédigée en PHP, son auteur sera probablement stocké dans une variable PHP telle que $author. Dans votre modèle PHP, vous pouvez utiliser cette variable "author" pour transmettre la valeur "author" à la dimension personnalisée:
ga('send', 'pageview', {
'dimension5': '<?=$author?>'
});