Système de récompense

Glossaire

Comment ça marche

Le système de récompenses permet d’inciter les utilisateurs à effectuer des achats dans le magasin avec des devises réelles. Si l’utilisateur fait partie d’un clan, ses achats apportent des points de valeur à l’ensemble du clan.

Vous pouvez créer des chaînes de récompenses individuelles ou de clan et attribuer des récompenses aux utilisateurs pour les objets achetés. Le jeu peut comprendre plusieurs chaînes de récompenses de différents types. Chaque chaîne peut comporter jusqu’à 31 étapes. Pour chaque niveau, vous définissez le nombre de points de valeur nécessaires pour le compléter.

Vous pouvez également créer une chaîne de récompenses personnalisée. La personnalisation vous permet d’afficher la chaîne uniquement à un groupe spécifique d’utilisateurs autorisés selon leurs attributs. La chaîne de récompenses personnalisée peut être destinée à des utilisateurs individuels ou à un clan.

À chaque étape de la chaîne de récompenses, un utilisateur peut recevoir entre 1 et 10 récompenses. Un clan peut également recevoir entre 1 et 10 récompenses par membre à chaque étape.

Vous pouvez récompenser les utilisateurs avec les types d’objet suivants :

• objets virtuels ;
• monnaie virtuelle ;
• packages de monnaie virtuelle ;
• lots.

Pour que le système de récompenses fonctionne correctement, l’authentification utilisateur doit être configurée. Les utilisateurs non authentifiés verront les chaînes de récompenses, individuelles comme de clan, sans aucune progression. Les utilisateurs authentifiés mais non affiliés à un clan ne verront que leur chaîne de récompenses individuelle, tandis que celle de clan apparaîtra comme indisponible.

Flux utilisateur

1. L’utilisateur accède au site.
2. L’utilisateur voit le catalogue des objets, le système de récompenses, ainsi que le nombre de points de valeur disponibles pour chaque objet.
3. L’utilisateur se connecte
4. L’utilisateur peut maintenant voir sa progression dans le système de récompenses.
5. L’utilisateur effectue un achat et progresse dans la chaîne de récompenses.

Comment configurer

Pour configurer un système de récompense, vous aurez besoin des informations suivantes :

• dates de début et de fin du système de récompense

• une image, une description, des UGS et des noms de points de valeur qui permettent de progresser dans la chaîne de récompenses individuelle et de clan ;
• le nombre de points de valeur ;
• les objets dans la chaîne de récompenses.

Voir les exemples ci-dessous.

Chaîne de récompenses :

Description	Exemple
Nom	Shard
Texte explicatif	Pour obtenir des récompenses, collectez les shards.
UGS	ExempleUGS003
Image ou son URL

Implémentez de votre côté :

• l’affichage des objets du système de récompenses dans le magasin :
  • le nombre de points de valeur octroyés pour l’achat d’objets dans le catalogue ;
  • les points de valeur ;
  • les étapes ;
  • les chaînes de récompenses ;
  • le solde des points de valeur de l’utilisateur autorisé ;
  • les récompenses.
• l’envoi des données de clan de l’utilisateur à Xsolla Login.

Pour configurer le système de récompenses, implémentez les méthodes API suivantes :

• Lire une liste d’objets virtuels ;
• Lire les chaînes de récompenses de l’utilisateur actuel ;
• Get current user’s value point balance ;
• Réclamer la récompense d’une étape ;
• Update current user’s clan ;
• Get top 10 contributors to reward chain under clan.

Définir le clan d'un utilisateur

Si vous n’utilisez pas Xsolla Site Builder, vous devez indiquer le clan de l’utilisateur dans les attributs utilisateur afin que la chaîne de récompenses de clan fonctionne correctement.

Pour ajouter un attribut avec un clan à un utilisateur, utilisez les méthodes de mise à jour des attributs et passez le tableau attributes contenant la valeur du clan dans le corps de la requête.

Exemple :

 1
 2{
 3"attributes": [
 4{
 5
 6"key": "clan_id",
 7"value": "beetles"
 8}
 9],
10"publisher_id": 000000,
11"publisher_project_id": 000000
12}

Vous pouvez passer les valeurs des attributs actuels directement lors de l’autorisation de l’utilisateur si vous utilisez l’API Auth by custom ID.

Vous pouvez également mettre à jour le clan actuel de l’utilisateur via API. Commencez par mettre à jour les attributs utilisateur dans Xsolla Login, puis appelez l’API Update current user’s clan. Si les attributs indiquent un nouveau clan, l’utilisateur recevra toutes les récompenses non réclamées de la chaîne de récompenses de son ancien clan, et son affiliation sera mise à jour. Si l’utilisateur appartenait auparavant à un clan, mais n’en fait plus partie, son affiliation sera révoquée. La réponse de cette méthode inclut les récompenses que l’utilisateur a déjà réclamées.

Configuration dans le Compte éditeur

Avant de créer une chaîne de récompenses, vous devez d’abord créer des points de valeur, des récompenses et des objets que les utilisateurs et les clans peuvent acheter pour gagner des points de valeur.

Créer des points de valeur

Pour créer des points de valeur :

1. Dans votre projet, dans le Compte éditeur, accédez à la section Store > Live-ops and promotion tools.
2. Dans l’onglet Rewards, cliquez sur Create value points.

3. Spécifiez les paramètres suivants :
   • Ajoutez une image (facultatif) ;
   • Entrez une UGS unique pour les points de valeur ;
   • Indiquez si les points de valeur seront utilisés pour les clans ;
   • Spécifiez un nom pour les points de valeur.

4. Cliquez sur Next.
5. Sélectionnez l’UGS de l’objet virtuel et indiquez le nombre de points de valeur que l’utilisateur recevra pour chaque achat.
6. Cliquez sur + pour ajouter le nombre requis d’objets.
7. Cliquez sur Save.

Les points de valeur créés apparaissent au-dessus des chaînes de récompenses. Les points de valeur de clan sont marqués en conséquence. Pour modifier les paramètres d’un point de valeur spécifique, cliquez sur Edit dans la ligne correspondante.

Créer une chaîne de récompenses

Pour créer une chaîne de récompenses :

1. Dans votre projet, dans le Compte éditeur, accédez à la section Store > Live-ops and promotion tools.
2. Cliquez sur Create reward.

3. Choisissez le type de New reward chain — Individual reward chain ou Clan reward chain.
4. Spécifiez les paramètres suivants. Si vous choisissez une chaîne de récompenses individuelle :
   1. Indiquez le nom de la chaîne de récompenses ;
   2. Ajoutez une description ;
   3. Sélectionnez les points de valeur dans la liste déroulante.

Si vous choisissez la chaîne de récompenses de clan :
1. Dans la liste déroulante Clan type, choisissez un type de clan ;
2. Définissez les paramètres de la chaîne de récompenses du clan :
   1. Indiquez le nom de la chaîne de récompenses,
   2. Ajoutez une description,
   3. Indiquez un titre pour l'en-tête de la fenêtre contextuelle de la chaîne de récompenses,
   4. Spécifiez le texte de l'infobulle (ce que les utilisateurs doivent faire pour gagner des récompenses pour leur clan),
   5. Ajoutez une image (facultatif),
   6. Choisissez les points de valeur dans la liste déroulante.

5. Cliquez sur Next.
6. Cliquez sur Add new step.
7. Spécifiez les paramètres suivants et cliquez sur Save :
   1. Step name ;
   2. Required amount of value points to clame the reward ;
   3. Required amount of virtual items for the step.
8. Cliquez sur Next.

9. Pour personnaliser la chaîne de récompenses :

   1. Activez la bascule Personalized reward chain.
   2. Sélectionnez l'une des options d'affichage de la chaîne et cliquez sur Next :
      • Show reward chain to specific users. Lorsque cette option est activée, la chaîne s'affiche uniquement aux utilisateurs autorisés qui remplissent les conditions spécifiées ;
      • Show reward chain to users who don't meet conditions. Lorsque cette option est activée, la chaîne s'affiche uniquement si aucune chaîne de récompenses correspondante n'est trouvée pour l'utilisateur ; par exemple, si l'utilisateur n'est pas autorisé ou si ses attributs ne correspondent à aucune chaîne personnalisée.
   3. Si vous avez choisi d'afficher la chaîne à des utilisateurs spécifiques :
      1. Cliquez sur Add condition et définissez les conditions de personnalisation :
         • User attribute est une caractéristique de l'utilisateur, telle que le pays ou l'âge. Les attributs se configurent dans la section Login ;
         • Attribute typ définit le format de la valeur de l'attribut : chaîne de caractères, nombre ou date ;
         • Comparison operator détermine comment la valeur de l'attribut utilisateur est comparée à la condition spécifiée ; par exemple, equals, greater than, less than ou contains ;
         • Valeur de l'attribut est la valeur spécifique utilisée pour la comparaison. Par exemple, si l'attribut utilisateur est l'âge, le type d'attribut est un nombre, l'opérateur de comparaison est supérieur à et la valeur de l'attribut est 18, la chaîne s'affichera uniquement aux utilisateurs de plus de 18 ans.
      2. Pour ajouter une autre condition de personnalisation, cliquez sur Add condition.
   4. Cliquez sur Next.

10. Créez le nombre d’étapes nécessaires, puis cliquez sur Save.

11. Cliquez sur Next.
12. Indiquez la période de validité de la chaîne de récompenses.
13. Si vous souhaitez que la chaîne de récompenses se renouvelle à un moment précis, réglez la bascule Make reward chain renewable sur On et définissez le mode de renouvellement.

12. Cliquez sur Save.

1. Dans le catalogue des récompenses, sélectionnez la chaîne de récompenses.
2. Cliquez sur ••• et choisissez Activate dans la liste déroulante.

Configuration via des appels API

Pour gérer le système de récompenses, utilisez les méthodes de la sous-section Administrateur du groupe de méthodes Chaînes de récompense et points de valeur.

1. Créez des points de valeur permettant d’accéder à des récompenses via l’API Créer un point de valeur.
2. Attribuez des points de valeur à des objets spécifiques via l’API Définir des points de valeur pour les objets : les utilisateurs recevront ces points après avoir acheté les objets.

3. Créez une chaîne de récompenses via l’API Créer une chaîne de récompenses. Pour créer une chaîne de récompenses personnalisée, passez la condition d’affichage dans le tableau attribute_conditions.

   Vous pouvez spécifier si une chaîne de récompenses personnalisée doit s’afficher à un utilisateur ne possédant pas l’attribut défini dans la condition. Pour ce faire, définissez le paramètre can_be_missing sur true.

   Vous pouvez également définir une chaîne de récompenses qui s’affichera si aucune chaîne personnalisée correspondante n’est trouvée pour l’utilisateur. Pour ce faire, définissez le paramètre is_always_visible sur false.

4. Activez le système de récompenses via l’API Basculer une chaîne de récompenses.

Vous pouvez également modifier, désactiver ou supprimer le système de récompenses, ainsi que supprimer les points de valeur associés aux objets.