Premiers pas avec Google Analytics pour Unity

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 les segments de votre base d'utilisateurs, tels que les préférences linguistiques 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 aucune limite sur le 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 automatiquement créés pour chaque type distinct d'événement Analytics 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 communs à différents types d'applications, notamment les applications de vente au détail et de commerce électronique, de voyage et de jeux. Pour en savoir plus sur ces événements et savoir quand 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. 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 Unity et configurez-le 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 un exemple d'application .

  • Ajoutez le SDK Firebase Unity (en particulier FirebaseAnalytics.unitypackage ) à votre projet Unity.

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

Journaliser les événements

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

L'exemple suivant enregistre les é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);

Prochaines étapes