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

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 où l'application est utilisée dans le monde.
  • Adoption et utilisation de fonctionnalités spécifiques.
  • Achats et transactions via une application.
  • Nombre et type de plantages d'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:

Getting Started

La prise en main du SDK se fait en trois étapes:

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

Une fois ces étapes terminées, vous pourrez 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 du package SDK à votre application:

  • 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 délégué de votre application et ajoutez ce code à la méthode application:didFinishLaunchingWithOptions: du délégué de votre 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 de votre application (profil) 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 mettre à jour cet en-tête pour indiquer:

#import "GAITrackedViewController.h"

@interface AboutViewController : GAITrackedViewController

Vous devez également indiquer le nom de la vue à utiliser dans vos rapports Google Analytics. Vous pouvez 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 vous offre bien plus de possibilités, y compris la mesure des campagnes, des transactions et des paiements via l'application, 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 – Apprenez-en plus sur les options de configuration avancées, y compris l'utilisation de plusieurs outils de suivi.
  • Mesurer les campagnes : découvrez comment implémenter la mesure 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 contenus multimédias à l'aide des é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.