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.

iOS Android Web

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

   Note: Les projets créés Firebase avant le 31 Juillet, 2019 peuvent passer à la pleine expérience Google Analytics gratuitement de l' Intégrations onglet de vos > Paramètres du projet. Cette mise à niveau est facultative mais recommandée.

   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

Note: Nous vous recommandons d' utiliser CocoaPods pour installer les bibliothèques Firebase. Si vous choisissez de mettre en place à l' aide Firebase Package Swift Gestionnaire , vous pouvez sauter les étapes liées CocoaPods, comme la modification Podfiles et l' exécution du pod commande.

1. Ajouter la dépendance pour Firebase à votre PODFILE:

   pod 'Firebase/Analytics'
   
   # For Analytics without IDFA collection capability, use this pod instead
   # pod ‘Firebase/AnalyticsWithoutAdIdSupport’
   

   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.
2. Exécuter pod install et ouvrir le créé .xcworkspace fichier.
3. Importer le module Firebase dans votre UIApplicationDelegate :

   Rapide

   import Firebase

   Objectif c

   @import Firebase;

4. 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];

Si vous effectuez le suivi des achats in-app, vous devez initialiser votre observateur de transaction dans l' application:didFinishLaunchingWithOptions: avant d' initialiser Firebase ou votre observateur peut ne pas recevoir toutes les notifications d'achat. Voir Apple In-App Purchase les meilleures pratiques pour plus d' informations.

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

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

• Utilisez le DebugView pour vérifier vos événements.
• Explorez vos données dans la console Firebase.
• Explorez les guides sur les événements et les propriétés de l' utilisateur.
• Apprenez à exporter vos données vers BigQuery.