Journaliser les événements

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

Les événements fournissent 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 doit collecter des données supplémentaires, vous pouvez enregistrer jusqu'à 500 types d'événements Analytics différents dans votre application. Il n'y a aucune limite sur le volume total d'événements enregistrés par votre application. Notez que les noms d'événements sont sensibles à la casse et que la journalisation de deux événements dont les noms diffèrent uniquement par la casse entraîne deux événements distincts.

Avant que tu commences

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

Journaliser les événements

Après avoir configuré l'instance FirebaseApp , vous pouvez commencer à enregistrer les événements avec la méthode logEvent() .

Pour vous aider à démarrer, le SDK Analytics définit un certain nombre d'événements recommandés qui sont communs à différents types d'applications, notamment 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 savoir quand les utiliser, consultez Événements recommandés .

Vous pouvez trouver les détails d'implémentation dans la référence des constantes pour Swift et Objective-C .

L'exemple suivant montre comment consigner un événement kFIRSelectContent recommandé :

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 :

  • Paramètres personnalisés : les paramètres personnalisés peuvent être utilisés comme dimensions ou statistiques dans les rapports Analytics . Vous pouvez utiliser des dimensions personnalisées pour les données de paramètres d'événements non numériques et des métriques personnalisées pour toutes les données de paramètres mieux représentées numériquement. Une fois que vous avez enregistré un paramètre personnalisé à l'aide du SDK, enregistrez la dimension ou la métrique pour garantir que ces paramètres personnalisés apparaissent dans les rapports Analytics. Faites cela via : Analytics > Événements > Gérer les définitions personnalisées > Créer des dimensions personnalisées

    Les paramètres personnalisés peuvent être utilisés dans les définitions d'audience qui peuvent être appliquées à chaque rapport. 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. Trouvez des exemples de requêtes et bien plus encore sur Google Analytics 4 BigQuery Export .

  • Paramètre kFIRParameterValue : kFIRParameterValue est un paramètre à usage général qui est utile pour accumuler une métrique clé relative à 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 recommandé, vous pouvez enregistrer vos propres événements personnalisés, comme indiqué 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 enregistrer les paramètres des événements à l'aide de setDefaultEventParameters . Les paramètres par défaut sont associés à tous les événements futurs enregistrés.

Comme pour les paramètres personnalisés, enregistrez les paramètres d'événement par défaut pour garantir que ces paramètres personnalisés apparaissent dans les rapports Analytics.

Rapide

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

Objectif c

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

Si un paramètre est spécifié dans la méthode logEvent() , cette valeur est utilisée à la place de la valeur par défaut.

Pour effacer un paramètre par défaut, appelez la méthode setDefaultEventParameters avec le paramètre défini sur 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 journalisés. Cela inclut les événements enregistrés automatiquement et manuellement.

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

  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 transmis au lancement , ajoutez -FIRAnalyticsVerboseLoggingEnabled .

La prochaine fois que vous exécuterez votre application, vos événements s'afficheront dans la console de débogage Xcode, vous aidant ainsi à 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 des tests immédiats, utilisez la sortie logcat comme décrit dans la section précédente.

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