Premiers pas avec Google Analytics


Ce guide de démarrage rapide vous explique comment ajouter Google Analytics à votre application et commencer à consigner 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 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 de commencer

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

    • Si vous créez un projet Firebase, activez Google Analytics au cours du workflow de création du projet.

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

    Lorsque vous activez Google Analytics dans votre projet, vos applications Firebase sont associé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 des campagnes.

Ajouter le SDK Analytics à votre application

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

  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 :
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Choisissez 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 de l'IDFA ou avec collecte de l'IDFA.
  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 sur la Confidentialité des utilisateurs et l'utilisation des données et sur la transparence du suivi des applications d'Apple.

Ensuite, effectuez les étapes de configuration suivantes:

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

    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 struct App via UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor. Vous devez également désactiver le mélange des délégués 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()
      }
    }
  }
}


(Facultatif) Désactiver l'enregistrement de l'attribution des réseaux publicitaires Apple

Pour plus de commodité, le SDK enregistre automatiquement votre application auprès d'Apple pour l'attribution de 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

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

Certains événements sont recommandés pour toutes les applications, tandis que d'autres sont recommandés pour des types d'activités ou des secteurs spécifiques. Vous devez envoyer les événements suggérés avec leurs paramètres prescrits pour obtenir le plus de détails possible dans vos rapports, et profiter des futures fonctionnalités et intégrations dès qu'elles seront disponibles. Cette section montre comment consigner un événement prédéfini. Pour en savoir plus sur la journalisation des événements, consultez Journaliser 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:

Swift

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

Objective-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"
                                 }];
ViewController.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