Partager via

App Center Analytics (Unity)

Important

Visual Studio App Center a été mis hors service le 31 mars 2025, à l’exception des fonctionnalités d’analyse et de diagnostic, qui continueront d’être prises en charge jusqu’au 30 juin 2026. En savoir plus.

App Center Analytics vous aide à comprendre le comportement des utilisateurs et l’engagement client pour améliorer votre application. Le SDK capture automatiquement le nombre de sessions et les propriétés d’appareil, comme le modèle, la version du système d’exploitation, etc. Vous pouvez définir vos propres événements personnalisés pour mesurer les éléments qui vous concernent. Toutes les informations capturées sont disponibles dans le portail App Center pour vous permettre d’analyser les données.

Suivez les instructions de la section Prise en main d’Unity si vous n’avez pas encore configuré le Kit de développement logiciel (SDK) dans votre application.

Remarque

Pour utiliser les API présentées ci-dessous, vous devez ajouter l’instruction suivante using à votre .cs fichier :

using Microsoft.AppCenter.Unity.Analytics;

Vous devez également vous assurer que Use Analytics est coché dans les paramètres de l'objet de jeu de votre App Center.

Informations sur la session et l’appareil

Une fois que vous avez ajouté App Center Analytics et démarré le Kit de développement logiciel (SDK), il effectue automatiquement le suivi des sessions et des propriétés d’appareil telles que la version du système d’exploitation, le modèle, etc. sans nécessiter de code supplémentaire dans votre application.

Événements personnalisés

Vous pouvez suivre vos propres événements personnalisés avec jusqu’à 20 propriétés pour savoir ce qui se passe dans votre application, comprendre les actions des utilisateurs et voir les agrégats dans le portail App Center.

Utilisez la TrackEvent() méthode pour suivre vos événements avec des propriétés. Vous pouvez envoyer jusqu’à 200 noms d’événements distincts. Il existe une limite maximale de 256 caractères par nom d’événement et de 125 caractères par nom et valeur de propriété d’événement.

Analytics.TrackEvent("Video clicked", new Dictionary<string, string> {
	{ "Category", "Music" },
	{ "FileName", "favorite.avi" }
});

Les propriétés des événements sont facultatives : si vous souhaitez simplement suivre un événement, utilisez cet exemple à la place :

Analytics.TrackEvent("Video clicked");

Avertissement

Analytics.TrackEvent() se comporte de manière incohérente entre les plateformes s’il est appelé avant la Awake() méthode dans le script AppCenterBehavior.cs. Pour être sûr, vous devez uniquement compter sur les événements envoyés après que la première scène de votre application a réveillé tous les MonoBehaviour scripts. Pour suivre un événement conjointement avec l’MonoBehavour's initialisation, envisagez d’ajouter l’API à la méthode Start() de votre script au lieu de Awake().

Activer ou désactiver App Center Analytics au moment de l’exécution

Vous pouvez activer et désactiver App Center Analytics au moment de l’exécution. Si vous le désactivez, le Kit de développement logiciel (SDK) cesse de collecter des informations d’analyse pour l’application. Pour désactiver Analytics, utilisez l’API suivante, en passant false en tant que paramètre.

Analytics.SetEnabledAsync(false);

Pour réactiver App Center Analytics, utilisez la même API, mais passez true en tant que paramètre.

Analytics.SetEnabledAsync(true);

L’état est conservé dans le stockage de l’appareil dans les lancements d’application.

Cette API est asynchrone, vous pouvez en savoir plus sur notre guide des API asynchrones App Center .

Vérifier si App Center Analytics est activé

Vous pouvez également vérifier si App Center Analytics est activé ou non.

bool isEnabled = await Analytics.IsEnabledAsync();

Priorité et persistance des événements

Vous pouvez suivre les événements critiques métier qui ont une importance plus élevée que d’autres événements.

Les développeurs peuvent définir la persistance des événements comme Normal (Flags.PersistenceNormal dans l’API) ou Critique (Flags.PersistenceCritical dans l’API).

Vous pouvez utiliser l’API suivante pour suivre un événement comme critique :

Analytics.TrackEvent("eventName", Flags.PersistenceCritical);

Si vous utilisez des propriétés :

Analytics.TrackEvent("eventName", new Dictionary<string, string> {
	{ "Category", "Music" },
	{ "FileName", "favorite.avi" }
}, Flags.PersistenceCritical);

Suspendre et reprendre l'envoi de fichiers journaux

La suspension de la transmission d’événements peut être utile dans les scénarios où l’application doit contrôler la bande passante réseau pour des besoins plus critiques pour l’entreprise. Vous pouvez suspendre l’envoi de journaux au back-end du centre d'applications. Lorsqu’ils sont suspendus, les événements peuvent toujours être suivis et enregistrés, mais ils ne sont pas envoyés immédiatement. Tous les événements suivis par votre application pendant la pause ne seront envoyés qu’une fois que vous appelez Analytics.Resume.

Analytics.Pause();
Analytics.Resume();

Cette API est asynchrone, vous pouvez en savoir plus sur notre guide des API asynchrones App Center .

Gérer la session de démarrage

Par défaut, l’ID de session dépend du cycle de vie de l’application. Si vous souhaitez contrôler manuellement le début d’une nouvelle session, suivez les étapes suivantes :

Remarque

Soyez attentif à ce que chaque appel de l’API Analytics.StartSession() génère une nouvelle session. Si, en mode de suivi de session manuel, cette API ne sera pas appelée, tous les journaux d’activité d’envoi auront une valeur de session Null.

Remarque

Attention, après le lancement d’une nouvelle application, l’ID de session sera régénéré.

  • Décochez la case Activer le suivi de session manuelle dans la section Analytique de l'objet de jeu avec AppCenterBehavior attaché.
  • Vous pouvez ensuite utiliser l’API StartSession après :AppCenter.Start
Analytics.StartSession();

Taille du stockage local

Par défaut, le Kit de développement logiciel (SDK) stocke jusqu’à 10 Mo de journaux d’activité dans le stockage.

Aucun accès à Internet

Lorsqu'il n'y a aucune connectivité réseau, le SDK enregistre jusqu'à 10 Mo de fichiers journaux dans le stockage local. Une fois que le stockage est plein, le Kit de développement logiciel (SDK) commence à supprimer les anciens journaux afin de faire de la place pour les nouveaux journaux. Une fois que l'appareil retrouve l'accès à Internet, le Kit de développement logiciel (SDK) envoie les journaux par lots de 50 ou toutes les 6 secondes.

Journaux des événements de traitement par lots

Le kit de développement logiciel (SDK) App Center charge les journaux d'activité dans un lot de 50 et, si le SDK n’a pas 50 journaux d'activité à envoyer, il envoie toujours les journaux après 6 secondes. Il peut y avoir un maximum de trois lots envoyés en parallèle.

Nouvelle tentative et logique d’interruption

Le Kit de développement logiciel (SDK) App Center prend en charge les nouvelles tentatives sur les erreurs réseau récupérables. Voici la logique de nouvelle tentative :

  • 3 essais maximum par requête.
  • Chaque requête a son propre automate d'état de réessai.
  • Tous les canaux de transmission sont désactivés (jusqu’au prochain processus d’application) après qu’une demande épuise toutes ses nouvelles tentatives.

Logique de repli

  • 50% randomisation, premier réessai entre 5 et 10 secondes, deuxième réessai entre 2,5 et 5 minutes, dernière tentative entre 10 et 20 minutes.
  • Si le réseau bascule de coupé à actif (ou de wi-fi à mobile), les états de réinitialisation sont activés et les demandes sont retentées immédiatement.
  • Last updated on