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

# Vue d'ensemble des règles de statistique basées sur les événements

> Fonctionnement des règles de statistiques utilisateur XBOX Live basées sur les événements, notamment les événements producteurs, le nommage, les opérateurs, les paramètres et les modèles de statistique pour les statistiques de joueur.

Cette rubrique décrit le fonctionnement des règles de statistiques utilisateur. Elles sont utilisées pour les statistiques basées sur les événements, et non pour les statistiques gérées par le titre.

Chaque règle de statistique comporte quatre parties.

* L'événement producteur
* Le nom
* Un opérateur
* Un paramètre

## Événement

Chaque règle de statistique est déclenchée par un nom d'événement spécifique journalisé par le titre. Notez que plusieurs règles de statistique peuvent être déclenchées par un seul événement.

## Exigences de nommage

* Un nom de règle comporte un nom « racine ». Il est éventuellement suivi d'un ou plusieurs « champs ».

* La *racine* est une chaîne alphanumérique. Elle peut contenir jusqu'à 32 caractères.

* La longueur totale du nom de l'instance de statistique ne doit pas dépasser 128 caractères.

* Le nom doit commencer par une lettre et ne doit contenir que des lettres, des chiffres et le caractère trait d'union (-). Les espaces, virgules, points, traits de soulignement et tout autre caractère spécial ne sont pas autorisés. Voici quelques exemples de noms : "EnemiesDefeated", "BestScoreUnder2Minutes" et "Total-Collectibles-Jewels".

* Les champs sont séparés par le caractère point (.).

* Les noms de champs doivent correspondre exactement aux noms de champs qui font partie de l'événement producteur.

<Info>Lorsqu'un ou plusieurs champs sont inclus dans le nom de la règle de statistique, cette règle devient un modèle de statistique. Au moment de l'exécution, la valeur réelle des champs de l'événement producteur est insérée dans le nom de l'instance de statistique.</Info>

* Voici quelques exemples de noms de modèles valides : "EnemiesDefeated.WeaponID", "BestScoreUnder2Minutes.TrackId.DifficultyID" et "Total-Collectibles-Jewels.Found".

* Voici quelques exemples de noms d'instances valides : "EnemiesDefeated.WeaponID.17", "BestScoreUnder2Minutes.TrackId.40.DifficultyID.Insane" et "Total-Collectibles-Jewels.Found.1".

## Recommandations relatives aux types de données

* Nous vous recommandons d'utiliser le type de données entier pour les champs d'événement qui font partie d'un nom de modèle de statistique.

* Si le type de données du champ d'événement est booléen, la valeur insérée est "1" pour `true` et "0" pour `false`.

* Si le type de données du champ d'événement est une chaîne Unicode, vous devez vous assurer que les valeurs possibles de ce champ ne contiennent que des caractères valides (comme décrit précédemment).

## Opérateur

La valeur de l'instance de statistique est calculée au moment de l'exécution, lors du traitement de l'événement producteur. La règle de statistique exécute une *opération* avec le *paramètre* spécifié. Les opérations prises en charge sont les suivantes.

* `SUM`
* `MAX`
* `MIN`
* `REPLACE`

## Paramètre

Le paramètre peut être une valeur constante ou un nom de champ de l'événement producteur, comme indiqué dans le tableau suivant.

| Opérateur | Paramètre |
| - | - |
| `SUM` | Constante ou champ |
| `MIN` | Champ |
| `MAX` | Champ |
| `REPLACE` | Constante ou champ |

Le type de données de l'instance de statistique obtenue est déterminé par le type de données du paramètre.

Les types de données Integer, Float et Boolean sont pris en charge par tous les opérateurs.

Le type de données chaîne Unicode n'est pris en charge que par l'opérateur `REPLACE`.

Les types de données des statistiques et des paramètres sont indiqués dans le tableau suivant.

\| Type de données de la statistique | Type de données du paramètre | Remarques |
\| --- | --- |
\| Integer | Int32, Int64, UInt32, UInt64, Boolean | La plus grande valeur entière prise en charge est sur 56 bits. Boolean est converti de `TRUE` en 1 et de `FALSE` en 0. |
\| Float | Float, Double | Float 64 bits. |
\| String | UnicodeString, GUID | La longueur maximale de la chaîne est de 50 caractères. |


## Related topics

- [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.md)
- [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.md)
- [Configuration dans le portail des statistiques basées sur les événements](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-eb-portal.md)
- [Vue d'ensemble des succès basés sur les événements](/fr/services/xbox-services/player-data/achievements/event-based/live-achievements-eb-overview.md)
- [Premier aperçu des statistiques basées sur les événements](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-first-glance.md)
