> ## 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.
# Utilisation des tables de prix
> Créez des tables de prix PlayFab qui accordent de la monnaie virtuelle, des objets d'inventaire, des notifications Push ou des actions CloudScript aux meilleurs rangs lors de la réinitialisation d'un classement.
Ce tutoriel vous explique comment créer une table de prix qui déclenche un ensemble d'actions sur un groupe de joueurs situés dans une plage de rangs, dans un [classement réinitialisable](/fr-CA/services/playfab/community/leaderboards/tournaments-leaderboards/using-resettable-statistics-and-leaderboards).
Plus précisément, c'est une façon de déclencher l'envoi de courriels, d'envoyer des notifications Push, d'accorder des [objets d'inventaire](/fr-CA/services/playfab/player-progression/player-data/player-inventory) et de la [monnaie virtuelle](/fr-CA/services/playfab/economy-monetization/economy/tutorials/currencies), ou d'exécuter une fonction [CloudScript](/fr-CA/services/playfab/live-service-management/service-gateway/automation/cloudscript/writing-custom-cloudscript) lors de la réinitialisation d'un classement.
Dans cet exemple, nous vous montrons comment créer une table de prix de fin de tournoi, qui accorde de la monnaie virtuelle à 5 joueurs en fonction de leur rang dans un classement après une réinitialisation.
## Exigences
Il s'agit d'un tutoriel *avancé*. Assurez-vous que toutes les exigences ci-dessous sont remplies, sinon vous ne pourrez *pas* terminer ce tutoriel.
* Une connaissance de base de la création d'un joueur sera nécessaire, car il faudra des joueurs dans un classement avant qu'il puisse effectuer des actions sur ces joueurs.
* Il vaut également la peine de lire le [démarrage rapide de Game Manager](/fr-CA/services/playfab/live-service-management/gamemanager/quickstart) si vous ne connaissez pas Game Manager, car c'est là que les tables de prix sont créées.
* Pour utiliser les tables de prix, vous devez avoir une connaissance générale du fonctionnement des classements réinitialisables. Renseignez-vous sur les classements dans notre tutoriel [Utilisation des statistiques et des classements réinitialisables](/fr-CA/services/playfab/community/leaderboards/tournaments-leaderboards/using-resettable-statistics-and-leaderboards).
* De plus, des monnaies virtuelles doivent être configurées. Lisez notre tutoriel sur les [monnaies](/fr-CA/services/playfab/economy-monetization/economy/tutorials/currencies) et configurez deux monnaies avec les paramètres suivants :
* **Code de monnaie** : GO
* **Nom d'affichage** : Gold
* **Dépôt initial** : 200
* **Code de monnaie** : SI
* **Nom d'affichage** : Silver
* **Dépôt initial** : 1000
## Étape 1 - Créer un classement
Dans Game Manager :
* Accédez à **Leaderboards** dans le menu de gauche.
* Sélectionnez **New Leaderboard**.
* Ajoutez un **Leaderboard** appelé **tournamentScore\_manual** dans le champ **Statistic name**.
* À l'aide du menu déroulant fourni, définissez le champ **Reset frequency** à **Manually**.
* Passez au champ **Aggregation method** et sélectionnez **Maximum (always use the highest value)** dans le menu déroulant fourni.
## Étape 2 - Créer une table de prix pour le classement
Maintenant qu'un classement a été créé, une table de prix peut y être associée. Accédez à :
* **Leaderboards** dans le menu de gauche.
* Sélectionnez l'onglet **Prize Tables**.
* Sélectionnez le bouton **NEW PRIZE TABLE** pour accéder à la vue **New Prize Table**.
Dans la vue **New Prize Table** :
* Passez à la zone **INFO** et entrez le **Name** de la **New Prize Table**, intitulée **End Tournament Prizes**.
* Choisissez **tournamentScore\_manual** dans le menu déroulant **Leaderboard**.
Pour que cette table de prix effectue une action, des rangs devront être définis. Pour ce faire :
* Sélectionnez **+ ADD RANK** sous la section **TABLE CONTENTS**.
* Un formulaire **Rank** s'affichera.
Dans le formulaire **Rank** :
* Vérifiez que le champ **Rank from** a la valeur **1**.
* Vérifiez que le champ **To (inclusive)** a la valeur **2**.
* Dans le menu déroulant **Type**, choisissez **Grant virtual currency**.
* Dans le menu déroulant **virtual currency code**, choisissez **GO (Gold)** avec un montant de **10**.
Nous allons maintenant ajouter une deuxième plage de rangs :
* Sélectionnez **+ADD RANK** sous la section **TABLE CONTENTS** (il y en a aussi un *deuxième* en bas, qui fonctionne également).
* Dans le formulaire **Rank** qui s'affiche, assurez-vous que le champ **Rank from** a la valeur **3** et que le champ **To (inclusive)** a la valeur **5**.
* Dans le menu déroulant **Virtual currency code**, choisissez **SI** (**Silver**) avec un montant de **10**.
## Étape 3 - Remplir le classement avec un joueur
Un classement et une table de prix associée ont maintenant été créés. L'étape suivante consiste à remplir le classement avec des joueurs.
Pour créer des joueurs, nous utiliserons [LoginWithCustomID](xref:titleid.playfabapi.com.client.authentication.loginwithcustomid). Ensuite, nous utiliserons ces joueurs pour remplir le classement avec [UpdatePlayerStatistics](xref:titleid.playfabapi.com.client.playerdatamanagement.updateplayerstatistics).
Avant de pouvoir utiliser [UpdatePlayerStatistics](xref:titleid.playfabapi.com.client.playerdatamanagement.updateplayerstatistics), nous devons l'activer dans API Features.
* Sélectionnez **Settings** dans le menu de gauche.
* Sélectionnez l'onglet **API Features**.
* Cochez la case **Allow client to post player statistics**.
* Sélectionnez ensuite le bouton **SAVE API FEATURES** au bas de l'écran.
### Exemple de code C\#
L'exemple de code **C#** suivant crée 5 joueurs et les connecte à l'aide de [LoginWithCustomID](xref:titleid.playfabapi.com.client.authentication.loginwithcustomid).
Il remplit ensuite le classement que vous avez créé précédemment (`tournamentScore_manual`) avec les 5 joueurs, avec les valeurs **105**, **104**, **103**, **102** et **101**, à l'aide de [UpdatePlayerStatistics](xref:titleid.playfabapi.com.client.playerdatamanagement.updateplayerstatistics).
```csharp theme={null}
// Note: This is a recursive function. Invoke it initially with no parameter
public void CreatePlayerAndPopulateLeaderboard(int playerIndex = 5) {
if (playerIndex <= 0) return;
const string leaderboardName = "tournamentScore_manual";
PlayFabClientAPI.LoginWithCustomID(new LoginWithCustomIDRequest {
CustomId = playerIndex.ToString(),
CreateAccount = true
}, result => OnLoggedIn(result,playerIndex,leaderboardName), FailureCallback);
}
private void OnLoggedIn(LoginResult loginResult, int playerIndex, string leaderboardName) {
Debug.Log("Player has successfully logged in with " + loginResult.PlayFabId);
PlayFabClientAPI.UpdatePlayerStatistics(new UpdatePlayerStatisticsRequest {
Statistics = new List {
new StatisticUpdate {
StatisticName = leaderboardName,
Value = playerIndex + 100
}
}
}, result=> OnStatisticsUpdated(result,playerIndex), FailureCallback);
}
private void OnStatisticsUpdated(UpdatePlayerStatisticsResult updateResult, int playerIndex) {
Debug.Log("Successfully updated player statistic");
// Recursively invoke for next player
CreatePlayerAndPopulateLeaderboard(playerIndex - 1);
}
private void FailureCallback(PlayFabError error){
Debug.LogWarning("Something went wrong with your API call. Here's some debug information:");
Debug.LogError(error.GenerateErrorReport());
}
```
### Vérifier les résultats de l'exemple de code C\#
Pour vérifier que 5 joueurs figurent dans le classement avec les bonnes valeurs :
* Sélectionnez **Leaderboards** dans le menu de gauche.
* Dans l'onglet **Leaderboards**, revenez à la vue de liste **Leaderboard**.
* Sélectionnez **tournamentScore\_manual**; il devrait y avoir 5 **joueurs** avec les valeurs **105**, **104**, **103**, **102** et **101**.
## Étape 4 - Vérifier les monnaies initiales des joueurs
Avant de vérifier quoi que ce soit :
* Revenez à **Players** dans le menu de gauche de l'étape 2.
* Accédez à l'onglet **Players** et trouvez un joueur qui a été ajouté au **Leaderboard** **tournamentScore\_manual** à l'étape 3.
* Sélectionnez le **Player ID**, puis l'onglet **Virtual Currency** de ce joueur.
* Notez les valeurs des **monnaies** **GO** (**Gold**) et **SI** (**Silver**) de ce joueur.
Avant de vérifier quoi que ce soit, revenez aux **joueurs** de test de l'étape 2.
* Accédez à **Players** et trouvez-en un qui a été ajouté au **Leaderboard tournamentScore\_manual** à l'étape 3.
* Sélectionnez le **Player ID**, puis l'onglet **Virtual Currency** de ce joueur.
* Notez les valeurs des monnaies **GO** (**Gold**) et **SI** (**Silver**) de ce joueur.
* Faites maintenant de même pour les 4 autres joueurs sur 5 qui ont été ajoutés au **Leaderboard tournamentScore\_manual** à l'étape 3.
* Assurez-vous de noter les valeurs de leurs monnaies **GO** (**Gold**) et **SI** (**Silver**) (elles seront importantes pour confirmer que la table de prix a fonctionné après la réinitialisation).
## Étape 5 - Réinitialiser le classement pour accorder les récompenses
Accédez maintenant à **Leaderboards**.
* Revenez à la vue de liste **Leaderboards**.
* Sélectionnez **tournamentScore\_manual**.
* Notez les positions des **joueurs** dans le **Leaderboard** (elles sont *indexées à partir de zéro*, donc la position **0** correspond à la *première place*).
* Sélectionnez le bouton **RESET NOW**.
* Sélectionnez le bouton **RESET** pour confirmer la réinitialisation du **Leaderboard**
* Cela effacera la liste des **joueurs**.
* Sélectionnez le bouton **RESET NOW** en haut de l'écran.
* Lorsque le message **Reset this Leaderboard now?** s'affiche, sélectionnez le bouton **RESET** pour confirmer la réinitialisation.
* Cela effacera la liste des **joueurs**.
## Étape 6 - Vérifier que la table de prix fonctionne
Pour savoir si la table de prix a fonctionné, vous pouvez vérifier si les joueurs du classement ont reçu les bons montants de monnaie. Cela peut être rapidement vu dans le débogueur PlayStream d'un joueur.
Pour le voir dans le débogueur PlayStream :
* Sélectionnez **Players** dans le menu de gauche.
* L'onglet **PlayStream** affichera un événement de classement d'un **joueur** dans un **Leaderboard**, suivi d'une mise à jour de la **monnaie virtuelle**.
Vérifions maintenant manuellement si les joueurs ont reçu les bonnes monnaies :
* Sélectionnez **Players** dans le menu de gauche.
* Dans l'onglet **Players**, passez à la zone **Virtual Currency** de l'écran.
* Vérifiez que la monnaie a été accordée correctement.
* Le montant devrait être *supérieur* à celui noté précédemment.
* Remarquez que les **joueurs** aux positions **0** ou **1** du classement ont reçu **10 gold**, *sans aucun silver*.
* Pendant ce temps, les **joueurs** aux positions **2**, **3** et **4** ont reçu **10 silver** et *aucun gold*.
* Cela correspond aux actions configurées pour la table de prix.
Une autre façon de vérifier que la **monnaie virtuelle** a été accordée correctement :
* Accédez à **Players**.
* Consultez l'**Event History**.
* Un événement **player\_virtual\_currency\_balance\_changed** s'affichera, avec des détails précis sur les montants modifiés pour la **monnaie virtuelle** accordée.
## Related topics
- [Comment modifier les prix](/fr-CA/publishing/game-publishing/how-to/how-to-priceupdate.md)
- [Configurer les prix et la disponibilité d'un jeu](/fr-CA/publishing/game-publishing/tutorial-xbox-managed/how-to-configure-pricing-and-availability.md)
- [Utilisation de l'inventaire des joueurs](/fr-CA/services/playfab/player-progression/player-data/player-inventory.md)
- [Tables de butin dans Economy (hérité)](/fr-CA/services/playfab/economy-monetization/economy/tutorials/drop-tables.md)
- [Prix de solde](/fr-CA/publishing/game-publishing/concepts/availability/sale-pricing.md)