Premiers pas avec Google Analytics

Ce démarrage rapide vous montre comment ajouter Google Analytics à votre application et commencer à enregistrer les é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 : 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 les segments de votre base d'utilisateurs, tels que les préférences linguistiques 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 Apple 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 du projet.

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

    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 framework AdSupport à votre projet pour activer des fonctionnalités supplémentaires telles que les audiences et l'attribution de campagnes.

Ajoutez le SDK Analytics à votre application

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

  1. Dans Xcode, avec votre projet d'application ouvert, accédez à File > Add Packages .
  2. Lorsque vous y êtes invité, ajoutez le référentiel SDK des plates-formes Apple Firebase :
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Choisissez la bibliothèque Analytics.
  5. Ajoutez l'indicateur -ObjC à la section Autres indicateurs de l'éditeur de liens des paramètres de construction de votre cible.
  6. 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 soit la bibliothèque sans collection IDFA, soit avec la collection IDFA.
  7. Une fois terminé, Xcode commencera automatiquement à résoudre et à télécharger vos dépendances en arrière-plan.

Apprenez-en davantage sur l’IDFA, l’identifiant publicitaire au niveau de l’appareil, dans la documentation Apple sur la confidentialité, l’utilisation des données et la transparence du suivi des applications .

Ensuite, effectuez quelques étapes de configuration :

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

    SwiftUI

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

    Rapide

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objectif c

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Configurez une instance partagée FirebaseApp dans la méthode application(_:didFinishLaunchingWithOptions:) de votre délégué d'application :

    SwiftUI

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

    Rapide

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

    Objectif 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'attacher à votre structure App via UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor . Vous devez également désactiver le swizzling des délégués d’application. Pour plus d'informations, 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()
          }
        }
      }
    }
          


(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.

Commencer à enregistrer les é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'entreprises ou des secteurs verticaux spécifiques. Vous devez envoyer des suggestions d'événements avec leurs paramètres prescrits, pour garantir un maximum de détails disponibles dans vos rapports et bénéficier des futures fonctionnalités et intégrations dès qu'elles seront disponibles. Cette section illustre la journalisation d'un événement prédéfini. Pour plus d'informations sur la journalisation des événements, voir Journaliser les événements .

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 :

Rapide

Remarque : Ce produit Firebase n'est pas disponible sur la cible macOS.
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

Objectif c

Remarque : Ce produit Firebase n'est pas disponible sur la cible macOS.
[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 transmis au lancement , ajoutez -FIRAnalyticsDebugEnabled .

Prochaines étapes