Événements de journaux

Sélectionnez une plate-forme : iOS+ Android Web Flutter Unity C++


Les événements vous renseignent sur ce qui se passe dans votre application (actions des utilisateurs, événements système ou erreurs, par exemple).

Analytics enregistre automatiquement certains événements pour vous. Il n'y a donc pas de code à ajouter pour les recevoir. Si votre application doit collecter des données supplémentaires, vous pouvez y enregistrer jusqu'à 500 Analytics types d'événements différents. Le volume total d'événements enregistrés par votre application n'est pas limité. Notez que les noms des événements sont sensibles à la casse. Ainsi, si deux événements portent le même nom, mais avec une casse différente, deux événements distincts sont créés.

Avant de commencer

Assurez-vous d'avoir configuré votre projet et de pouvoir accéder à Analytics comme décrit dans Premiers pas avec Analytics.

Si vous souhaitez collecter des données d'attribution de campagne, veillez à ajouter le framework AdSupport à votre projet.

Événements de journaux

Une fois l'instance FirebaseApp configurée, vous pouvez commencer à enregistrer des événements avec la logEvent() méthode.

Pour vous aider à démarrer, le Analytics SDK définit un certain nombre d' événements recommandés qui sont courants dans différents types d'applications, y compris les applications de vente au détail et d'e-commerce, de voyage et de jeux. Pour en savoir plus sur ces événements et sur la façon de les utiliser, consultez Événements recommandés.

Pour en savoir plus sur l'implémentation, consultez la documentation de référence sur les constantes pour Swift et Objective-C.

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

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])
MigratedSnippets.swift

Objective-C

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

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 métriques dans les rapports Analytics. Vous pouvez utiliser des dimensions personnalisées pour les données de paramètres d'événement 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 vous assurer que ces paramètres personnalisés apparaissent dans les rapports Analytics. Pour ce faire, accédez à 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 associée à un projet BigQuery. Pour trouver des exemples de requêtes et bien plus encore à BigQuery Export pour Google Analytics 4.

  • Paramètre kFIRParameterValue : kFIRParameterValue est un paramètre à usage général qui est utile pour cumuler une métrique clé liée à un événement. Par exemple, 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 :

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])
MigratedSnippets.swift

Objective-C

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

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

Vous pouvez enregistrer des paramètres dans tous les é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 vous assurer que ces paramètres personnalisés apparaissent dans les rapports Analytics.

Swift 

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

Objective-C 

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

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

Pour effacer un paramètre par défaut, appelez la setDefaultEventParameters méthode 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 l'enregistrement des événements par le SDK et vérifier ainsi que les événements sont correctement enregistré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 Product > Scheme > Edit scheme… (Produit > Schéma > Modifier le schéma…).
  2. Sélectionnez Run (Exécuter) dans le menu de gauche.
  3. Sélectionnez l'onglet Arguments.
  4. Dans la section Arguments Passed On Launch (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, ce qui vous permettra de vérifier immédiatement qu'ils 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 Firebase tableaux de bord. Ces tableaux de bord sont mis à jour régulièrement tout au long de la journée. Pour effectuer des tests immédiats, utilisez la sortie logcat comme décrit dans la section précédente.

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