Google 致力于为黑人社区推动种族平等。查看具体举措。
此页面由 Cloud Translation API 翻译。
Switch to English

Commencez 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: ce qui se passe dans votre application, comme les actions des utilisateurs, 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, tels que la préférence de langue ou l'emplacement géographique.

Analytics enregistre automatiquement certains événements et propriétés des utilisateurs ; 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 disposez d'un projet Firebase existant pour lequel Google Analytics n'est pas activé, vous pouvez activer Google Analytics à partir de l'onglet Intégrations de vos > Paramètres du projet .

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

  2. (Recommandé) . Ajoutez la structure 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

  1. Ajoutez la dépendance pour Firebase à votre Podfile: 
    pod 'Firebase/Analytics'
  2. Exécutez l' 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: method:

    Rapide

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

    Objectif c

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


(Facultatif) Désactivez l'enregistrement d'attribution du réseau publicitaire Apple

Pour votre commodité, le SDK enregistre automatiquement votre application auprès d'Apple pour l'attribution d'un 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 (Boolean) dans le fichier info.plist de votre application.

Commencer la journalisation des événements

Une fois que vous avez configuré l'instance FirebaseApp , vous pouvez commencer à consigner 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 pour 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 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