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

# Scénarios de statistiques utilisateur

> Scénarios courants de statistiques utilisateur XBOX Live pour les statistiques basées sur les événements, notamment les indicateurs booléens, les compteurs cumulatifs, les records personnels et les valeurs les plus récentes.

<a id="top" />

Cette rubrique couvre les scénarios courants suivants de création de statistiques utilisateur lorsque vous utilisez des statistiques basées sur les événements.

* [Utiliser des valeurs booléennes pour des conditions](#ubvfc)

* [Utiliser des compteurs pour des valeurs cumulatives](#ucfcv)

* [Suivre un record personnel](#tapb)

* [Suivre la valeur la plus récente](#ttmr)

<a id="ubvfc" />

## Utiliser des valeurs booléennes pour des conditions

### Objectif : suivre si une condition particulière a été remplie

Utilisez ce modèle lorsque vous souhaitez indiquer si l'utilisateur a rempli une condition spécifique dans la logique du jeu.

### Cas d'usage

* Indiquer si le personnage de l'utilisateur est mort dans un niveau particulier

* Indiquer si l'utilisateur a déverrouillé chaque objet à collectionner spécifique

* Indiquer si l'utilisateur joue actuellement en difficulté extrême

* Indiquer si l'utilisateur a rempli les cinq conditions nécessaires pour déverrouiller un succès complexe

### Exemple : indiquer si l'utilisateur a réalisé 90 éliminations au fusil à pompe ou 10 éliminations au fusil de précision

| Champ | Valeur |
| - | - |
| Nom de l'événement | `AchievementUnlocked` |
| Champs de l'événement | `UnlockId` (type de données : Int32) |
| Nom du modèle de statistique | `AchievementUnlocked.UnlockId` |
| Opérateur | `REPLACE` |
| Paramètre | 1 |
| Accès | `Open` |

### Règles

Appliquez l'opérateur `REPLACE` avec une valeur littérale de « 1 » si l'indicateur doit être lu comme `TRUE`.

Appliquez l'opérateur `SUM` avec une valeur littérale de « 1 » si l'indicateur doit être supérieur ou égal à 1 pour déclencher la logique du jeu.

### Mises en garde

Si nécessaire, initialisez ou réinitialisez la valeur des statistiques booléennes `REPLACE`. Sinon, la dernière valeur définie est conservée.

Dans certains cas, il est pratique de définir un événement qui permet de réinitialiser une statistique booléenne à `FALSE`. Dans ces cas, utilisez une opération `REPLACE` avec une valeur littérale de « 0 ».

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

<a id="ucfcv" />

## Utiliser des compteurs pour des valeurs cumulatives

### Objectif : incrémenter (ou décrémenter) une valeur cumulative globale de l'utilisateur pour une métrique particulière

Utilisez ce modèle lorsque vous souhaitez incrémenter la valeur de la statistique d'une quantité fixe ou variable à chaque traitement de l'événement.

### Cas d'usage

* Niveau du joueur

* Nombre total d'éliminations

* Nombre de vidéos chargées

* Nombre de fois où l'utilisateur a joué sur chaque carte

* Distance cumulée parcourue avec chaque type de véhicule

* Nombre actuel d'objets dans l'inventaire

### Exemple : compteur de matchs multijoueurs gagnés

| Champ | Valeur |
| - | - |
| Nom de l'événement | `MatchCompleted` |
| Champ d'événement 1 | `Result` (type de données : Int32) |
| Champ d'événement 2 | `Mode` (type de données : chaîne Unicode) |
| Nom du modèle de statistique | `MatchesCompleted.Result.Mode` |
| Opérateur | `SUM` |
| Paramètre | 1 |
| Accès | `Open` |

### Règles

Appliquez l'opérateur `SUM` au champ d'événement correspondant ou spécifiez une valeur constante fixe comme paramètre.

Pour décrémenter la valeur de la statistique, utilisez une valeur négative comme paramètre, soit sous forme de constante fixe, soit sous forme de valeur d'exécution dans le champ d'événement.

### Mises en garde

N'utilisez pas de valeurs « littérales » de type chaîne comme paramètres avec l'opérateur `SUM`.

N'appliquez pas l'opérateur `SUM` à un champ d'événement de type chaîne.

Si plusieurs événements mettent à jour la même statistique, assurez-vous que toutes les règles de statistiques qui la mettent à jour utilisent le même opérateur.

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

<a id="tapb" />

## Suivre un record personnel

### Objectif : suivre le « meilleur » score de tous les temps de l'utilisateur pour une métrique particulière

Utilisez ce modèle lorsque vous souhaitez conserver le record le plus élevé (`MAX`) ou le plus faible (`MIN`) de l'utilisateur. Ignorez toutes les valeurs qui n'améliorent pas le record de l'utilisateur.

### Cas d'usage

* Plus longue série d'éliminations

* Plus petit nombre de morts au cours d'une manche multijoueur

* Temps le plus rapide pour terminer chaque circuit

* Plus long drive sur chaque trou de n'importe quel parcours de golf

### Exemple : temps le plus rapide pour terminer n'importe quel circuit de l'ensemble Europe

| Champ | Valeur |
| - | - |
| Nom de l'événement | `TrackCompleted` |
| Champ d'événement 1 | `TrackSet` (type de données : chaîne Unicode) |
| Champ d'événement 2 | `TimeInSeconds` (type de données : Int32) |
| Nom du modèle de statistique | `BestFinishTimeInSeconds.TrackSet` |
| Opérateur | `MIN` |
| Paramètre | `TimeInSeconds` |
| Accès | `Open` |

### Règles

Appliquez l'opérateur `MAX` ou `MIN` au champ d'événement correspondant.

### Mises en garde

N'utilisez pas de valeurs « littérales » comme paramètres avec l'opérateur `MAX` ou `MIN`.

N'appliquez pas l'opérateur `MAX` ou `MIN` à un champ d'événement de type chaîne.

Si plusieurs événements mettent à jour la même statistique, assurez-vous que toutes les règles de statistiques qui la mettent à jour utilisent le même opérateur.

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

<a id="ttmr" />

## Suivre la valeur la plus récente

### Objectif : suivre le score le plus récent enregistré par l'utilisateur pour une métrique particulière

Utilisez ce modèle lorsque vous souhaitez conserver le dernier enregistrement de l'utilisateur, que la valeur améliore ou non son meilleur record.

### Cas d'usage

* Difficulté actuelle

* Nombre de morts au cours de la manche multijoueur actuelle

* Vitesse maximale lors de la course la plus récente sur chaque circuit

* Indicateur booléen d'un club de golf premium actuellement équipé

### Exemple : temps le plus récent pour terminer n'importe quel circuit

| Champ | Valeur |
| - | - |
| Nom de l'événement | `TrackCompleted` |
| Champ d'événement 1 | `TrackId` (type de données : Int32) |
| Champ d'événement 2 | `TimeInSeconds` (type de données : Int32) |
| Nom du modèle de statistique | `BestFinishTimeInSeconds.TrackId` |
| Opérateur | `REPLACE` |
| Paramètre | `TimeInSeconds` |
| Accès | `Open` |

### Règles

Appliquez l'opérateur `REPLACE` au champ d'événement correspondant ou à une valeur littérale.

### Mises en garde

Si nécessaire, initialisez ou réinitialisez la valeur des statistiques `REPLACE`. Sinon, la dernière valeur définie est conservée.

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


## Related topics

- [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 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)
- [Configuration](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/config/index.md)
- [Réinitialiser les statistiques de l'utilisateur](/fr/services/playfab/api-references/rest/admin/player-data-management/reset-user-statistics.md)
- [Scénarios de création de succès basés sur les événements](/fr/services/xbox-services/player-data/achievements/event-based/concepts/live-achievements-scenarios.md)
