> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration dans le portail des statistiques basées sur les événements

> Ajoutez, modifiez, copiez et supprimez des règles de statistiques XBOX Live basées sur les événements dans Partner Center afin que les événements de jeu mettent à jour les statistiques des joueurs et alimentent les classements.

<a id="top" />

<Note>
  Cette rubrique décrit des fonctionnalités disponibles uniquement avec les autorisations appropriées. Pour plus d'informations, contactez votre gestionnaire de compte ou un autre contact chez Microsoft.
</Note>

Cette rubrique décrit les procédures d'ajout et de modification de règles de statistiques dans la configuration de service de Partner Center pour un titre. Les statistiques de joueur sont créées et mises à jour selon les règles de statistiques déclenchées lorsqu'un jeu envoie des événements aux services XBOX.

Pour une présentation de la configuration des services XBOX, consultez [Vue d'ensemble de la configuration dans le portail](/fr/services/xbox-services/fundamentals/portal-config/live-portal-config-overview).

Pour une présentation de la plateforme de données 2013, consultez [Vue d'ensemble des données de joueur basées sur les événements](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/live-how-data-platform-works).

Cette rubrique couvre les points suivants :

* [Qu'est-ce qu'une règle de statistique ?](#ID4EMB)
* [Préparer la configuration d'une règle de statistique](#ID4ENC)
* [Créer une règle de statistique](#ID4ELC)
* [Modifier une règle de statistique existante](#ID4E2C)
* [Éditer une règle de statistique](#ID4ELE)
* [Copier une règle de statistique existante](#ID4EMS)
* [Supprimer une règle de statistique existante](#ID4EMF)

<a id="ID4EMB" />

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

Les *règles de statistiques* sont déclenchées lorsqu'un événement portant un nom particulier est reçu par le service de la plateforme de données XBOX. 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.

Les statistiques de joueur sont définies par le développeur, calculées par le service de la plateforme de données des services XBOX et 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é élevée
* Nombre le plus élevé d'ennemis vaincus au cours d'un match
* Temps le plus rapide pour terminer une course
* Nom de la dernière voiture conduite

Les statistiques de joueur peuvent être affichées dans l'interface du hub de jeu du joueur en tant que statistiques mises en avant ou statistiques principales, affichées dans des 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 instance unique d'une statistique de joueur
* Plusieurs instances d'une statistique de joueur basées sur un modèle de statistique

Pour plus d'informations sur les statistiques et les règles de statistiques, consultez les rubriques suivantes.

* [Vue d'ensemble des statistiques basées sur les événements](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview)
* [Vue d'ensemble des règles de statistiques basées sur les événements](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-user-stat-rules)
* [Scénarios de statistiques utilisateur](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-user-stats-scenarios)

Le diagramme suivant montre le flux d'un événement qui déclenche des règles de statistiques mettant à jour des instances de statistiques.

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/event-stat-rule-instance-template.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=6f4d1a70d3fd9a0695069b7bd042f138" alt="Image d'un diagramme qui montre le flux d'un événement qui déclenche des règles de statistiques mettant à jour des instances de statistiques." width="800" height="450" data-path="images/gdk/services/event-stat-rule-instance-template.png" />

[Retour en haut de cette rubrique.](#top)

<a id="ID4ENC" />

## Préparer la configuration d'une règle de statistique

**Prérequis :** Comme les règles de statistiques reposent sur des événements, vous devez créer un événement avant de pouvoir créer une règle de statistique. Pour plus d'informations, consultez [Configuration des événements dans le portail](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/events/config/live-events-portal).

1. Connectez-vous à votre compte sur [Partner Center](https://partner.microsoft.com/dashboard/). La page **Overview** s'affiche avec une liste de produits.

2. Recherchez et sélectionnez votre titre. La page **Game overview** s'affiche, comme illustré ci-dessous.

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-product2013-gameoverview.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=ca66802159931973825dcdda5a0c5415" alt="Capture d'écran de la page Game overview dans Partner Center." width="800" height="448" data-path="images/gdk/services/pctr-product2013-gameoverview.png" />

3. Dans le volet de navigation de gauche à fond gris, sélectionnez **XBOX Live** pour le développer, puis sélectionnez **Gameplay settings**. La page **Gameplay Setting** s'affiche, comme illustré ci-dessous.

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-gameplay-setting-page.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=e4039ad49909a9898ad54d538fe56e70" alt="Capture d'écran de la page Gameplay Setting dans Partner Center." width="800" height="479" data-path="images/gdk/services/pctr-gameplay-setting-page.png" />

4. En haut de la page, sélectionnez le menu **Player stats**, puis sélectionnez **Stat rules**, comme illustré ci-dessous.
   Dans cette interface de Partner Center, « player stats » signifie « statistiques utilisateur basées sur les événements ».

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-stat-rules-menu.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=c34c095faeb6de3c53d98309df1aaa26" alt="Capture d'écran du menu Player stats dans Partner Center." width="800" height="482" data-path="images/gdk/services/pctr-stat-rules-menu.png" />

   Sur la page **Gameplay Setting**, la page **Events and stat rules** s'affiche, comme illustré ci-dessous.

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-events-and-stat-rules-page.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=7011f4c8333bfef7d5b9ec476aa087ec" alt="Capture d'écran de la page Events and stat rules dans Partner Center." width="800" height="532" data-path="images/gdk/services/pctr-events-and-stat-rules-page.png" />

   Au départ, le tableau situé en bas de la page est vide : « No player stats configured ».

5. Sur la page **Events and stat rules**, configurez les événements et les règles de statistiques basées sur ces événements. Pour plus de détails, consultez les sections suivantes.

[Retour en haut de cette rubrique.](#top)

<a id="ID4ELC" />

## Créer une règle de statistique

**Prérequis :** Les règles de statistiques reposent sur des événements. Par conséquent, vous devez créer un événement avant de pouvoir créer une règle de statistique. Pour plus d'informations, consultez [Configuration des événements dans le portail](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/events/config/live-events-portal).

1. Accédez à la page **Events and stat rules** comme décrit dans la section précédente.

2. Dans une ligne d'événement, dans la colonne **Actions** à droite, sélectionnez le bouton de points de suspension (...), puis sélectionnez **New stat rule**, comme illustré ci-dessous.

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/new-stat-rule-menuitem.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=109ee57f08b99f317c6eb2f71a6d336b" alt="Capture d'écran de la sélection d'un événement pour créer une règle de statistique dans Partner Center." width="828" height="650" data-path="images/gdk/services/new-stat-rule-menuitem.png" />

   La boîte de dialogue **Add stat rule** s'affiche, comme illustré ci-dessous.

   <img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/add-stat-rule-dbox.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=469b04002c0bf6b93cb05e148e490256" alt="Capture d'écran de la boîte de dialogue Add stat rule dans Partner Center." width="699" height="881" data-path="images/gdk/services/add-stat-rule-dbox.png" />

   * **Event fields added to the stat rule**
     * Utilisez ce champ facultatif pour sélectionner les champs de l'événement de base inclus dans 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** à côté de son nom.

   * **Stat rule name**
     Spécifiez un nom qui caractérise la règle de statistique et que vous pouvez facilement mémoriser et reconnaître. Les noms des règles de statistiques se composent d'un nom *racine*, éventuellement suivi d'un ou de plusieurs *champs* séparés par le caractère point (.). Pour plus d'informations sur les exigences de nommage des règles de statistiques, consultez [Vue d'ensemble des règles de statistiques basées sur les événements](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-user-stat-rules).

   * **Operator**
     Sélectionnez l'un des opérateurs suivants.

     * **Sum**
       Incrémente la valeur existante de la statistique de la valeur spécifiée dans le champ **Parameter**.

     * **Min**
       Utilise le minimum entre la valeur existante de la statistique et la valeur du champ **Parameter**.

     * **Max**
       Utilise le maximum entre la valeur existante de la statistique et la valeur du champ **Parameter**.

     * **Replace**
       Remplace la valeur de la statistique par la valeur spécifiée dans le champ **Parameter**.

       Cette option est principalement destinée aux chaînes, et nous déconseillons 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, et cet opérateur peut empêcher un succès de se déverrouiller. Utilisez plutôt l'opérateur **SUM**.

       Pour cette raison, lorsque l'option **Replace** est utilisée, la règle de statistique correspondante est marquée comme *Deprecated* dans l'interface de Partner Center.

   * **Parameter**
     Spécifiez la valeur à utiliser avec l'opérateur sélectionné dans le champ **Operator**.

     * Si vous souhaitez utiliser un nombre statique que vous spécifiez, sélectionnez le bouton d'option **literal** et spécifiez la valeur dans la zone qui suit le bouton d'option.

     * Si vous souhaitez utiliser la valeur d'un champ, sélectionnez le bouton d'option **field** et, dans la liste déroulante qui suit le bouton d'option, sélectionnez le champ que vous souhaitez 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 n'est déclenchée que 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.

Votre nouvelle règle de statistique apparaît désormais sur la page **Events & Stat Rules** chaque fois que l'événement de la règle est sélectionné.

[Retour en haut de cette rubrique.](#top)

<a id="ID4E2C" />

## Modifier une règle de statistique existante

<Info>
  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.
</Info>

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. Effectuez les modifications dans la boîte de dialogue **Update stat rule** de l'événement.

3. Sélectionnez **Save**.

[Retour en haut de cette rubrique.](#top)

<a id="ID4ELE" />

## É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 puis la création d'une nouvelle règle de statistique. Selon cette définition, toutes les instances de statistiques sont supprimées lors de l'édition.

[Retour en haut de cette rubrique.](#top)

<a id="ID4EMS" />

## Copier une règle de statistique existante

<Info>
  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.
</Info>

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. Effectuez vos modifications dans la boîte de dialogue **Update stat rule** de l'événement.

4. Sélectionnez **Save**.

[Retour en haut de cette rubrique.](#top)

<a id="ID4EMF" />

## Supprimer une règle de statistique existante

<Info>
  * 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 chaînées qu'elle peut avoir. Avant de supprimer une règle de statistique, assurez-vous de vouloir également supprimer toutes ses dépendances.
</Info>

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**.

Le diagramme suivant montre que la suppression d'une règle d'événement de statistique supprime toutes les dépendances de cette règle.

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/event_delete_dependency.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=c62fbfb172b5b3ea07af12d6aca27bf6" alt="Image d'un diagramme qui montre que la suppression d'une règle de statistique supprime toutes les dépendances de cette règle." width="624" height="297" data-path="images/gdk/services/event_delete_dependency.png" />

[Retour en haut de cette rubrique.](#top)


## Related topics

- [Configuration dans le portail des statistiques mises en avant basées sur les événements](/fr/services/xbox-services/player-data/stats-leaderboards/featured-stats/config/live-featuredstats-eb-portal.md)
- [Configuration dans le portail des statistiques et classements basés sur les événements](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-statslb-eb-config-nav.md)
- [Configuration des événements dans le portail](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/events/config/live-events-portal.md)
- [Configuration](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/config/index.md)
- [Programmation du service RTA](/fr/services/xbox-services/fundamentals/rta/how-to/live-programming-rta.md)
