Métriques d’événements

  • Article

Important

La mise hors service de Visual Studio App Center est prévue pour le 31 mars 2025. Bien que vous puissiez continuer à utiliser Visual Studio App Center jusqu’à sa mise hors service complète, il existe plusieurs alternatives recommandées vers lesquelles vous pouvez envisager la migration.

En savoir plus sur les chronologies et les alternatives de support.

Les événements sont des actions que les utilisateurs effectuent dans votre application. En suivant les événements dans votre application, vous en apprendrez davantage sur le comportement de vos utilisateurs et comprendrez l’interaction entre vos utilisateurs et vos applications. L’attachement de propriétés à vos événements vous fournira des informations contextuelles sur les événements.

Le suivi des événements dans votre application vous permet de répondre à des questions telles que :

  • Quel est le N premier contenu consulté ?
  • Quel est le contenu le plus aimé ?
  • Quel type de fichiers mes utilisateurs envoient-ils ?

Pour suivre des événements personnalisés dans votre application, utilisez notre trackEvent API à partir du Kit de développement logiciel (SDK) App Center Analytics. Pour plus d’informations sur la définition d’événements personnalisés à l’aide de notre KIT de développement logiciel (SDK), consultez la documentation du SDK App Center pour Android, iOS, React Native, MAUI/Xamarin, Windows, macOS et Unity.

Informations générales

Vous pouvez filtrer la page d’événements par intervalle de temps (les 1, 7 ou 28 derniers jours) et pour la version de l’application sélectionnée. Ces filtres vous permettent d’explorer les données de vos événements jusqu’à la période sélectionnée ou à la version de l’application.

Page Événements

La page Événements fournit un tableau avec une vue d’ensemble des événements qui se produisent dans votre application. Cette table peut être triée par nombre dans l’ordre décroissant et croissant. Vous pouvez également rechercher un événement dans la table par son nom. Pour chaque événement, les informations suivantes sont fournies :

  • Nombre : nombre de fois qu’un événement a été déclenché.
  • Tendance : modification du nombre en valeur absolue et en pourcentage par rapport à la période sélectionnée précédente.
  • Utilisateurs : nombre d’utilisateurs qui ont déclenché un événement.
  • Modification de l’utilisateur : modification du nombre d’utilisateurs en valeur absolue et en pourcentage, par rapport à la période sélectionnée précédente.
  • Nombre par utilisateur : nombre moyen de fois qu’un événement est déclenché par utilisateur.

Mode Détail de l’événement

Sélectionnez un événement dans la table d’événements pour afficher des informations plus détaillées :

  • Utilisateurs : nombre total d’utilisateurs qui ont déclenché l’événement. LAST (n) DAYS est un calcul de tendance.
  • Nombre : nombre total de fois que l’événement a été déclenché.
  • Nombre par utilisateur : nombre moyen de fois que l’événement est déclenché par utilisateur.
  • Nombre par session : nombre moyen de fois où l’événement est déclenché par session.

Supprimer l’historique des événements

Supprimez des événements individuels de l’affichage Détails de l’événement en cliquant sur l’option Paramètres en haut à droite de la page et en sélectionnant « Supprimer l’historique des événements ». Il est impossible d’annuler cette opération.

Propriétés des événements

Les propriétés des événements fournissent des informations contextuelles sur les événements. Ils permettent de mieux comprendre les actions que les utilisateurs effectuent dans votre application.

Voici des exemples d’événements et de propriétés :

  • Nom de l’événement : « Chargement de fichier », propriétés de l’événement : « .PDF », « .txt », « .PNG ».
  • Nom de l’événement : « Question répondue », propriétés de l’événement : « Accept », « Decline », « Ignore ».

Les valeurs de propriété sont optimisées pour les valeurs de type « String ».

Limites

  • Le nombre maximal d’événements personnalisés distincts pouvant être suivis quotidiennement est de 200. Ce nombre est réinitialisé à 12 h UTC. Toutefois, le nombre maximal d’instances d’événements envoyées par appareil n’est pas limité.
  • Le nombre maximal de noms et/ou de valeurs de propriétés d’événement par événement est de 20. Lorsque plus de 20 noms de propriétés et/ou valeurs sont envoyés, seuls les 20 premiers sont traités et les autres sont automatiquement supprimés.
  • Le SDK tronque les noms d’événements aux 256 premiers caractères.
  • Le Kit de développement logiciel (SDK) tronque chaque clé de propriété et chaque valeur aux 125 premiers caractères.
  • Le portail affiche jusqu’aux 10 valeurs de propriétés avec les nombres les plus élevés.

Les événements peuvent vous aider à identifier la cause racine des plantages d’application. Dans le cadre du service d’incidents App Center, vous pouvez voir tous les événements qui se sont produits avant un incident pour une session spécifique.

Pour afficher les événements avant un incident, intégrez le Kit de développement logiciel (SDK) Analytics dans l’application et définissez un ou plusieurs événements.

Les barres de navigation sont stockées pendant 28 jours, tandis que les incidents peuvent potentiellement être stockés indéfiniment. Cela signifie que si vous regardez un incident de plus de 28 jours, vous ne verrez pas la barre de navigation correspondante.

Erreurs gérées

Pour suivre les erreurs gérées dans App Center, nous vous recommandons d’utiliser la fonctionnalité spécifique pour celle-ci. Pour plus d’informations à ce sujet, consultez notre documentation officielle.