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 XBOX services, consultez Configuration de service. Pour une introduction à Data Platform 2013, consultez la rubrique de la 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 précis. 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 de joueur, 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 de chasse en difficulté élevée
  • Nombre le plus élevé d’ennemis vaincus dans une partie
  • Temps le plus rapide pour terminer une course
  • Nom de la voiture conduite le plus récemment
Les statistiques de joueur peuvent être affichées dans l’interface utilisateur du hub de jeu du joueur en tant que statistiques en vedette ou principales, affichées dans les classements et utilisées pour déverrouiller des succès. Les règles de statistiques individuelles peuvent être configurées pour produire l’un des éléments suivants :
  • Une seule instance d’une statistique de joueur
  • Plusieurs instances d’une statistique de joueur fondée sur un modèle de statistique
Pour plus d’information sur les statistiques et les règles de statistiques, consultez les rubriques suivantes de la documentation de la 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 qui mettent à jour des instances de statistiques. Flux d'événements

Configurer une règle de statistique

1

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

Connectez-vous avec votre compte dans 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 vers Stat rules.

Sélectionnez le lien vers Stat rules.
4

Dans la page Events and stat rules, configurez les événements et les règl...

Dans la page Events and stat rules, configurez les événements et les règles de statistiques fondées sur ces événements.
Comme les règles de statistiques sont fondé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. Dans la page Events & Stat Rules, sélectionnez New stat rule.
  2. Dans la boîte de dialogue Add Stat Rule, indiquez 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 dans le cadre de 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 façon. Les champs sélectionnés sont ajoutés au nom racine de la règle de statistique et séparés par le caractère point.
      • Pour supprimer un champ, sélectionnez le X à côté de son nom.
    • Stat Rule Name
      Indiquez un nom qui caractérise la règle de statistique et dont vous vous souviendrez et que vous reconnaîtrez facilement. Les noms des règles de statistiques sont composés d’un nom racine, éventuellement suivi d’un ou de plusieurs champs séparés par le caractère point. Pour connaître les exigences d’attribution de noms des règles de statistiques, consultez la rubrique de la XDK User Stat Rules.
    • Operator
      Sélectionnez l’un des opérateurs suivants.
      • Sum
        Incrémente la valeur existante de la statistique de la valeur indiquée dans le champ Parameter.
      • Min
        Utilise la valeur minimale entre la valeur existante de la statistique et la valeur du champ Parameter.
      • Max
        Utilise la valeur maximale entre la valeur existante de la statistique et la valeur du champ Parameter.
      • Replace
        Remplace la valeur de la statistique par la valeur indiquée dans le champ Parameter. Nous ne recommandons pas d’utiliser l’opérateur Replace pour les statistiques qui alimentent des succès. Les événements ne sont pas toujours traités dans l’ordre, ce qui pourrait empêcher un succès de se déverrouiller. Utilisez plutôt l’opérateur SUM.
    • Parameter
      Indiquez la valeur à utiliser dans l’opérateur sélectionné dans le champ Operator.
      • Si vous voulez utiliser un nombre statique que vous indiquez, sélectionnez l’option literal, puis indiquez la valeur dans la zone sous l’option.
      • Si vous voulez utiliser la valeur d’un champ, sélectionnez l’option field et, dans la liste déroulante 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 au moyen de l’API de serveur à serveur, et non par des clients de jeu exécutés sur la console ou le PC.
  3. Après avoir configuré tous les champs et toutes les valeurs, sélectionnez Save, puis fermez la boîte de dialogue.
Votre nouvelle règle de statistique figure maintenant dans 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 pour 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 voulez 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éordonné. 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 dans le cadre 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 pour un événement de ce titre ne peuvent plus être modifiées ni supprimées.
  1. Dans la page Events and stat rules de l’instance de produit, trouvez la ligne contenant la règle de statistique que vous voulez 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 pour 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 permanente qui ne peut pas être annulée ni inversée.
  • La suppression d’une règle de statistique supprime toutes les dépendances en chaîne qu’elle pourrait avoir. Avant de supprimer une règle de statistique, assurez-vous de vouloir aussi supprimer toutes ses dépendances.
  1. Dans la page Events and stat rules de l’instance de produit, trouvez la ligne contenant la règle de statistique que vous voulez supprimer.
  2. Sélectionnez Delete dans la colonne Actions de cette ligne.
  3. Sélectionnez Delete dans la boîte de dialogue Confirmation.
Suppression d'un événement avec dépendances
Dernière modification le 6 octobre 2026