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 v2.

Présentation

Lorsque vous définissez une valeur de dimension ou de statistique personnalisée à l'aide du SDK Google Analytics pour iOS, cette valeur est envoyée en tant que paramètre avec le prochain appel qui est 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:

  • NSNumber Index : index de la définition de la dimension personnalisée. Cet index est basé sur 1.
  • NSString 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 setCustom:dimension: avant l'appel d'envoi auquel vous souhaitez associer la valeur:

// Get the tracker object.
id tracker = [[GAI sharedInstance].defaultTracker;

// Set the dimension value for index 1.
[tracker setCustom:1
         dimension:@"myValue"];

// Dimension value is associated and sent with this hit.
[tracker sendView:screenName];

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éfinissez la 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 tracker = [[GAI sharedInstance].defaultTracker;  // Get the tracker object.
    [tracker setCustom:1
             dimension:@"myValue"];  // Set the custom dimension value.
    [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.

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:

  • NSInteger Index : index de la définition de la métrique personnalisée.
  • NSNumber 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 setCustom:metric: avant un autre appel d'envoi:

// Get the tracker object.
id tracker = [GAI sharedInstance].defaultTracker;

// Increment the metric at index 1.
[tracker setCustom:1
            metric:[NSNumber numberWithLongLong:1]];

// Metric value sent with this hit.
[tracker sendView:screenName];

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

// Get the tracker.
id tracker = [GAI sharedInstance].defaultTracker;

// Create a dictionary for hit params.
NSDictionary *params = [[NSDictionary alloc] initWithObjectsAndKeys:
    @"Product Page", @"&cd",
   // Set currency value to custom metric slot 1.
   // Currency values may be fixed decimal.
    @"24.99", @"&cm1", nil];

// Send the custom metric value with a screen view.
[tracker send:@"appview"
       params: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)