Premiers pas avec Google Analytics pour Unity

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

  • Événements : tout 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, comme leur préférence linguistique ou leur position 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é.

Pour accéder à ces données :

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

L'onglet É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 sur le moment où les utiliser, consultez Événements recommandés. Pour obtenir le maximum de détails dans les rapports, enregistrez les événements Analytics suggérés qui sont pertinents pour votre application et leurs 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 Unity et le configurer pour utiliser Firebase.

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

    • Si vous n'avez pas de projet Unity, vous pouvez télécharger une application exemple.

  • Ajouter le Firebase Unity SDK (plus précisément, FirebaseAnalytics.unitypackage) à votre projet Unity.

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

Événements de journaux

Vous pouvez commencer immédiatement à enregistrer des événements avec la LogEvent() méthode.

L'exemple suivant enregistre des événements avec différents types d'arguments :

// Log an event with no parameters.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(Firebase.Analytics.FirebaseAnalytics.EventLogin);

// Log an event with a float parameter
Firebase.Analytics.FirebaseAnalytics
  .LogEvent("progress", "percent", 0.4f);

// Log an event with an int parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventPostScore,
    Firebase.Analytics.FirebaseAnalytics.ParameterScore,
    42
  );

// Log an event with a string parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventJoinGroup,
    Firebase.Analytics.FirebaseAnalytics.ParameterGroupId,
    "spoon_welders"
  );

// Log an event with multiple parameters, passed as a struct:
Firebase.Analytics.Parameter[] LevelUpParameters = {
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterLevel, 5),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterCharacter, "mrspoon"),
  new Firebase.Analytics.Parameter(
    "hit_accuracy", 3.14f)
};
Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventLevelUp,
  LevelUpParameters);

Étapes suivantes