> ## 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 attribuent de la monnaie virtuelle, des objets d'inventaire, des notifications Push ou des actions CloudScript aux premiers 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/services/playfab/community/leaderboards/tournaments-leaderboards/using-resettable-statistics-and-leaderboards).
Il s'agit notamment d'un moyen de déclencher des e-mails, d'envoyer des notifications Push, d'attribuer des [objets d'inventaire](/fr/services/playfab/player-progression/player-data/player-inventory) et de la [monnaie virtuelle](/fr/services/playfab/economy-monetization/economy/tutorials/currencies), ou d'exécuter une fonction [CloudScript](/fr/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 attribue de la monnaie virtuelle à 5 joueurs en fonction de leur rang dans un classement après une réinitialisation.
## Configuration requise
Il s'agit d'un tutoriel *avancé*. Assurez-vous que toutes les conditions indiquées ci-dessous sont remplies, sinon vous ne pourrez *pas* terminer ce tutoriel.
* Des connaissances de base sur la création d'un joueur seront nécessaires, car il doit y avoir des joueurs dans un classement avant que celui-ci puisse effectuer des actions sur ces joueurs.
* Il est également utile de lire le [démarrage rapide de Game Manager](/fr/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 des connaissances générales sur le fonctionnement des classements réinitialisables. Consultez les informations sur les classements dans notre tutoriel [Utilisation des statistiques et classements réinitialisables](/fr/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/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** nommé **tournamentScore\_manual** dans le champ **Statistic name**.
* À l'aide du menu déroulant fourni, définissez le champ **Reset frequency** sur **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 lui ê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** :
* Accédez à la zone **INFO** et saisissez 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 doivent être définis. Pour ce faire :
* Sélectionnez **+ ADD RANK** dans la section **TABLE CONTENTS**.
* Un formulaire **Rank** apparaît.
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**.
Ajoutons maintenant une deuxième plage de rangs :
* Sélectionnez **+ADD RANK** dans la section **TABLE CONTENTS** (il en existe également un *deuxième* en bas, qui fonctionne aussi).
* Dans le formulaire **Rank** qui apparaît, 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 la table de prix qui lui est 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). Nous utiliserons ensuite 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** en 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 **Players** avec les valeurs **105**, **104**, **103**, **102** et **101**.
## Étape 4 - Vérifier les monnaies initiales du joueur
Avant toute vérification :
* Revenez à **Players** dans le menu de gauche depuis l'étape 2.
* Accédez à l'onglet **Players** et recherchez un joueur qui a été placé dans le **Leaderboard** **tournamentScore\_manual** à l'étape 3.
* Sélectionnez le **Player ID**, puis l'onglet **Virtual Currency** de ce joueur.
* Notez les valeurs des **Currencies** **GO** (**Gold**) et **SI** (**Silver**) de ce joueur.
Avant toute vérification, revenez aux **Players** de test de l'étape 2.
* Accédez à **Players** et recherchez-en un qui a été placé dans le **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 des 5 joueurs placés dans le **Leaderboard tournamentScore\_manual** à l'étape 3.
* Veillez à 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 attribuer les récompenses
Accédez maintenant à **Leaderboards**.
* Revenez à la vue de liste **Leaderboards**.
* Sélectionnez **tournamentScore\_manual**.
* Notez les positions des **Players** dans le **Leaderboard** (elles sont *indexées à partir de zéro* : la position **0** correspond donc à la *première place*).
* Sélectionnez le bouton **RESET NOW**.
* Sélectionnez le bouton **RESET** pour confirmer la réinitialisation du **Leaderboard**
* Cela videra la liste **Players**.
* 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 videra la liste **Players**.
## É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 constaté rapidement 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** affiche un événement de classement d'un **Player** dans un **Leaderboard**, suivi d'une mise à jour de **Virtual Currency**.
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**, accédez à la zone **Virtual Currency** de l'écran.
* Vérifiez que la monnaie a été attribuée correctement.
* Le montant devrait être *supérieur* à celui noté précédemment.
* Notez que les **Players** aux positions **0** ou **1** du classement ont gagné **10 gold** *sans recevoir de silver*.
* Les **Players** aux positions **2**, **3** et **4** ont quant à eux reçu **10 silver** et *pas de gold*.
* Cela correspond aux actions configurées pour la table de prix.
Une autre façon de vérifier que la **Virtual Currency** a été attribuée correctement :
* Accédez à **Players**.
* Consultez l'**Event History**.
* Un événement **player\_virtual\_currency\_balance\_changed** s'affiche, avec des détails précis sur les montants modifiés pour la **Virtual Currency** attribuée.
## Related topics
- [Comment modifier les prix](/fr/publishing/game-publishing/how-to/how-to-priceupdate.md)
- [Utilisation de l'inventaire des joueurs](/fr/services/playfab/player-progression/player-data/player-inventory.md)
- [Tables de butin dans Economy (hérité)](/fr/services/playfab/economy-monetization/economy/tutorials/drop-tables.md)
- [Prix en argent réel dans Economy v2](/fr/services/playfab/economy-monetization/economy-v2/catalog/real-money-prices.md)
- [Prix promotionnels](/fr/publishing/game-publishing/concepts/availability/sale-pricing.md)