Premiers pas avec Google Analytics pour C++

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


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

  • Événements : ce qui se passe dans votre application, comme les actions des utilisateurs, 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, comme les préférences de langue ou l'emplacement géographique.

Analytics enregistre automatiquement certains événements et certaines 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.

Vous pouvez accéder à ces données sur les pages Analytics de la console Firebase.

La page Analytics > Événements affiche les rapports d'événements créés automatiquement pour chaque type d'événement Analytics distinct enregistré par votre application. En savoir plus sur le tableau de bord

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 les applications de jeu. Pour en savoir plus sur ces événements et sur les cas d'utilisation, consultez Événements recommandés. Pour obtenir le plus de détails possible dans les rapports, enregistrez les événements recommandés qui sont pertinents pour votre application, ainsi que leurs paramètres prescrits. Cela vous permet également de bénéficier des dernières fonctionnalités Google Analytics dès qu'elles sont disponibles.

Avant de commencer

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 des fichiers de configuration Firebase depuis la console, puis vous 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 :

iOS+

Créez l'application Firebase :

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

Initialisez la bibliothèque Analytics : 

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

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);

Événements de journaux

Une fois que vous avez configuré l'instance firebase::App, vous pouvez commencer à consigner des événements avec la méthode LogEvent().

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

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

Étapes suivantes