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

# Ajout d'une valeur de champ à une règle de statistique

> Conseils sur l'utilisation des noms de champs d'événement plutôt que des valeurs de champs dans les modèles de règles de statistique XBOX Live basées sur les événements, afin d'éviter des instances de statistique non souhaitées.

Cette rubrique explique pourquoi vous devez généralement ajouter un nom de champ, plutôt qu'une valeur de champ, à une règle de statistique.

## La valeur de l'événement est ajoutée au nom de la statistique

Les modèles de statistique sont puissants et flexibles, mais ils peuvent parfois produire des résultats inattendus s'ils ne sont pas correctement configurés. Les modèles de statistique créent des chemins de statistique variables, ou instances de statistique. Les modèles de statistique produisent des noms de statistique basés sur des variables dérivées du nom *et de la valeur* des champs sélectionnés dans l'événement source.
C'est ainsi que vous pouvez capturer, par exemple, *la quantité* d'or gagnée par un joueur sur chaque carte.

Non seulement les *noms* des événements sont ajoutés au nom de la statistique, mais leurs *valeurs* le sont aussi. Cela peut souvent entraîner de la confusion et des résultats non souhaités.

## Exemple d'une règle de statistique unique

Supposons que votre jeu envoie un événement nommé `GameEnd`. Il possède un champ `int` nommé `Map` et un champ `int` nommé `Gold`.

Pour capturer le meilleur score par carte à l'aide d'une règle de statistique unique, vous donneriez un nom à la statistique, par exemple `GoldByMap`, et ajouteriez un champ `Map` à la règle de statistique. Dans cet exemple, la valeur `Map` est un ID numérique.

Votre paramètre (le champ qui contient la valeur dont vous voulez incrémenter la statistique) serait le champ `Gold` de l'événement `GameEnd`.

Supposons que votre jeu envoie un événement `GameEnd` aux services XBOX. La valeur du champ `Map` de l'événement est 1. La valeur du champ `Gold` est 100.
Le résultat est que la statistique est écrite dans le chemin de statistique : `GoldByMap.Map.1`. La nouvelle valeur de ce chemin de statistique est 100.

Le tableau suivant récapitule ce que nous avons jusqu'à présent.

| Élément | Type | Remarques |
| - | - | - |
| `GameEnd` | Un événement | Envoyé par votre jeu aux services XBOX |
| `Map` | Un champ de l'événement | Un `int` |
| 1 | `int` | La valeur du champ `Map` |
| `Gold` | Un champ de l'événement | Un `int` |
| 100 | `int` | La valeur du champ `Gold` |

Le chemin de statistique comporte les parties indiquées dans le tableau suivant.

| Élément | Type | Remarques |
| - | - | - |
| `GoldByMap.Map.1` | Un chemin de statistique | La valeur de ce chemin de statistique est 100. |
| `GoldByMap` | Un nom de statistique | N/A. |
| `Map` | Une règle de statistique | Un ID numérique. |

Si l'événement suivant arrive avec une valeur `Map` de 2, le champ `Gold` de cet événement est ajouté à ce nouveau chemin de statistique : `GoldByMap.Map.2`.

Supposons que le champ `Gold` de l'événement ait la valeur 200.
Nous aurions alors aussi ce qui figure dans le tableau suivant.

| Élément | Type | Remarques |
| - | - | - |
| `GoldByMap.Map.2` | Un chemin de statistique | La valeur de ce chemin de statistique est 200. |

Ainsi, vous pouvez garder les valeurs des statistiques séparées, sans avoir à définir une statistique pour chaque `Map`.

## Exemple d'ajout par erreur d'un nom de champ plutôt que d'une valeur de champ à la règle de statistique

En reprenant l'exemple précédent, voyons quels mauvais résultats se produisent lorsque vous ajoutez aussi le nom de champ `Gold` à la règle de statistique `Map`, au lieu d'ajouter uniquement la valeur du paramètre `Gold`. Cela donnerait le nom de statistique suivant : `GoldByMap.Map.1.Gold.100`.

Notez que la quantité d'or gagnée par le joueur (100) figure aussi dans le nom de la statistique.
Cela signifie qu'un joueur qui gagne 100 pièces d'or sur la carte 1 obtiendra une valeur de 100 pour cette statistique : `GoldByMap.Map.1.Gold.100`.

Si un joueur gagnait 101 pièces d'or sur cette carte, cette configuration produirait le résultat suivant, qui est un nom de statistique différent : `GoldByMap.Map.1.Gold.101`. Par conséquent, ces statistiques ne s'incrémenteraient que lorsque le joueur gagne la quantité exacte d'or définie dans le nom de la statistique, ce qui n'est probablement pas l'effet recherché.


## Related topics

- [Configuration dans le portail des statistiques et classements basés sur les événements](/fr-CA/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-statslb-eb-config-nav.md)
- [Configuration](/fr-CA/services/xbox-services/player-data/stats-leaderboards/event-based/config/index.md)
- [Configurer les statistiques et les règles de statistiques XBOX dans Partner Center](/fr-CA/publishing/game-publishing/how-to/data-platform-2013/how-to-configure-stats.md)
- [Utilisation d'une règle pour vérifier une adresse courriel de contact](/fr-CA/services/playfab/live-service-management/game-configuration/title-communications/emails/using-a-rule-to-verify-a-contact-email-address.md)
- [Configuration dans le portail des statistiques basées sur les événements](/fr-CA/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-eb-portal.md)
