Dimensions et métriques personnalisées avec gtag.js

Les développeurs Web peuvent utiliser des dimensions et métriques personnalisées pour segmenter et mesurer les différences entre les utilisateurs connectés et non connectés, les auteurs de pages ou les niveaux dans les jeux. Cette page explique comment envoyer des dimensions et des métriques personnalisées à Google Analytics.

Pour envoyer des valeurs de paramètres personnalisés à Google Analytics, mappez les paramètres sur les paramètres de métrique ou de dimension Google Analytics personnalisés suivants:

Configurer et envoyer des dimensions personnalisées

Pour envoyer la valeur d'un paramètre personnalisé à Google Analytics, vous devez mapper une valeur de votre site Web à un paramètre Google Analytics. Pour ce faire, utilisez le paramètre custom_map.

Pour envoyer une dimension personnalisée à Google Analytics, mettez à jour le config de votre propriété afin de définir le paramètre custom_map pour la dimension, puis utilisez le paramètre personnalisé pour envoyer la valeur de la dimension personnalisée:

// Configures custom dimension<Index> to use the custom parameter
// 'dimension_name' for 'GA_MEASUREMENT_ID', where <Index> is a number
// representing the index of the custom dimension.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'dimension<Index>': 'dimension_name'}
});

// Sends the custom dimension to Google Analytics.
gtag('event', 'any_event_name', {'dimension_name': dimension_value});

Remplacez 'GA_MEASUREMENT_ID' par votre propre ID Analytics.

Par exemple, l'extrait suivant envoie la dimension personnalisée dimension2 avec la valeur 55 à Google Analytics:

// Maps 'dimension2' to 'age'.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'dimension2': 'age'}
});

// Sends an event that passes 'age' as a parameter.
gtag('event', 'age_dimension', {'age': 55});

Configurer et envoyer des métriques personnalisées

Pour envoyer une métrique personnalisée à Google Analytics, mettez à jour le config de votre propriété afin de définir le paramètre custom_map pour la métrique, puis utilisez le paramètre personnalisé pour envoyer la valeur de la métrique personnalisée:

// Configures custom metric<Index> to use the custom parameter
// 'metric_name' for GA_MEASUREMENT_ID, where <Index> is a number
// representing the index of the custom metric.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'metric<Index>': 'metric_name'}
});

// Sends the custom dimension to Google Analytics.
gtag('event', 'any_event_name', {'metric_name': metric_value});

Remplacez 'GA_MEASUREMENT_ID' par votre propre ID Analytics.

Par exemple, l'extrait suivant envoie la métrique personnalisée metric5 avec la valeur 1 à Google Analytics:

// Maps 'metric5' to 'avg_page_load_time'.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'metric5': 'avg_page_load_time'}
});

// Sends an event that passes 'avg_page_load_time' as a parameter.
gtag('event', 'load_time_metric', {'avg_page_load_time': 1});

Configurer et envoyer des dimensions et des métriques personnalisées

Vous pouvez mettre à jour le paramètre config de votre propriété pour mapper à la fois les dimensions et les métriques personnalisées:

gtag('config', 'GA_MEASUREMENT_ID', {
   'custom_map': {
     'dimension2': 'age',
     'metric5': 'avg_page_load_time'
   }
});

gtag('event', 'foo', {'age': 55, 'avg_page_load_time': 1});