Passer au contenu principal
Cette rubrique décrit les procédures d’ajout et de modification des règles de statistiques dans la configuration de service de Partner Center pour un titre. Les statistiques des joueurs sont créées et mises à jour selon les règles de statistiques déclenchées lorsqu’un jeu envoie des événements au service XBOX Live. Pour une introduction à la configuration des services XBOX, consultez Configuration de service. Pour une introduction à Data Platform 2013, consultez la rubrique XDK How the XBOX Live data platform 2013 works.

Qu’est-ce qu’une règle de statistique ?

Les règles de statistiques sont déclenchées lorsque le service XBOX Data Platform reçoit un événement portant un nom particulier. Le déclenchement d’une règle de statistique (par l’envoi d’un événement approprié) amène le service à créer ou à mettre à jour une ou plusieurs statistiques de joueur. Vous définissez les statistiques des joueurs, XBOX Live Data Platform les calcule, et elles sont stockées sous forme de paires nom-valeur pour chaque utilisateur. Voici quelques exemples de statistiques de joueur.
  • Nombre total de zombies tués avec un fusil à pompe en difficulté difficile
  • Nombre maximal d’ennemis vaincus au cours d’un match
  • Temps le plus rapide pour terminer une course
  • Nom de la voiture conduite le plus récemment
Les statistiques des joueurs peuvent être affichées dans l’interface utilisateur du hub de jeu du joueur en tant que statistiques mises en avant ou statistiques principales, affichées dans les classements et utilisées pour déverrouiller des succès. Chaque règle de statistique peut être configurée pour produire l’un des éléments suivants :
  • Une seule instance d’une statistique de joueur
  • Plusieurs instances d’une statistique de joueur basée sur un modèle de statistique
Pour plus d’informations sur les statistiques et les règles de statistiques, consultez les rubriques suivantes de la documentation XDK.
  • User Stats for Data Platform 2013
  • User Stat Rules
  • User Stats Scenarios
Le diagramme suivant illustre le flux d’un événement qui déclenche des règles de statistiques mettant à jour des instances de statistiques. Flux d'événements

Configurer une règle de statistique

1

Connectez-vous avec votre compte sur [Partner Center](https://developer.microsoft.com...

Connectez-vous avec votre compte sur Partner Center.
2

Sélectionnez votre titre, puis accédez à Services > XBOX Live.

Sélectionnez votre titre, puis accédez à Services > XBOX Live.
3

Sélectionnez le lien Stat rules.

Sélectionnez le lien Stat rules.
4

Sur la page Events and stat rules, configurez les événements et les règles de...

Sur la page Events and stat rules, configurez les événements et les règles de statistiques basées sur ces événements.
Comme les règles de statistiques sont basées sur des événements, vous devez créer un événement avant de pouvoir créer une règle de statistique. Pour plus de détails, consultez Configurer les événements XBOX Live pour Data Platform 2013 dans Partner Center.

Créer une règle de statistique

  1. Sur la page Events & Stat Rules, sélectionnez New stat rule.
  2. Dans la boîte de dialogue Add Stat Rule, spécifiez les valeurs des champs suivants.
    • Base event
      Dans la liste déroulante, sélectionnez l’événement de base qui déclenche cette règle de statistique.
    • Event fields added to the stat rule
      • Ce champ facultatif vous permet de sélectionner des champs inclus dans l’événement de base pour les intégrer à la règle de statistique.
      • Dans la liste déroulante, sélectionnez un champ à ajouter à la règle de statistique. Vous pouvez ajouter plusieurs champs de cette manière. Les champs sélectionnés sont ajoutés au nom racine de la règle de statistique, séparés par le caractère point.
      • Pour supprimer un champ, sélectionnez le X en regard de son nom.
    • Stat Rule Name
      Spécifiez un nom qui caractérise la règle de statistique et que vous retiendrez et reconnaîtrez facilement. Les noms des règles de statistiques se composent d’un nom racine, éventuellement suivi d’un ou plusieurs champs séparés par le caractère point. Pour connaître les exigences de nommage des règles de statistiques, consultez la rubrique XDK User Stat Rules.
    • Operator
      Sélectionnez l’un des opérateurs suivants.
      • Sum
        Incrémente la valeur de statistique existante de la valeur spécifiée dans le champ Parameter.
      • Min
        Utilise la valeur minimale entre la valeur de statistique existante et la valeur du champ Parameter.
      • Max
        Utilise la valeur maximale entre la valeur de statistique existante et la valeur du champ Parameter.
      • Replace
        Remplace la valeur de statistique par la valeur spécifiée dans le champ Parameter. Nous déconseillons d’utiliser l’opérateur Replace pour les statistiques qui pilotent des succès. Les événements ne sont pas toujours traités dans l’ordre, ce qui peut empêcher un succès de se déverrouiller. Utilisez plutôt l’opérateur SUM.
    • Parameter
      Spécifiez la valeur à utiliser dans l’opérateur sélectionné dans le champ Operator.
      • Si vous souhaitez utiliser un nombre statique que vous spécifiez, sélectionnez l’option literal, puis spécifiez la valeur dans la zone située sous l’option.
      • Si vous souhaitez utiliser la valeur d’un champ, sélectionnez l’option field et, dans la liste déroulante située sous l’option, sélectionnez le champ à utiliser.
    • Restrict other features like achievements and featured stats from accessing this info.
      Cochez cette case pour rendre la règle de statistique privée.
    • Only allow changes to this stat from a server event. Client events will be ignored.
      Cochez cette case pour indiquer que la règle de statistique est déclenchée uniquement par des événements envoyés via l’API de serveur à serveur, et non par des clients de jeu s’exécutant sur la console ou le PC.
  3. Après avoir configuré tous les champs et valeurs, sélectionnez Save, puis fermez la boîte de dialogue.
Votre nouvelle règle de statistique figure désormais sur la page Events & Stat Rules chaque fois que l’événement de la règle est sélectionné.

Modifier une règle de statistique existante

Une fois qu’un titre a réussi la certification finale, les règles de statistiques existantes d’un événement de ce titre ne peuvent plus être modifiées ni supprimées.
  1. Dans la colonne Stat rules de la page Events and stat rules de l’instance de produit, sélectionnez la règle de statistique que vous souhaitez modifier.
  2. Apportez les modifications dans la boîte de dialogue Update stat rule de l’événement.
  3. Sélectionnez Save.

Éditer une règle de statistique

L’édition d’une règle de statistique a lieu lorsque le nom d’une règle de statistique ou un champ d’événement a été supprimé, ajouté ou réorganisé. Cette opération est traitée comme la suppression d’une règle de statistique et la création d’une nouvelle. Selon cette définition, toutes les instances de statistiques sont supprimées lors de l’édition.

Copier une règle de statistique existante

Une fois qu’un titre a réussi la certification finale, les règles de statistiques existantes d’un événement de ce titre ne peuvent plus être modifiées ni supprimées.
  1. Sur la page Events and stat rules de l’instance de produit, recherchez la ligne contenant la règle de statistique que vous souhaitez supprimer.
  2. Sélectionnez Copy dans la colonne Actions de cette ligne.
  3. Apportez les modifications dans la boîte de dialogue Update stat rule de l’événement.
  4. Sélectionnez Save.

Supprimer une règle de statistique existante

  • Une fois qu’un titre a réussi la certification finale, les règles de statistiques existantes d’un événement de ce titre ne peuvent plus être modifiées ni supprimées.
  • La suppression d’une règle de statistique est une action définitive qui ne peut pas être annulée.
  • La suppression d’une règle de statistique supprime toutes les dépendances en chaîne qu’elle peut avoir. Avant de supprimer une règle de statistique, assurez-vous que vous souhaitez également supprimer toutes ses dépendances.
  1. Sur la page Events and stat rules de l’instance de produit, recherchez la ligne contenant la règle de statistique que vous souhaitez supprimer.
  2. Sélectionnez Delete dans la colonne Actions de cette ligne.
  3. Sélectionnez Delete dans la boîte de dialogue Confirmation.
Dépendance d'événement à supprimer
Dernière modification le 6 octobre 2026