Dimensions et métriques personnalisées - SDK Android v2 (ancien)

Ce guide du développeur explique comment implémenter des dimensions et des métriques personnalisées à l'aide du SDK Google Analytics pour Android v2.

Présentation

Lorsque vous définissez une valeur de dimension ou de métrique personnalisée à l'aide du SDK Google Analytics pour Android, cette valeur est envoyée en tant que paramètre avec le prochain appel envoyé. Ces valeurs peuvent être appliquées à n'importe quel type d'appel Google Analytics, y compris les visionnages de l'écran, les événements, les transactions d'e-commerce, les temps utilisateur et les interactions sur les réseaux sociaux.

Il existe deux étapes principales pour implémenter une dimension ou une métrique personnalisée:

  1. Définissez la dimension ou la métrique personnalisée à l'aide de l'interface Web Google Analytics.
    Définissez l'index, le nom et le champ d'application de la dimension ou de la métrique personnalisée dans la section "Paramètres de la propriété" de l'interface Web.
    Découvrez comment définir une dimension ou une métrique personnalisée.
  2. Implémentez du code pour définir et collecter des valeurs de dimensions et de métriques personnalisées.
    Ajoutez du code à votre application afin de définir des valeurs de dimensions ou de métriques personnalisées pour vos appels Google Analytics aux index que vous avez définis à l'étape précédente.

La suite de cet article explique comment insérer le code pour définir et envoyer des valeurs de dimensions ou de métriques personnalisées à Google Analytics.

Dimensions personnalisées

Les valeurs de dimension personnalisée peuvent être définies sur tous les types d'appels Google Analytics. Définissez une valeur de dimension personnalisée juste avant l'appel d'envoi auquel vous souhaitez appliquer la valeur.

Le champ d'application défini de la dimension personnalisée détermine, au moment du traitement, quels appels supplémentaires peuvent être associés à cette valeur.

Les champs suivants sont obligatoires pour définir une valeur de dimension personnalisée:

  • Integer Index : index de la définition de la dimension personnalisée. Cet index est basé sur 1.
  • String Valeur : valeur de la dimension personnalisée.

Définition d'une valeur de dimension personnalisée

Pour définir une valeur de dimension personnalisée, appelez setCustomDimension avant l'appel d'envoi auquel vous souhaitez associer la valeur:

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Set the dimension value for index 1.
tracker.setCustomDimension(1, "myValue");

// Dimension value is associated and sent with this hit.
tracker.sendView();

Observations relatives à la mise en œuvre

Cette section décrit des considérations supplémentaires à prendre en compte lors de l'implémentation d'une dimension personnalisée.

Les habilitations au niveau de l'utilisateur et de la session sont gloutonnes

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 en cours, 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 met à niveau 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 d'abonnement, 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 elles sont envoyées est filtré d'une vue (profil).

Lorsque vous filtrez une valeur de dimension personnalisée, les appels sont filtrés en fonction du champ d'application 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

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'EasyTracker, définissez la valeur avant l'appel de activityStart() pendant onStart().

Notez que si la valeur n'est pas connue au moment de l'exécution de onStart(), il est recommandé d'utiliser plutôt les mesures d'écran manuelles.

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

Les Conditions d'utilisation de Google Analytics interdisent l'envoi d'informations permettant d'identifier personnellement l'utilisateur aux serveurs Google Analytics. Pour en savoir plus, consultez les Conditions d'utilisation.

Custom Metrics (Métriques personnalisées)

Bien que les dimensions personnalisées doivent être soigneusement appliquées à des appels spécifiques et gérées selon un champ d'application, l'appel auquel une métrique personnalisée est appliquée n'a généralement pas d'incidence sur les rapports. Elles peuvent donc être définies dès que la valeur de la métrique est connue.

Ces champs sont obligatoires pour définir une valeur de métrique personnalisée:

  • Integer Index : index de la définition de la métrique personnalisée.
  • Integer Valeur : valeur de la métrique personnalisée. Les valeurs peuvent être négatives.

Définir la valeur d'une métrique personnalisée

Pour définir une valeur de métrique personnalisée, appelez setCustomMetric avant un autre appel d'envoi:

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Increment the metric at index 1.
tracker.setCustomMetric(1, 1);

// Metric value sent with this hit.
tracker.sendView();

Pour définir une métrique personnalisée basée sur la devise, procédez comme suit:

// Get the tracker.
Tracker tracker = EasyTracker.getTracker();

// Create a map for hit params.
HashMap params = new HashMap();
params.put(ModelFields.APP_SCREEN, "Product Page");

// Set currency value to custom metric slot 1.
// Currency values may be fixed decimal.
params.put("&cm1", "24.99");

// Send the custom metric value with a screen view.
tracker.send("appview", params);

Observations relatives à la mise en œuvre

La section suivante présente d'autres considérations à prendre en compte lorsque vous planifiez l'implémentation d'une dimension ou d'une métrique personnalisée.

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)

Bien que les valeurs des métriques personnalisées puissent généralement être définies à tout moment, évitez de les définir sur les appels susceptibles d'être exclus de vos vues (profils). Si un appel est filtré par un filtre de vue (profil), toute valeur de métrique personnalisée associée sera également filtrée. En savoir plus sur les dimensions et les métriques personnalisées et sur les filtres de vue (profil)