Ce document décrit une ancienne version du SDK iOS. Si vous découvrez Analyitcs, utilisez la dernière version du SDK. En savoir plus

Ajouter Analytics à votre application iOS

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Ce guide explique comment ajouter Analytics à votre application iOS pour mesurer l'activité des utilisateurs sur les écrans nommés. Si vous n'avez pas encore d'application et que vous souhaitez simplement découvrir le fonctionnement d'Analytics, 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 fichier Podfile pour votre application, créez-en un maintenant:

pod init

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

pod 'GoogleAnalytics'

Enregistrez le fichier et exécutez :

pod install

Cette opération crée un fichier .xcworkspace pour votre application. Utilisez ce fichier pour tout futur développement de votre application.

Initialiser Analytics pour votre application

Maintenant que vous disposez du fichier de configuration de votre projet, vous êtes prêt à commencer l'implémentation. Commencez par configurer l'objet Analytics partagé dans AppDelegate. Votre application peut ainsi envoyer des données à Analytics. Pour ce faire:

  • 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, tel que 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>

Remplacez ensuite 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 de l'écran

Ici, vous envoyez un visionnage de l'écran nommé à Analytics chaque fois que l'utilisateur ouvre ou modifie des écrans dans votre application. Ouvrez un 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>
  • Utilisez une méthode ou une fonction de remplacement viewWillAppear pour insérer le suivi de l'écran.
  • Attribuez un nom à l'écran et effectuez le suivi.
id<GAITracker> tracker = [GAI sharedInstance].defaultTracker;
[tracker set:kGAIScreenName value:name];
[tracker send:[[GAIDictionaryBuilder createScreenView] build]];

Étapes suivantes

  • Consultez le guide d'implémentation d'applications mobiles pour apprendre à utiliser Google Analytics afin de mesurer les interactions des utilisateurs et de répondre aux questions sur l'utilisation des applications.
  • Examinez les 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 les fonctionnalités facultatives telles que l'e-commerce amélioré, l'IDFA (identifiant pour les annonceurs) et la mesure des campagnes incitant à installer l'iAd.