Présentation du SDK Google Analytics pour iOS v2 (ancienne version)

Le SDK Google Analytics pour iOS permet aux développeurs de collecter facilement des données sur l'engagement utilisateur à partir de leurs applications. Ce document présente les avantages du SDK, ainsi qu'un guide pour commencer à mesurer votre application à l'aide d'un seul ID de propriété et d'EasyTracker.

Introduction

Le SDK Google Analytics pour iOS permet aux développeurs de collecter facilement des données sur l'engagement utilisateur à partir de leurs applications. Les développeurs peuvent ensuite utiliser les rapports Google Analytics pour mesurer:

  • Nombre d'utilisateurs actifs qui utilisent leurs applications.
  • L'endroit dans le monde où l'application est utilisée.
  • Adoption et utilisation de fonctionnalités spécifiques.
  • Achats et transactions via une application
  • Nombre et type de plantages de l'application.
  • Et bien d'autres métriques utiles.

Avant de commencer

Avant de commencer à implémenter le SDK, assurez-vous de disposer des éléments suivants:

Premiers pas

Pour commencer à utiliser le SDK, vous devez suivre trois étapes:

  1. Ajouter des en-têtes et des bibliothèques à votre projet
  2. Initialiser l'outil de suivi
  3. Ajouter une mesure d'écran

Une fois ces étapes terminées, vous pouvez mesurer les éléments suivants avec Google Analytics:

  • Installations d'applications
  • Utilisateurs actifs et données démographiques
  • Écrans et engagement utilisateur
  • Plantages et exceptions

1. Ajouter des fichiers d'en-tête et configurer votre projet

Téléchargez le SDK Google Analytics pour iOS et ajoutez les fichiers suivants à votre application à partir du package SDK:

  • GAI.h
  • GAITracker.h
  • GAITrackedViewController.h
  • GAITransaction.h
  • GAITransactionItem.h
  • libGoogleAnalytics.a

Le SDK Google Analytics utilise les frameworks CoreData et SystemConfiguration. Vous devez donc ajouter les éléments suivants aux bibliothèques associées de la cible de votre application:

  • libGoogleAnalytics.a
  • CoreData.framework
  • SystemConfiguration.framework

2. Initialisation du traceur

Pour initialiser le traceur, importez l'en-tête GAI.h dans le fichier .m de votre délégué d'application et ajoutez ce code à la méthode application:didFinishLaunchingWithOptions: de votre délégué d'application:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  // Optional: automatically send uncaught exceptions to Google Analytics.
  [GAI sharedInstance].trackUncaughtExceptions = YES;
  // Optional: set Google Analytics dispatch interval to e.g. 20 seconds.
  [GAI sharedInstance].dispatchInterval = 20;
  // Optional: set debug to YES for extra debugging information.
  [GAI sharedInstance].debug = YES;
  // Create tracker instance.
  id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"UA-YOUR-TRACKING-ID"];

}

id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];

Notez que dans l'exemple ci-dessus, "UA-YOUR-TRACKING-ID" est un espace réservé pour l'ID de suivi qui vous a été attribué lors de la création de la vue (profil) de votre application Google Analytics. Si vous n'utilisez qu'un seul ID de suivi dans votre application, il est préférable d'utiliser la méthode de suivi par défaut.

3. Implémenter la mesure d'écran

Pour mesurer automatiquement les vues dans votre application, demandez à vos contrôleurs de vue d'étendre GAITrackedViewController, une classe pratique qui étend UIViewController, et de fournir le nom de la vue à attribuer à chaque contrôleur de vue dans vos rapports. Un visionnage de l'écran est envoyé à Google Analytics chaque fois que cette vue est chargée.

Par exemple, supposons que vous ayez une vue "À propos" que vous souhaitez mesurer avec un en-tête de contrôleur de vue qui se présente comme suit:

@interface AboutViewController : UIViewController

Vous devez modifier cet en-tête pour qu'il indique:

#import "GAITrackedViewController.h"

@interface AboutViewController : GAITrackedViewController

Vous devez également indiquer le nom de la vue à utiliser dans vos rapports Google Analytics. Nous vous recommandons d'utiliser la méthode d'initialisation du contrôleur de vue (si vous en avez une) ou la méthode viewDidAppear::

- (void)viewDidAppear:(BOOL)animated {
  [super viewDidAppear:animated];
  self.trackedViewName = @"About Screen";
}

Tant que trackedViewName est défini avant l'appel de sendView:, la mesure automatique de l'écran a lieu. Chaque fois que la vue apparaît, un appel à sendView: avec le nom de vue fourni est généré.

Pour en savoir plus sur la mesure des écrans, consultez le guide du développeur d'écrans.

Félicitations ! Votre application est maintenant configurée pour envoyer des données à Google Analytics.

Étapes suivantes

Google Analytics offre bien d'autres possibilités, y compris la mesure des campagnes, des transactions et des paiements via les applications, ainsi que des événements d'interaction utilisateur. Consultez les guides du développeur suivants pour découvrir comment ajouter ces fonctionnalités à votre implémentation:

  • Configuration avancée : découvrez les options de configuration avancées, y compris l'utilisation de plusieurs outils de suivi.
  • Mesurer les campagnes : découvrez comment mesurer les performances des campagnes afin d'identifier les canaux et les campagnes qui génèrent des installations d'application.
  • Mesurer les événements : découvrez comment mesurer l'engagement des utilisateurs avec des contenus interactifs comme des boutons, des vidéos et d'autres médias grâce aux événements.
  • Mesurer les paiements via l'application : découvrez comment mesurer les paiements et les transactions via l'application.
  • Temps utilisateur : découvrez comment mesurer les temps utilisateur dans votre application afin de mesurer les temps de chargement, l'engagement avec les médias, etc.