Dimensions et métriques personnalisées

Ce guide du développeur explique comment utiliser le SDK Google Analytics v4 pour Android afin d'implémenter des dimensions et des métriques personnalisées.

Présentation

Vous pouvez :

Les dimensions et métriques personnalisées se composent de deux champs:

Nom du champ Type Description
Index Integer Index de la dimension ou de la métrique personnalisée Cet index est basé sur 1.
Valeur String Valeur de la dimension ou de la métrique personnalisée. Dans le cas des métriques, elle est analysée comme un entier ou une valeur décimale fixe si la métrique est configurée sur un type de devise.

Définir et envoyer des 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 pour la dimension personnalisée détermine, au moment du traitement, quels appels sont 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 décrit d'autres considérations à 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 des portées au niveau de l'utilisateur et de la session s'appliquent aux appels précédents

  • Les valeurs de dimension personnalisée avec une portée au niveau de l'utilisateur ou de la session s'appliqueront à tous les appels de la session actuelle, y compris les appels précédents. Si vous ne souhaitez pas qu'une valeur de dimension personnalisée dont la portée est définie au niveau de la session ou de l'utilisateur soit appliquée aux appels précédents de la session actuelle, démarrez une nouvelle session avant d'appliquer la valeur à un appel.
  • Par exemple, si vous utilisez le type d'adhésion en tant que dimension personnalisée au niveau de l'utilisateur et qu'un utilisateur améliore son adhésion au cours d'une session, vous pouvez démarrer une nouvelle session avant de définir la valeur de la nouvelle dimension personnalisée. Ainsi, les appels antérieurs à la migration seront associés à l'ancienne valeur de souscription, tandis que les nouveaux appels seront associés à la nouvelle.

Dimensions personnalisées et filtres de vue (profil)

  • Les valeurs de dimensions personnalisées définies 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é d'une vue (profil) .
  • Lorsque vous filtrez une valeur de dimension personnalisée, les appels sont filtrés en fonction de la portée de cette valeur de dimension personnalisée. En savoir plus sur la manière dont les filtres et les valeurs de dimensions personnalisées interagissent lorsque vos données sont traitées

Remarques concernant les métriques personnalisées

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

  • Les valeurs des métriques personnalisées sont agrégées dans les rapports, tout comme les autres métriques prédéfinies dans Google Analytics. Par conséquent, vous devez définir une valeur de métrique personnalisée de 1 pour incrémenter le total cumulé 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 à un visionnage de l'écran envoyé via la mesure automatique de l'écran, définissez la valeur avant que activityStart() ne soit appelé pendant onStart(). Notez que si la valeur n'est pas connue au moment de l'exécution de onStart(), il est préférable de mesurer manuellement l'écran.

N'envoyez pas d'informations permettant d'identifier personnellement l'utilisateur en tant que valeurs.