Dimensions et métriques personnalisées

Ce guide du développeur explique comment utiliser le SDK Google Analytics v4 pour Android afin de mettre en œuvre des dimensions et des métriques personnalisées.

Présentation

Vous pouvez :

Les dimensions et les métriques personnalisées comportent deux champs:

Nom du champ Type Description
Index Integer Index de la dimension ou métrique personnalisée. Cet index est basé sur 1.
Value String Valeur de la dimension ou métrique personnalisée. Dans ce cas, les métriques sont analysées sous la forme d'un nombre entier ou d'une valeur décimale à virgule fixe si la métrique est configurée sur un type de devise.

Définition et envoi de valeurs

Pour définir et envoyer une valeur de dimension personnalisée:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("Home Screen");

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once.
t.send(new HitBuilders.ScreenViewBuilder()
    .setCustomDimension(1, "premiumUser")
    .build()
);

Les valeurs des dimensions personnalisées peuvent être envoyées avec n'importe quel type d'appel Google Analytics, y compris les visionnages de l'écran, les événements, les transactions e-commerce, les temps utilisateur et les interactions sur les réseaux sociaux. Le champ d'application défini de la dimension personnalisée détermine, au moment du traitement, les appels associés à la valeur de la dimension.

Pour définir et envoyer une valeur de métrique personnalisée:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("Home Screen");

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once.
t.send(new HitBuilders.ScreenViewBuilder()
    .setCustomMetric(1, 5)
    .build()
);

Pour en savoir plus sur la méthode getTracker, consultez la section Configuration avancée.

Observations relatives à la mise en œuvre

Cette section présente d'autres éléments à prendre en compte lors de l'implémentation de dimensions ou de métriques personnalisées.

Remarques concernant les dimensions personnalisées

Les valeurs avec portée définie au niveau de l'utilisateur et de la session s'appliquent aux appels passés

  • Les valeurs de dimension personnalisée dont le champ d'application est défini au niveau de l'utilisateur ou de la session s'appliqueront à tous les appels de la session actuelle, y compris les appels passés. Si vous ne souhaitez pas qu'une valeur de dimension personnalisée avec un champ d'application défini au niveau de la session ou de l'utilisateur soit appliquée aux appels passés de la session en cours, démarrez une nouvelle session avant d'appliquer la valeur à un appel.
  • Par exemple, si vous utilisez le type d'appartenance comme dimension personnalisée au niveau de l'utilisateur et qu'un utilisateur met son abonnement à niveau en cours de session, vous pouvez démarrer une nouvelle session avant de définir la nouvelle valeur de la dimension personnalisée. Ainsi, les appels antérieurs à la mise à niveau seront associés à l'ancienne valeur d'appartenance, tandis que les nouveaux appels seront associés à la nouvelle valeur.

Dimensions personnalisées et filtres de vue (profil)

  • Les valeurs de dimension personnalisée dont la portée est définie au niveau de l'utilisateur ou de la session seront toujours appliquées à tous les appels des sessions actuelles et/ou futures, même si l'appel avec lequel ils sont envoyés est filtré à partir d'une vue (profil) .
  • Lorsque vous filtrez sur une valeur de dimension personnalisée, les appels sont filtrés en fonction du champ d'application de cette valeur. En savoir plus sur la manière dont les filtres et les valeurs des dimensions personnalisées interagissent lors du traitement de vos données

Remarques concernant les métriques personnalisées

Les valeurs des métriques personnalisées sont regroupées dans les rapports

  • Les valeurs des métriques personnalisées sont regroupées dans des rapports comme les autres métriques prédéfinies dans Google Analytics. Par conséquent, vous pouvez définir une valeur de métrique personnalisée 1 pour incrémenter le total agrégé de la métrique dans vos rapports.

Métriques personnalisées et filtres de vue (profil)

Définir des valeurs avec la mesure automatique de l'écran

  • Pour appliquer une valeur de dimension personnalisée à une vue d'écran envoyée via la mesure automatique de l'écran, définissez la valeur avant que activityStart() ne soit appelé pendant onStart(). Si la valeur n'est pas connue au moment de l'exécution de onStart(), nous vous recommandons de mesurer manuellement l'écran.

N'envoyez pas d'informations personnelles.