Événements de journaux

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

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. Le volume total d'événements enregistrés par votre application n'est pas limité. Notez que les noms d'événements sont sensibles à la casse. Si vous enregistrez deux événements dont les noms ne diffèrent que par la casse, deux événements distincts seront 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 pour les applications de la plate-forme Apple, assurez-vous d'ajouter le framework AdSupport à votre projet.

Événements de journaux

Une fois que vous avez créé une instance FirebaseAnalytics, vous pouvez l'utiliser pour enregistrer des événements avec les méthodes log de la bibliothèque.

Événements prédéfinis

Pour vous aider à démarrer, le SDK Analytics 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 le moment où les utiliser, consultez Événements recommandés.

Vous trouverez les méthodes de journalisation pour les types d'événements recommandés dans la documentation de référence de l'API.

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

await FirebaseAnalytics.instance.logSelectContent(
    contentType: "image",
    itemId: itemId,
);

Vous pouvez également enregistrer le même événement à l'aide de logEvent() :

await FirebaseAnalytics.instance.logEvent(
    name: "select_content",
    parameters: {
        "content_type": "image",
        "item_id": itemId,
    },
);

Cela peut être utile si vous souhaitez spécifier des paramètres supplémentaires en plus de ceux prescrits (obligatoires). Vous pouvez ajouter les paramètres suivants à n'importe quel événement :

  • Paramètres personnalisés : ils 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 les données de paramètres mieux représentées numériquement. Après avoir 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 applicables à 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. Retrouvez des exemples de requêtes et bien plus encore sur BigQuery Export pour Google Analytics 4.

  • Paramètre value : paramètre à usage général qui permet d'accumuler une métrique clé liée à un événement. Par exemple, les revenus, la distance, la durée et les points.

  • Les noms de paramètres peuvent comporter jusqu'à 40 caractères. Ils doivent commencer par un caractère alphabétique et ne contenir que des caractères alphanumériques et des traits de soulignement. Les types "string" et "num" sont acceptés. Les valeurs des paramètres de chaîne peuvent comporter jusqu'à 100 caractères. Les préfixes "firebase", "google" et "ga_" sont réservés et ne doivent pas être utilisés pour les noms de paramètres.

Événements personnalisés

Si votre application a des besoins spécifiques qui ne sont pas couverts par un type d'événement recommandé, vous pouvez enregistrer vos propres événements personnalisés en suivant l'exemple ci-dessous :

await FirebaseAnalytics.instance.logEvent(
    name: "share_image",
    parameters: {
        "image_name": name,
        "full_text": text,
    },
);

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

Vous pouvez enregistrer des paramètres pour plusieurs événements à l'aide de setDefaultEventParameters(). Les paramètres par défaut sont associés à tous les futurs événements enregistrés.

Comme pour les paramètres personnalisés, enregistrez les paramètres d'événement par défaut pour vous assurer qu'ils apparaissent dans les rapports Analytics.

Les valeurs de paramètre valides sont String et num. Si vous définissez la valeur d'une clé sur null, ce paramètre est effacé. Si vous transmettez une valeur nulle, tous les paramètres sont effacés.

// Not supported on web
await FirebaseAnalytics.instance
  .setDefaultEventParameters({
    version: '1.2.3'
  });

Si un paramètre est spécifié dans la méthode logEvent() ou log, 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 null.