Catch up on highlights from Firebase at Google I/O 2023. Learn more

Premiers pas avec Google Analytics pour C++

Google Analytics collecte des données d'utilisation et de comportement pour votre application. Le SDK enregistre deux principaux types d'informations :

  • Événements : Ce qui se passe dans votre application, comme les actions de l'utilisateur, les événements système ou les erreurs.
  • Propriétés utilisateur : attributs que vous définissez pour décrire des segments de votre base d'utilisateurs, tels que la préférence linguistique ou l'emplacement géographique.

Analytics enregistre automatiquement certains événements et propriétés utilisateur ; vous n'avez pas besoin d'ajouter de code pour les activer. Si votre application doit collecter des données supplémentaires, vous pouvez configurer jusqu'à 25 propriétés utilisateur Analytics différentes et enregistrer jusqu'à 500 types d'événements Analytics différents dans votre application. Il n'y a pas de limite au volume total d'événements enregistrés par votre application.

Pour accéder à ces données :

  1. Dans la console Firebase , ouvrez votre projet.
  2. Sélectionnez Analytics dans le menu pour afficher le tableau de bord des rapports Analytics.

L'onglet Événements affiche les rapports d'événements créés automatiquement pour chaque type distinct d'événement Analytics consigné par votre application. En savoir plus sur le tableau de bord des rapports Analytics dans le centre d'aide Firebase.

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 jeu. Pour en savoir plus sur ces événements et savoir quand les utiliser, parcourez les articles Événements et propriétés du centre d'aide Firebase. Pour obtenir le maximum de détails dans les rapports, enregistrez les événements Analytics suggérés qui ont un sens pour votre application et leurs paramètres prescrits. Cela garantit également que vous bénéficiez des dernières fonctionnalités de Google Analytics dès qu'elles sont disponibles.

Avant que tu commences

Avant de pouvoir utiliser Google Analytics , vous devez :

  • Enregistrez votre projet C++ et configurez-le pour utiliser Firebase.

    Si votre projet C++ utilise déjà Firebase, il est déjà enregistré et configuré pour Firebase.

  • Ajoutez le SDK Firebase C++ à votre projet C++.

Notez que l'ajout de Firebase à votre projet C++ implique des tâches à la fois dans la console Firebase et dans votre projet C++ ouvert (par exemple, vous téléchargez les fichiers de configuration Firebase à partir de la console, puis les déplacez dans votre projet C++).

Créer et initialiser l'application Firebase

Avant de commencer, vous devez créer et initialiser l'application firebase :

Android

Créez l'application firebase en transmettant l'environnement jni et une référence jobject à l'activité java en tant qu'arguments :

app = ::firebase::App::Create(::firebase::AppOptions(), jni_env, activity);

Initialisez la bibliothèque Analytics :

::firebase::analytics::Initialize(app);

iOS+

Créez l'application Firebase :

app = ::firebase::App::Create(::firebase::AppOptions());

Initialisez la bibliothèque Analytics :

::firebase::analytics::Initialize(app);

Journaliser les événements

Après avoir configuré l'instance firebase::App , vous pouvez commencer à consigner les événements avec la méthode LogEvent() .

L'exemple suivant met à jour le score de l'utilisateur :

analytics::LogEvent(analytics::kEventPostScore, analytics::kParameterScore, 42);

Prochaines étapes