Configuration avancée – SDK iOS

Important: Ce document décrit une ancienne version du SDK. Les nouveaux utilisateurs doivent utiliser le dernier SDK.

Ce document présente certaines des fonctionnalités de configuration avancées du SDK Google Analytics pour iOS v2.

Présentation

Le SDK Google Analytics pour iOS utilise deux classes pour gérer l'état global de la mise en œuvre et envoyer les données aux serveurs Google Analytics.

• GAI : singleton qui gère l'état global de votre implémentation, y compris l'obtention de nouveaux objets GAITracker, ainsi que le paramètre de désactivation au niveau de l'application et les paramètres de distribution.
• GAITracker : classe à partir de laquelle vous envoyez des données à Google Analytics. Plusieurs outils de suivi peuvent être instanciés, un par ID de propriété unique.

Utiliser plusieurs coachs électroniques

À partir de la version 2 du SDK, vous pouvez utiliser plusieurs outils de suivi dans une seule implémentation, à raison d'un par ID de suivi unique. Tous les traceurs partagent le même état mondial détenu par votre singleton GAI.

Dans l'exemple suivant, un visionnage d'écran est envoyé à deux propriétés distinctes à l'aide de deux outils de suivi, chacun avec son propre ID de propriété:

#import "RootViewController.h"
#import "GAI.h"

@interface RootViewController ()

@end

@implementation RootViewController
{
- (void)viewDidLoad {
  [super viewDidLoad];

  // Send a screen view to the first property.
  id tracker1 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Y"];
  [tracker1 sendView:@"/HomeScreen"];

  // Send another screen view to the second property.
  id tracker2 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Z"];
  [tracker2 sendView:@"Home"];
}

@end

N'oubliez pas que les fonctionnalités de mesure automatisées, telles que la mesure automatique de l'écran et des exceptions non détectées, n'utilisent qu'un seul outil de suivi pour envoyer des données à Google Analytics. Si vous utilisez ces fonctionnalités et que vous souhaitez envoyer des données à l'aide d'autres traceurs, vous devez le faire manuellement.

Pour référence, la mesure automatique de l'écran utilise le traceur spécifié dans la propriété tracker d'un GAITrackedViewController donné. La mesure des exceptions non détectées utilise l'outil de suivi par défaut spécifié dans votre instance GAI.

Coach électronique par défaut

Bien qu'une implémentation puisse utiliser plusieurs outils de suivi, elle possède un outil de suivi par défaut à l'échelle mondiale. Le premier Tracker récupéré devient le suivi par défaut.

Pour obtenir le coach électronique par défaut, utilisez:

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

Pour définir le coach électronique par défaut, utilisez:

// Get a new tracker.
id newTracker = [[GAI sharedInstance]trackerWithTrackingId:@"UA-NEW-TRACKING-ID");

// Set the new tracker as the default tracker, globally.
[GAI sharedInstance].defaultTracker = newTracker;

Échantillonnage

Vous pouvez activer l'échantillonnage côté client pour limiter le nombre d'appels envoyés à Google Analytics. Si votre application compte un grand nombre d'utilisateurs ou envoie un grand volume de données à Google Analytics, l'activation de l'échantillonnage vous permettra de générer des rapports sans interruption.

Par exemple, pour implémenter l'échantillonnage côté client à un taux de 50%, utilisez le code suivant:

// Set a sample rate of 50%.
[tracker setSampleRate:50.0];  // Sample rate is a double.

Pour éviter les incohérences dans les rapports,chacune des vues d'application (profils) doit contenir des données collectées au même taux d'échantillonnage. Si différentes versions de votre application utilisent des taux d'échantillonnage différents, vous devez configurer des filtres de vue (profil) à l'aide de la dimension "Version de l'application" pour séparer les données de chaque version.

Désactivation au niveau de l'application

Vous pouvez activer un indicateur de désactivation au niveau de l'application, qui désactivera Google Analytics pour l'ensemble de l'application. Une fois défini, l'indicateur continuera de s'appliquer pendant toute la durée de vie de l'application ou jusqu'à sa réinitialisation.

Pour obtenir le paramètre de désactivation au niveau d'une application, utilisez:

// Get the app-level opt out preference.
if ([GAI sharedInstance].optOut) {
  ... // Alert the user they have opted out.
}

Pour définir l'indicateur de désactivation au niveau de l'application, utilisez:

// Set the app-level opt out preference.
[[GAI sharedInstance].setOptOut = YES];

Tester et déboguer

Le SDK Google Analytics pour iOS fournit un mode de débogage qui affiche des informations utiles sur les données envoyées à Google Analytics dans vos journaux.

// Enable debug mode.
[GAI sharedInstance].debug = YES;