Premiers pas avec Google Analytics pour iOS+

Sélectionnez la plate-forme :

iOS+ Android Web Flutter Unity C++

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

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

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

Analytics enregistre automatiquement certains événements et propriétés utilisateur. Il n'y a donc pas de code à ajouter pour les activer.

Avant de commencer

1. Si ce n'est pas déjà fait, ajoutez Firebase à votre projet Apple et assurez-vous que Google Analytics est activé dans votre projet Firebase :

   • S'il s'agit d'un nouveau projet Firebase, activez Google Analytics pendant que vous le créez.

   • Si vous utilisez un projet Firebase existant où Google Analytics n'est pas activé, activez-le en accédant à l'onglet Intégrations de vos > Paramètres du projet.

   Lorsque vous activez Google Analytics dans votre projet, vos applications Firebase sont associées à des flux de données Google Analytics.

2. (Recommandé) Ajoutez le framework AdSupport à votre projet pour profiter de fonctionnalités supplémentaires, comme les audiences et l'attribution des campagnes.

Ajouter le Analytics SDK à votre application

Utilisez Swift Package Manager pour installer et gérer les dépendances Firebase.

Consultez notre guide d'installation pour découvrir les différentes façons d'ajouter des SDK Firebase à votre projet Apple.

1. Dans Xcode, à partir de votre projet d'application ouvert, accédez à File > Add Packages (Fichier > Ajouter des packages).
2. Lorsque vous y êtes invité, ajoutez le dépôt du SDK des plates-formes Firebase pour Apple :

  https://github.com/firebase/firebase-ios-sdk.git

Remarque : Les nouveaux projets utilisent la version par défaut du SDK (la plus récente), mais vous pouvez choisir une version plus ancienne si nécessaire.
3. Sélectionnez la bibliothèque Analytics.
4. Ajoutez l'indicateur -ObjC à la section Other Linker Flags (Autres indicateurs Linker) des paramètres de compilation de votre cible.
5. Pour une expérience optimale avec Analytics, nous vous recommandons d'activer Google Analytics dans votre projet Firebase et d'ajouter le SDK Firebase pour Google Analytics à votre application. Vous pouvez sélectionner la bibliothèque sans collecte d'IDFA ou avec collecte d'IDFA. Consultez notre FAQ sur la dernière organisation des modules dans le Google Analytics pour Firebase SDK.
6. Lorsque vous avez terminé, Xcode commence à résoudre et à télécharger automatiquement vos dépendances en arrière-plan.

Pour en savoir plus sur l'IDFA, l'identifiant publicitaire au niveau de l'appareil, consultez la documentation d'Apple sur la confidentialité des utilisateurs et l'utilisation des données User Privacy and Data Use et App Tracking Transparency.

Ensuite, effectuez quelques étapes de configuration :

1. Importez le module FirebaseCore dans votre UIApplicationDelegate, ainsi que tous les autres modules Firebase utilisés par le délégué de votre application. Par exemple, pour utiliser Cloud Firestore et Authentication :

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Swift

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. Configurez une FirebaseApp instance partagée dans la méthode application(_:didFinishLaunchingWithOptions:) du délégué de votre application :

   SwiftUI

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

   Swift

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

   Objective-C

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

3. Si vous utilisez SwiftUI, vous devez créer un délégué d'application et l'associer à votre App struct via UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor. Vous devez également désactiver le swizzling du délégué d'application. Pour en savoir plus, consultez les instructions SwiftUI.

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

Si vous effectuez le suivi des achats via l'application, vous devez initialiser votre observateur de transaction dans application:didFinishLaunchingWithOptions: avant d'initialiser Firebase. Sinon, votre observateur risque de ne pas recevoir toutes les notifications d'achat. Pour en savoir plus, consultez les bonnes pratiques d'Apple concernant les achats via l'application.

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

Pour plus de 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.

Commencer à enregistrer des événements

Une fois l'instance FirebaseApp configurée, vous pouvez commencer à enregistrer des événements avec la logEvent() méthode.

Certains événements sont recommandés pour toutes les applications ; d'autres le sont pour des types d'entreprises ou des secteurs spécifiques. Vous devez envoyer les événements suggérés avec leurs paramètres prescrits pour disposer de rapports aussi détaillés que possible, et profiter des futures fonctionnalités et intégrations dès qu'elles seront disponibles. Cette section explique comment enregistrer un événement prédéfini. Pour en savoir plus sur l' enregistrement des événements, consultez la page Événements de journaux.

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

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])
MigratedSnippets.swift

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];
ObjCMigratedSnippets.m

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

1. Dans Xcode, sélectionnez Product > Scheme > Edit scheme… (Produit > Schéma > Modifier le schéma…).
2. Sélectionnez Run (Exécuter) dans le menu de gauche.
3. Sélectionnez l'onglet Arguments.
4. Dans la section Arguments Passed On Launch (Arguments transmis au lancement), ajoutez -FIRAnalyticsDebugEnabled.

Étapes suivantes

• Comprendre chaque rapport Analytics.
• Utiliser le DebugView pour vérifier vos événements.
• Explorer vos données dans la Firebase console.
• Consulter les guides sur les événements et les propriétés utilisateur.
• Découvrir comment exporter vos données vers BigQuery.