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 enregistre deux types principaux d'informations :

  • Événements : tout ce qui se passe dans votre application, comme les actions de l'utilisateur, les événements du 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 leur préférence linguistique ou leur emplacement géographique.

Analytics enregistre automatiquement certains événements et propriétés utilisateur. Il n'y a donc pas de code à ajouter 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 Analytics types d'événements différents dans votre application. Le volume total d'événements enregistrés par votre application n'est pas limité.

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 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 quand les utiliser, consultez Événements recommandés. Pour obtenir le maximum de détails dans les rapports, enregistrez les événements recommandés qui sont pertinents pour votre application et les paramètres prescrits. Vous bénéficierez ainsi des dernières Google Analytics fonctionnalités dès qu'elles seront disponibles.

Avant de commencer

Avant de pouvoir utiliser Google Analytics, vous devez :

  • enregistrer votre projet C++ et le configurer pour utiliser Firebase.

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

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

Notez que l'ajout de Firebase à votre projet C++ implique des tâches à la fois dans la Firebase console et dans votre projet C++ ouvert (par exemple, vous téléchargez les 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 à enregistrer 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