Catch up on everthing we announced at this year's Firebase Summit. Learn more

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.

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

  • Événements: Qu'est - ce qui se passe dans votre application, telles que les actions de l' utilisateur, les événements du système ou des erreurs.
  • Propriétés de l' utilisateur: vous Attributs définissent pour décrire les segments de votre base d'utilisateurs, tels que les préférences linguistiques ou la situation géographique.

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

Avant que tu commences

  1. Si vous avez pas déjà, ajoutez Firebase à votre projet d' 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 de projet.

    • Si vous utilisez un projet existant qui ne Firebase pas Google Analytics activé, accédez à l' Intégrations onglet de vos > 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é). Ajouter le cadre AdSupport à votre projet pour activer des fonctionnalités supplémentaires telles que le public et l' attribution de la campagne.

Ajouter le SDK Analytics à votre application

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

  1. Dans Xcode, avec votre projet d'application ouvert, accédez à Fichier> Paquets Swift> Ajouter un package de dépendance.
  2. Lorsque vous y êtes invité, ajoutez le référentiel SDK des plates-formes Firebase Apple :
  3.   https://github.com/firebase/firebase-ios-sdk
      
  4. Choisissez la bibliothèque Analytics.
  5. Pour une expérience optimale avec Analytics, nous vous recommandons de permettre à Google Analytics dans votre projet Firebase et en ajoutant le SDK Firebase Google Analytics à votre application. Vous pouvez sélectionner la bibliothèque sans collection IDFA ou avec la collection IDFA.
  6. Une fois terminé, Xcode commencera automatiquement à résoudre et à télécharger vos dépendances en arrière-plan.

En savoir plus sur IDFA, le dispositif identifiant le niveau de la publicité, dans Apple la vie privée des utilisateurs et l' utilisation des données et applications de suivi de transparence documentation.

Ensuite, effectuez quelques étapes de configuration :

  1. Importer le module Firebase dans votre UIApplicationDelegate :

    Rapide

    import Firebase

    Objectif c

    @import Firebase;
  2. Configurer une FirebaseApp instance partagée, généralement dans votre application application:didFinishLaunchingWithOptions: méthode:

    Rapide

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

    Objectif c

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


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

Pour votre commodité, le SDK automatiquement enregistre votre application avec Apple pour l' attribution de réseau publicitaire avec SKAdNetwork . Si vous souhaitez désactiver cette fonction, définissez la valeur de GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED à NO (Boolean) dans le fichier Info.plist de votre application.

Démarrer la journalisation des événements

Une fois que vous avez configuré le FirebaseApp exemple, vous pouvez commencer à enregistrer des événements avec le logEvent() méthode.

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, pour garantir un maximum de détails disponibles dans vos rapports et pour bénéficier des futures fonctionnalités et intégrations dès qu'elles seront disponibles. Cette section explique la connexion d' un événement défini avant, pour plus d' informations sur l'enregistrement des événements, voir les événements du journal .

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

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

Objectif c

Note: Ce produit Firebase n'est pas disponible sur la cible de 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> Système> Modifier système ...
  2. Sélectionnez Exécuter dans le menu de gauche.
  3. Sélectionnez l'onglet Arguments.
  4. Dans les arguments Validé Dans la section lancement, ajoutez -FIRAnalyticsDebugEnabled .

Prochaines étapes