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
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 utilisez un projet Firebase existant pour lequel Google Analytics n'est pas activé, accédez à l'onglet Intégrations 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.
(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
- Ajoutez la dépendance pour Firebase à votre Podfile:
pod 'Firebase/Analytics'
- Exécutez l'
pod install
et ouvrez le fichier.xcworkspace
créé. - Importez le module Firebase dans votre
UIApplicationDelegate
:Rapide
import Firebase
Objectif c
@import Firebase;
- Configurez une instance partagée
FirebaseApp
, généralement dans l'application de votreapplication: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
Après avoir 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:
- Dans Xcode, sélectionnez Produit> Schéma> Modifier le schéma ...
- Sélectionnez Exécuter dans le menu de gauche.
- Sélectionnez l'onglet Arguments .
- Dans la section Arguments
-FIRAnalyticsDebugEnabled
lancement , ajoutez-FIRAnalyticsDebugEnabled
.
Prochaines étapes
- Utilisez 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 des utilisateurs.
- Découvrez comment exporter vos données vers BigQuery.