Ce guide décrit comment envoyer des dimensions et métriques personnalisées à l’aide d’analytics.js.
Aperçu
Les dimensions et métriques personnalisées sont un moyen puissant d’envoyer des données personnalisées à Google Analytics. Les développeurs Web peuvent utiliser des dimensions et des mesures personnalisées pour segmenter et mesurer les différences entre les utilisateurs connectés et déconnectés, les auteurs de pages, les niveaux dans les jeux ou toute autre donnée commerciale que vous avez sur une page.
Pour un aperçu complet du fonctionnement de cette fonctionnalité, lisez la référence de la fonctionnalité Dimensions et Métriques personnalisées.
Vous envoyez des données de dimension et de métrique personnalisées en utilisant l’une ou l’autre des valeurs suivantes :
Nom du champ | Type de valeur | Requis | Description |
---|---|---|---|
dimension + | texte | Non | L’index de dimension . Chaque dimension personnalisée a un index associé.Il y a un maximum de 20 dimensions personnalisées (200 pour les comptes Analytics 360). Le suffixe d’index doit être un entier positif supérieur à 0 (e.g. dimension3). |
métrique + | entier | Non | L’indice métrique. Chaque mesure personnalisée a un index associé. Il y a un maximum de 20 mesures personnalisées (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 mesure personnalisée via l’interface de gestion de Google Analytics. Une fois configurée, la dimension ou la mesure personnalisée se verra attribuer un index unique qui identifie et différencie une dimension ou mesure personnalisée d’une autre. Vous utilisez ensuite l’index dans l’analyse.bibliothèque js pour envoyer des données pour une dimension ou une métrique personnalisée particulière.
Envoi de données
Les données de dimension ou de métrique personnalisées ne peuvent être envoyées qu’avec un accès existant. Par exemple, pour envoyer une dimension personnalisée pour un type pageview
frappé avec l’index 15
, vous utiliserez:
ga('send', 'pageview', { 'dimension15': 'My Custom Dimension'});
Pour envoyer une métrique personnalisée pour un event
type frappé avec l’index 18
, vous utiliserez :
ga('send', 'event', 'category', 'action', { 'metric18': 8000});
Si la métrique personnalisée est configuré pour avoir un type de devise, vous pouvez envoyer des valeurs décimales :
ga('send', 'event', 'category', 'action', { 'metric19': 24.99});
Dans certains cas, vous voudrez peut-être envoyer une dimension ou une métrique personnalisée avec tous les accès sur une page donnée (ou pour la durée de vie de l’objet tracker). 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
valeurs pour une dimension et une métrique, vous pouvez utiliser:
ga('set', { 'dimension5': 'custom dimension data', 'metric5': 'custom metric data'});
Lisez la section Dimensions et Métriques personnalisées dans le document de référence de champ pour le format spécifique de l’envoi de ces données.
Exemple
Un exemple fantastique de l’utilisation de dimensions personnalisées est si vous aviez un site basé sur du contenu avec de nombreux auteurs. En tant qu’analyste, vous voudrez peut-être comprendre 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 d’auteur ne soient pas disponibles par défaut dans Google Analytics, vous pouvez envoyer ces données sous forme de dimension personnalisée à 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 la portée sera de type hit
. Une fois configurée, un index sera attribué à la nouvelle dimension personnalisée. Pour cet exemple, disons que l’index est 5
.
Maintenant que la dimension personnalisée author
a été configurée et qu’un index lui a été attribué, elle peut être utilisée avec l’analyse.bibliothèque js pour envoyer des données d’auteur en tant que dimension personnalisée. Par exemple, si votre page est écrite en PHP, l’auteur réel de la page sera probablement stocké dans une variable PHP comme $author
. Dans votre modèle PHP, vous pouvez utiliser cette variable author pour passer la valeur author à la dimension personnalisée :
ga('send', 'pageview', { 'dimension5': '<?=$author?>'});