Ajouter Analytics à votre application iOS

Ce guide explique comment ajouter Analytics à votre application iOS pour mesurer l'activité des utilisateurs sur des écrans nommés. Si vous n'avez pas encore d'application et que vous souhaitez simplement voir comment Analytics fonctionne, consultez notre exemple d'application.

Analytics utilise CocoaPods pour installer et gérer les dépendances. Ouvrez une fenêtre de terminal et accédez à l'emplacement du projet Xcode de votre application. Si vous n'avez pas encore créé de Podfile pour votre application, créez-en un maintenant:

pod init

Ouvrez le Podfile créé pour votre application et ajoutez les éléments suivants:

pod 'GoogleAnalytics'

Enregistrez le fichier et exécutez :

pod install

Un fichier .xcworkspace est alors créé pour votre application. Utilisez ce fichier pour tout développement ultérieur de votre application.

Initialiser Analytics pour votre application

Maintenant que vous disposez du fichier de configuration de votre projet, vous pouvez commencer l'implémentation. Commencez par configurer l'objet Analytics partagé dans AppDelegate. Votre application peut ainsi envoyer des données à Analytics. Vous allez effectuer les opérations suivantes:

Incluez les en-têtes nécessaires.
Définissez l'outil de suivi Analytics dans didFinishLaunchingWithOptions.
Remplacez YOUR_TRACKING_ID par votre propre ID de suivi Analytics, par exemple UA-47605289-8.
Envoyez les exceptions et les informations de journalisation (facultatif).

Pour effectuer ces modifications, commencez par ajouter Analytics dans AppDelegate:

#import <GoogleAnalytics/GAI.h>
#import <GoogleAnalytics/GAIDictionaryBuilder.h>

Ensuite, remplacez la méthode didFinishLaunchingWithOptions pour configurer Analytics:

GAI *gai = [GAI sharedInstance];
[gai trackerWithTrackingId:@"YOUR_TRACKING_ID"];

// Optional: automatically report uncaught exceptions.
gai.trackUncaughtExceptions = YES;

// Optional: set Logger to VERBOSE for debug information.
// Remove before app release.
gai.logger.logLevel = kGAILogLevelVerbose;

Ajouter le suivi des écrans

Ici, vous envoyez une vue d'écran nommée à Analytics chaque fois que l'utilisateur ouvre ou modifie les écrans de votre application. Ouvrez le contrôleur de vue que vous souhaitez suivre ou, s'il s'agit d'une nouvelle application, ouvrez le contrôleur de vue par défaut. Votre code doit:

Ajoutez les en-têtes requis :

#import <GoogleAnalytics/GAI.h>
#import <GoogleAnalytics/GAIDictionaryBuilder.h>
#import <GoogleAnalytics/GAIFields.h>ViewController.m

Utilisez un remplacement de méthode ou de fonction viewWillAppear pour insérer le suivi de l'écran.
Attribuez un nom à l'écran et exécutez le suivi.

id<GAITracker> tracker = [GAI sharedInstance].defaultTracker;
[tracker set:kGAIScreenName value:name];
[tracker send:[[GAIDictionaryBuilder createScreenView] build]];ViewController.m

Remarque:Vous pouvez ajouter un code de suivi à chaque UIViewController représentant un écran, qu'il soit présenté à l'utilisateur de manière impérative (via code) ou via un storyboard. Définissez un nom dans chaque UIViewController si vous souhaitez différencier les visionnages de l'écran pour votre application dans Analytics. Toutes les activités enregistrées sur le traceur partagé envoient le nom d'écran le plus récent jusqu'à ce qu'il soit remplacé ou effacé (défini sur "nil").

Étapes suivantes

Consultez le Guide de mise en œuvre des applications mobiles pour découvrir comment mesurer les interactions des utilisateurs et répondre aux questions sur l'utilisation des applications à l'aide de Google Analytics.
Examinez d'autres options de configuration telles que l'échantillonnage, les tests et le débogage, les paramètres de désactivation, etc.
Si votre application l'exige, activez des fonctionnalités facultatives telles que l'e-commerce amélioré, l'IDFA (identifiant pour les annonceurs) et la mesure des campagnes d'installations iAd.