Passer au contenu principal
Comme décrit dans la vue d’ensemble des données de joueur, les statistiques sont des informations clés utilisées pour suivre les performances d’un joueur, comme les tirs à la tête ou le meilleur temps au tour. Les statistiques servent à générer des classements dans des scénarios qui permettent aux joueurs de comparer leurs efforts et leurs compétences à ceux de leurs amis et de tous les autres joueurs de la communauté d’un titre. Les services XBOX détiennent et gèrent les statistiques. Elles sont mises à jour lorsque votre jeu envoie des événements d’actions utilisateur aux services XBOX. Les statistiques configurées apparaissent dans le classement d’un titre, où un joueur voit sa position par rapport à ses amis qui ont également joué au titre. Pour plus d’informations sur les classements du GameHub, consultez Concevoir des expériences avec les services XBOX. Deux implémentations des statistiques utilisateur sont disponibles pour les services XBOX :
  • Les statistiques gérées par le titre (anciennement appelées Stats 2017)
  • Les statistiques basées sur les événements (anciennement appelées Stats 2013)
Nous vous recommandons d’utiliser les statistiques gérées par le titre lors de la configuration de nouveaux titres. Toutefois, les variables de présence enrichie fonctionnent uniquement avec les statistiques basées sur les événements.
Les statistiques gérées par le titre et les statistiques basées sur les événements reposent sur des principes fondamentalement différents.

Statistiques gérées par le titre

Avec les statistiques gérées par le titre, vous envoyez la valeur réelle de la statistique pour que le serveur l’utilise. Avec les statistiques gérées par le titre, le serveur n’effectue que peu ou pas de validation sur la valeur qui lui est envoyée. C’est à votre titre de suivre les valeurs correctes des statistiques. Votre titre est la source de vérité des valeurs des statistiques. Avec les statistiques gérées par le titre, nous vous recommandons de suivre et de stocker vos statistiques dans le cloud avec le stockage cloud. Les statistiques gérées par le titre fonctionnent comme un service de création de rapports. Vous envoyez au serveur la statistique correcte de votre jeu. Votre statistique reste ensuite sur le serveur en attendant d’être affichée sur demande ou mise à jour.
Le classement global d’une statistique gérée par le titre ne conserve que la valeur la plus élevée enregistrée pour chaque joueur. L’écriture d’une valeur inférieure met à jour la statistique stockée avec cette valeur inférieure, mais ne fait pas baisser la position du joueur dans le classement global. Si votre titre a besoin que les positions dans le classement puissent baisser (par exemple, une note qui monte ou descend, ou un score qui se réinitialise en cas de défaite), utilisez des statistiques basées sur les événements avec une règle de statistique Replace, ou un service de classement externe tel que PlayFab Leaderboards v2. Pour plus de détails, consultez la vue d’ensemble des statistiques gérées par le titre et la référence XblLeaderboardQuery.

Statistiques basées sur les événements

Avec les statistiques basées sur les événements, le jeu envoie des événements aux services XBOX. Ces événements incluent des détails spécifiques sur les actions effectuées par un joueur. Les informations contenues dans ces événements servent à mettre à jour les statistiques en conséquence. Avec les statistiques basées sur les événements, le service suit et met à jour toutes les valeurs de vos statistiques. Le service est la source de vérité des valeurs des statistiques d’un joueur ou d’un groupe de joueurs.

Historique

Avec le lancement de la XBOX One, les services XBOX ont introduit les statistiques basées sur les événements. Elles offraient de nombreux avantages. Par exemple, un seul événement de jeu peut mettre à jour les données de plusieurs fonctionnalités XBOX, comme les classements et les succès, et la configuration des services XBOX est gérée sur le serveur plutôt que sur le client, entre autres possibilités. Au cours des années qui ont suivi le lancement de la XBOX One, les développeurs ont demandé un service de statistiques plus simple, permettant de s’affranchir de la complexité inhérente à un système basé sur les événements. Ils pourraient alors utiliser les méthodes de suivi des statistiques qu’ils pratiquaient déjà. Sur la base des commentaires des développeurs, une nouvelle version simplifiée des statistiques a été créée pour redonner au développeur le contrôle de la logique des statistiques. Ce système, ce sont les statistiques gérées par le titre. Il s’agit d’un service qui prend simplement la valeur que lui transmet le titre, ce qui donne aux développeurs le contrôle de la logique de détermination de la valeur d’une statistique.

Gestion des statistiques avec les statistiques basées sur les événements et les statistiques gérées par le titre

Examinons la configuration et la mise à jour des statistiques avec les statistiques basées sur les événements, puis avec les statistiques gérées par le titre. Par exemple, nous allons créer des statistiques pour un RPG générique et nous voulons suivre le nombre de monstres tués.

Statistiques basées sur les événements

Avec les statistiques basées sur les événements, votre titre envoie un événement qui contient des informations sur une action effectuée par un joueur. Dans cet événement, l’action consiste à tuer un orc alors que le joueur tient une épée. Parmi les informations contenues dans cet événement, on peut trouver le fait qu’une action d’élimination a été effectuée, que la cible était un orc, que le type de combat était le corps à corps et que l’arme utilisée était une épée. Les statistiques basées sur les événements font passer ces informations par un certain nombre de règles que vous, le développeur, configurez dans Partner Center, et mettent à jour les statistiques, également configurées par vous, en fonction de l’événement. Avec les statistiques basées sur les événements, le service suit la valeur que doivent avoir vos statistiques d’élimination. L’événement « tuer un orc avec une épée » peut mettre à jour plusieurs statistiques, comme le nombre d’éliminations, le nombre d’orcs tués et le nombre d’éliminations à l’épée.

Statistiques gérées par le titre

Avec les statistiques gérées par le titre, vous envoyez les valeurs réelles de vos statistiques. Pour l’exemple « tuer un orc avec une épée », votre titre suit individuellement le nombre total d’éliminations, les éliminations à l’épée et les orcs tués, et envoie au service le nombre mis à jour pour chaque statistique. Le service n’effectue que des vérifications minimales pour s’assurer que vous envoyez un nombre cohérent ; il est donc essentiel que votre titre envoie la statistique correcte. Bien que vous puissiez utiliser le service des statistiques gérées par le titre pour récupérer les valeurs des statistiques au début d’une session de jeu, ne l’utilisez pas pour confirmer la valeur d’une statistique pendant la session. Le diagramme suivant montre comment fonctionnent les deux types de statistiques.
  • Statistiques basées sur les événements à gauche
  • Statistiques gérées par le titre à droite
Statistiques basées sur les événements et statistiques gérées par le titre

Autres différences entre les deux approches

Pour les partenaires gérés, quelques autres différences sont à prendre en compte lors du choix entre statistiques basées sur les événements et statistiques gérées par le titre pour votre titre. Avec les statistiques basées sur les événements, vous pouvez :
  • Obtenir davantage de vues de classement.
  • Analyser plus facilement les métadonnées de vos statistiques. Dans notre exemple d’élimination d’orc, la statistique globale suivait le nombre d’éliminations.
  • Obtenir des statistiques détaillées sur ce qui a été tué, avec quelle arme, et toute autre information définissant l’élimination que vous pourriez configurer.
Les statistiques basées sur les événements disposent d’une statistique native « minutes jouées ». Utilisez les statistiques basées sur les événements pour accéder au temps de jeu d’un joueur sans avoir à configurer la statistique. Avec les statistiques gérées par le titre, toute statistique de temps de jeu doit être suivie par votre titre.

Fréquence de mise à jour

Avec les statistiques basées sur les événements, les événements sont écrits localement sur l’appareil, même si celui-ci est hors connexion et n’est pas connecté à Internet. Lorsque l’appareil est en ligne et connecté, un service s’exécutant sur l’appareil regroupe les événements et les charge vers la plateforme de données de joueur XBOX. En général, la mise à jour des statistiques basées sur les événements prend de 5 à 20 secondes si l’appareil est en ligne et connecté, entre le moment où l’événement est écrit localement sur l’appareil et celui où les informations mises à jour pour l’événement apparaissent dans les services XBOX. Avec les statistiques gérées par le titre, les valeurs réelles de vos statistiques sont mises à jour, puis vidées périodiquement du système directement vers la plateforme de données de joueur XBOX si l’appareil est en ligne et connecté à Internet. Les statistiques mises à jour sont automatiquement vidées du système toutes les 5 minutes. Vous pouvez vider manuellement les statistiques du système vers les services XBOX, mais le vidage manuel est limité à un intervalle minimal de 30 secondes entre deux vidages. En général, la mise à jour des statistiques gérées par le titre prend de 2 à 10 secondes si l’appareil est en ligne et connecté, entre le moment où les valeurs mises à jour sont vidées du système et celui où elles apparaissent dans les services XBOX. Les statistiques basées sur les événements peuvent prendre en charge d’autres services XBOX. Avec les statistiques basées sur les événements, vous pouvez utiliser les statistiques pour déverrouiller des succès et prendre des décisions de matchmaking. Les statistiques gérées par le titre ne peuvent servir qu’à produire des statistiques mises en avant et des classements.

Utiliser les succès gérés par le titre avec les statistiques basées sur les événements

Il est très courant que des titres utilisent les succès gérés par le titre conjointement avec les statistiques basées sur les événements. Cette combinaison ne pose aucun problème de compatibilité. Nous recommandons cette approche.

Voir aussi

Vue d’ensemble des statistiques basées sur les événements Vue d’ensemble des statistiques gérées par le titre
Dernière modification le 20 octobre 2026