Premiers pas avec Google Analytics

Ce guide de démarrage rapide vous montre comment ajouter Google Analytics à votre application et commencer à enregistrer les événements.

iOS Android Web

Google Analytics collecte des données d'utilisation et de comportement pour votre application. Le SDK enregistre deux principaux types d'informations :

• Événements : ce qui se passe dans votre application, comme les actions de l'utilisateur, les événements système ou les erreurs.
• Propriétés de l'utilisateur : attributs que vous définissez pour décrire les segments de votre base d'utilisateurs, tels que la préférence linguistique ou l'emplacement géographique.

Analytics enregistre automatiquement certains événements et propriétés utilisateur ; vous n'avez pas besoin d'ajouter de code pour les activer.

Avant que tu commences

1. Si vous ne l'avez pas déjà fait, ajoutez Firebase à votre projet iOS et assurez-vous que Google Analytics est activé dans votre projet Firebase :

   • Si vous créez un nouveau projet Firebase, activez Google Analytics pendant le workflow de création de projet.

   • Si vous utilisez un projet Firebase existant sur lequel Google Analytics n'est pas activé, accédez à l'onglet Intégrations de vos  > Paramètres du projet pour l'activer.

   Remarque : Les projets Firebase créés avant le 31 juillet 2019 peuvent être mis à niveau vers l'expérience complète de Google Analytics gratuitement à partir de l'onglet Intégrations de vos  > Paramètres du projet . Cette mise à niveau est facultative mais recommandée.

   Lorsque vous activez Google Analytics dans votre projet, vos applications Firebase sont liées aux flux de données Google Analytics.

2. (Recommandé) . Ajoutez le cadre AdSupport à votre projet pour activer des fonctionnalités supplémentaires telles que les audiences et l'attribution de campagne.

Ajouter le SDK Analytics à votre application

1. Ajoutez la dépendance de Firebase à votre fichier Podfile :

   pod 'Firebase/Analytics'
   
   # For Analytics without IDFA collection capability, use this pod instead
   # pod ‘Firebase/AnalyticsWithoutAdIdSupport’
   

   En savoir plus sur IDFA, l'identifiant publicitaire au niveau de l'appareil, dans la documentation Apple sur la confidentialité des utilisateurs et l'utilisation des données et la transparence du suivi des applications .
2. Exécutez pod install et ouvrez le fichier .xcworkspace créé.
3. Importez le module Firebase dans votre UIApplicationDelegate :

   Rapide

   import Firebase

   Objectif c

   @import Firebase;

4. Configurez une instance partagée FirebaseApp , généralement dans l'application de votre application:didFinishLaunchingWithOptions: méthode :

   Rapide

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objectif c

   // Use Firebase library to configure APIs
   [FIRApp configure];

Si vous effectuez le suivi des achats application:didFinishLaunchingWithOptions: application, vous devez initialiser votre observateur de transactions dans application:didFinishLaunchingWithOptions: avant d'initialiser Firebase, application:didFinishLaunchingWithOptions: votre observateur risque de ne pas recevoir toutes les notifications d'achat. Consultez les meilleures pratiques d' achat via l'application d' Apple pour plus d'informations.

(Facultatif) Désactiver l'enregistrement de l'attribution du réseau publicitaire Apple

Pour votre commodité, le SDK enregistre automatiquement votre application auprès d'Apple pour l'attribution du réseau publicitaire avec SKAdNetwork . Si vous souhaitez désactiver cette fonctionnalité, définissez la valeur de GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED sur NO (booléen) dans le fichier info.plist de votre application.

Démarrer la journalisation des événements

Après avoir configuré l'instance FirebaseApp , vous pouvez commencer à enregistrer les événements avec la méthode logEvent() .

Certains événements sont recommandés pour toutes les applications ; d'autres sont recommandés pour des types d'entreprise ou des secteurs verticaux spécifiques. Vous devez envoyer des suggestions d'événements avec leurs paramètres prescrits, afin d'assurer un maximum de détails disponibles dans vos rapports et de bénéficier des futures fonctionnalités et intégrations dès qu'elles seront disponibles. Cette section illustre la consignation d'un événement prédéfini. Pour plus d'informations sur la consignation des événements, consultez Consigner les événements .

L'exemple suivant montre comment consigner un événement recommandé pour indiquer qu'un utilisateur a cliqué sur un élément spécifique de votre application :

Rapide

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont"
  ])

Objectif c

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

Pour afficher cet événement dans la console de débogage Xcode, activez le débogage Analytics :

1. Dans Xcode, sélectionnez Produit > Schéma > Modifier le schéma...
2. Sélectionnez Exécuter dans le menu de gauche.
3. Sélectionnez l'onglet Arguments .
4. Dans la section Arguments -FIRAnalyticsDebugEnabled lancement , ajoutez -FIRAnalyticsDebugEnabled .

Prochaines étapes

• Utilisez DebugView pour vérifier vos événements.
• Explorez vos données dans la console Firebase.
• Explorez les guides sur les événements et les propriétés utilisateur.
• Découvrez comment exporter vos données vers BigQuery.