Dimensions et métriques personnalisées – SDK iOS

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

Présentation

Les dimensions personnalisées permettent d'associer des métadonnées avec des appels, des utilisateurs et des sessions dans Google Analytics, tandis que les métriques personnalisées vous permettent de créer et d'incrémenter vos propres métriques dans Google Analytics.

  1. Configurez la dimension ou la métrique personnalisée à l'aide de l'interface Web de Google Analytics. Découvrez comment configurer une dimension ou une métrique personnalisée (centre d'aide).
  2. Définissez et envoyez des valeurs de dimensions et de métriques personnalisées à partir d'une application.

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

  • NSNumber Index : index de la dimension ou de la métrique personnalisée. Cet index est basé sur 1.
  • NSString Valeur : 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:

// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];

// Set the custom dimension value on the tracker using its index.
[tracker set:[GAIFields customDimensionForIndex:1]
       value:@"Premium user"];

[tracker set:kGAIScreenName
       value:@"Home screen"];

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once, so it is set on the Map,
// not the tracker.

// Previous V3 SDK versions.
// [tracker send:[[[GAIDictionaryBuilder createAppView] set:@"premium"
//                                                   forKey:[GAIFields customDimensionForIndex:1]] build]];

// // SDK Version 3.08 and up.
[tracker send:[[[GAIDictionaryBuilder createScreenView] set:@"premium"
                                                     forKey:[GAIFields customDimensionForIndex:1]] 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:

// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];


// Set the custom metric to be incremented by 5 using its index.
[tracker set:[GAIFields customMetricForIndex:1]
       value:[[NSNumber numberWithInt:5] stringValue]];


[tracker set:kGAIScreenName
       value:@"Home screen"];

// Custom metric value is sent with this screen view.
// [tracker send:[[GAIDictionaryBuilder createAppView] build]];     // Previous V3 SDK versions.
[tracker send:[[GAIDictionaryBuilder createScreenView] build]];     // SDK Version 3.08 and up.

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 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 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 cette valeur dans la méthode viewDidAppear: du contrôleur de vue. Par exemple, le fichier .m de votre contrôleur de vue peut se présenter comme suit:
#import "myViewController.h"
#import "GAI.h"

@implementation myViewController

-(void)viewDidAppear
{
    id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];  // Get the tracker object.
    [tracker set:[GAIFields customDimensionForIndex:1]
           value:@"premium"];
    [super viewDidAppear:animated];   // Custom dimension value will be sent with the screen view.

}

// The remainder of the implementation is omitted.

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