Événements de journaux

Analytics enregistre automatiquement certains événements pour vous. Vous n'avez donc pas besoin d'ajouter de code pour les recevoir. Si votre application doit collecter des données supplémentaires, vous pouvez y enregistrer jusqu'à 500 types d'événements Analytics différents. 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 portant 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 pour les applications de la plate-forme Apple, veillez à 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 d'enregistrement pour les types d'événements recommandés dans la documentation de référence de l'API.

L'exemple suivant montre comment enregistrer 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 autres que les paramètres prescrits (obligatoires). 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é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 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. Vous trouverez des exemples de requêtes et bien plus encore sur la page BigQuery Export pour Google Analytics 4.

• Paramètre value : 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.

• 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 comme indiqué dans cet exemple :

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 dans tous les é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ètres valides sont String et num. Définir la valeur d'une clé sur null efface ce paramètre. Transmettre une valeur nulle efface tous les paramètres.

// 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.