Consigner les événements

Ce guide vous montre comment enregistrer des événements dans votre application.

Les événements donnent un aperçu de ce qui se passe dans votre application, comme les actions des utilisateurs, les événements système ou les erreurs.

Analytics enregistre automatiquement certains événements pour vous; vous n'avez pas besoin d'ajouter de code pour les recevoir. Si votre application a besoin de recueillir des données supplémentaires, vous pouvez vous connecter jusqu'à 500 différents types d' événements Analytics dans votre application. Il n'y a pas de limite sur le volume total d'événements que votre application enregistre. Notez que les noms d'événements sont sensibles à la casse et que la consignation de deux événements dont les noms ne diffèrent que par la casse entraînera deux événements distincts.

Avant que tu commences

Assurez - vous que vous avez configuré votre projet et peut accéder à Google Analytics comme décrit dans Premiers pas avec Google Analytics .

Consigner les événements

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

Pour vous aider à démarrer, le SDK Analytics définit un certain nombre d'événements suggérés qui sont communs à différents types d'applications, y compris les applications de vente au détail et de commerce électronique, de voyage et de jeux. Pour en savoir plus sur ces événements et quand les utiliser, parcourez les articles [Événements et propriétés][suggested-events-hc] dans le centre d'aide Firebase.

Vous trouverez tous les détails de mise en œuvre dans la référence constantes pour Swift et Objective-C .

L'exemple suivant montre comment connecter un suggéré kFIRSelectContent événement:

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

En plus des paramètres prescrits, vous pouvez ajouter les paramètres suivants à n'importe quel événement :

  • Les paramètres personnalisés: les paramètres personnalisés peuvent être enregistrés pour les rapports dans vos rapports Analytics. Ils peuvent également être utilisés comme filtres dans l' auditoire des définitions qui peuvent être appliquées à tous les rapports. Les paramètres personnalisés sont également inclus dans les données exportées vers BigQuery si votre application est liée à un projet BigQuery.

  • kFIRParameterValue paramètre: kFIRParameterValue est un paramètre objectif général qui est utile pour accumuler une mesure clé qui se rapporte à un événement. Les exemples incluent les revenus, la distance, le temps et les points.

Si votre application a des besoins spécifiques non couverts par un type d'événement suggéré, vous pouvez enregistrer vos propres événements personnalisés, comme illustré dans cet exemple :

Rapide

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])

Objectif c

 [FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

Définir les paramètres d'événement par défaut

Vous pouvez vous connecter à l' aide de paramètres à travers des événements setDefaultEventParameters . Les paramètres par défaut sont associés à tous les événements futurs qui sont consignés.

Rapide

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Objectif c

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

Si un paramètre est specificed dans la logEvent() méthode, cette valeur est utilisée au lieu de la valeur par défaut.

Pour effacer un paramètre par défaut, appelez la setDefaultEventParameters méthode avec le jeu de paramètres à nil .

Afficher les événements dans la console de débogage Xcode

Vous pouvez activer la journalisation détaillée pour surveiller la journalisation des événements par le SDK afin de vérifier que les événements sont correctement enregistrés. Cela inclut à la fois les événements enregistrés automatiquement et manuellement.

Vous pouvez activer la journalisation détaillée comme suit :

  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 .

La prochaine fois que vous exécuterez votre application, vos événements s'afficheront dans la console de débogage Xcode, vous aidant à vérifier immédiatement que les événements sont envoyés.

Afficher les événements dans le tableau de bord

Vous pouvez afficher des statistiques agrégées sur vos événements dans les tableaux de bord de la console Firebase. Ces tableaux de bord sont mis à jour périodiquement tout au long de la journée. Pour un test immédiat, utilisez la sortie logcat comme décrit dans la section précédente.

Vous pouvez accéder à ces données de l' événement tableau de bord dans la console Firebase. Ce tableau de bord affiche les rapports d'événements qui sont automatiquement créés pour chaque type d'événement distinct enregistré par votre application.