Passer au contenu principal
Cette rubrique décrit comment le service Achievements basé sur les événements utilise la télémétrie de la plateforme de données (Data Platform) pour suivre les succès des joueurs.
Si votre titre utilise les succès basés sur les événements (anciennement appelés Achievements 2013) et que vous souhaitez prendre en charge plusieurs plateformes à l’avenir, vous devez continuer à utiliser les succès basés sur les événements. Cela est nécessaire pour que les utilisateurs puissent conserver leurs succès sur toutes les plateformes.
Pour aider les développeurs et les éditeurs à gérer leurs titres en tant que service, le service Achievements repose sur la plateforme de données basée sur les événements des services XBOX. La plateforme de données basée sur les événements se compose d’un modèle de données et d’un pipeline uniques, pilotés par les événements, que les développeurs de titres peuvent utiliser pour collecter la télémétrie d’utilisation et créer des expériences utilisateur fondées sur ces données. L’une des innovations clés de la plateforme de données est une taxonomie commune des statistiques utilisateur qui prend en charge une sémantique partagée, que les éditeurs peuvent utiliser pour obtenir des informations approfondies sur le comportement de leurs joueurs. Tous les succès sont dérivés des statistiques utilisateur au lieu de nécessiter des appels d’API directs de la part du titre. Ce choix a été fait pour deux raisons.
  1. Les développeurs peuvent ajouter des succès après le lancement du titre sans nécessiter de modifications de code ni de mises à jour supplémentaires du titre. Si un titre est bien instrumenté au lancement, le développeur peut ajouter de nouveaux succès en mettant à jour la configuration de service du titre dans le cloud.
  2. Le titre peut effectuer moins d’appels de service pour un même comportement utilisateur dans le titre. Par exemple, le titre peut journaliser un seul événement dont les statistiques utilisateur s’appliquent à plusieurs domaines. L’événement peut finalement contribuer à un succès, à un classement et à des rapports de business intelligence (BI).

​
Pipeline de données

Les étapes suivantes offrent une vue d’ensemble des étapes clés de l’utilisation du service Achievements.
  1. Configuration Concevez et publiez la configuration du titre qui spécifie les données pertinentes que les services XBOX doivent traiter ou stocker.
  2. Instrumentation Implémentez la journalisation des événements dans le titre afin que les données soient correctement encodées et transmises.
  3. Collecte Le titre utilise la bibliothèque de journalisation cliente pour alimenter la plateforme de données en événements. Ses services traitent les événements pour agréger, corréler, acheminer et stocker les statistiques de manière appropriée, en fonction de la configuration du titre.
  4. Traitement des succès Le service traite les modifications entrantes des statistiques pour détecter le moment où les objectifs des succès sont atteints. En fonction de la configuration du titre, le service déverrouille les succès, alerte les systèmes de récompense appropriés et stocke les enregistrements des succès.
  5. Notifications Le service Achievements communique l’activité de déverrouillage aux utilisateurs (via des notifications toast du système), aux titres, aux clients XBOX et aux autres services XBOX afin d’alimenter des expériences et des fonctionnalités supplémentaires.
  6. Analytique La plateforme de création de rapports en ligne et de BI que les éditeurs utilisent pour comprendre comment les joueurs utilisent leur titre.

​
Principales fonctionnalités du service Achievements

Les services XBOX ont considérablement étendu le service Achievements, ce qui offre aux développeurs de titres davantage d’options et de contrôle sur la manière d’utiliser les succès pour stimuler l’engagement des utilisateurs. Le service Achievements basé sur les événements a introduit les fonctionnalités suivantes :
  • Déverrouillages déclenchés par le cloud
  • Défis
  • Utilisation de liens profonds dans les succès
  • Progression des succès

​
Déverrouillages déclenchés par le cloud

Avec les succès basés sur les événements, les titres n’effectuent pas d’appels spécifiques aux succès vers les services XBOX pour déverrouiller un succès. Les développeurs et les éditeurs configurent désormais en ligne les règles de déverrouillage du succès dans la configuration de service dans le cloud. Les services XBOX se chargent du traitement de ces règles en temps réel dans le cloud. Cela permet aux développeurs et aux éditeurs d’ajouter de nouveaux succès et défis après le lancement d’un titre sans avoir à le mettre à jour.

​
Défis (succès à durée limitée)

Les défis ne sont plus disponibles dans le service Achievements géré par le titre, plus moderne, et leur utilisation n’est plus recommandée. Pour plus d’informations, consultez Succès basés sur les événements et succès gérés par le titre. Les défis sont des succès limités dans le temps que les utilisateurs ne peuvent déverrouiller que pendant une fenêtre de temps spécifiée. Ils se configurent exactement comme les succès, avec une icône, des règles de déverrouillage et l’option d’être masqués, sauf qu’ils exigent également la définition d’une fenêtre de temps d’éligibilité. Lorsqu’un utilisateur termine un défi, celui-ci est stocké en tant que succès déverrouillé dans l’historique des succès de l’utilisateur. Si un utilisateur a participé à un défi, mais que le défi n’a pas été déverrouillé pendant la fenêtre de temps d’éligibilité, cet enregistrement n’est pas enregistré dans l’historique des succès de l’utilisateur.

​
Utilisation de liens profonds dans les succès

Un titre peut utiliser le schéma Achievements pour spécifier un lien profond qui s’affiche dans les détails du succès. Le lien profond mène à l’endroit du jeu où le succès peut être obtenu. Le lien est mis en forme sous la forme d’une chaîne transmise au jeu lors de l’activation de protocole. Le titre doit analyser la chaîne pour déterminer où aller dans le jeu. Par exemple, un succès lié à l’achèvement d’un niveau du jeu peut inclure dans ses détails un lien profond qui transmet une chaîne au jeu. Celle-ci indique au jeu d’aller à ce niveau.

​
Progression des succès

Le service Achievements XBOX mesure la progression des succès et fournit des données que les titres peuvent utiliser pour afficher cette progression aux joueurs. Le service Achievements fournit des détails de progression pour chaque règle de succès. Si un succès comporte plusieurs exigences à remplir pour être déverrouillé, la réponse du service inclut des détails de progression pour chaque exigence. Si un succès comporte une seule exigence basée sur plusieurs statistiques, le service renvoie une seule valeur de progression qui combine les statistiques sous-jacentes.

​
Objet de progression

L’interrogation de la liste des succès d’un utilisateur renvoie un objet de progression. Il contient les données détaillées sur la règle de succès (exigence) et l’état actuel de la progression de l’utilisateur vers la satisfaction de cette exigence. Pour plus d’informations, consultez la référence XblAchievementProgression.
Dernière modification le 8 octobre 2026