Système de récompense

Glossaire

Comment ça marche

Le système de récompenses vous permet de gratifier régulièrement l’utilisateur pour ses achats d’objets en jeu avec de l’argent réel. De cette manière, l’utilisateur est encore plus incité à utiliser le magasin en jeu ou le magasin en ligne.

Établissez des chaînes de récompenses en accordant des récompenses en fonction du montant d’argent réel dépensé. Il peut y avoir plusieurs chaînes dans le jeu, avec chaque chaîne pouvant comporter jusqu’à 31 étapes. Chaque étape a des conditions à remplir, et l’utilisateur gagne un nombre spécifique de points qui reflètent sa progression dans le système de récompense.

À chaque étape, l’utilisateur peut recevoir de 1 à 10 récompenses.

L’utilisateur peut être récompensé avec les types de biens suivants :

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

Les utilisateurs non autorisés peuvent voir les chaînes de récompenses, mais pas leur propre progression. Le nombre de points de valeur acquis et la progression dans le système de récompense sont affichés à l’utilisateur après autorisation.

Flux utilisateur

1. L'utilisateur se rend sur le site.
2. L'utilisateur voit le catalogue des objets, les récompenses disponibles et le nombre de points de valeur qu'il peut recevoir pour l'achat de chaque objet.
3. L'utilisateur se connecte ou s'inscrit sur le site.
4. L'utilisateur voit sa progression dans le système de récompense et peut monter dans la chaîne de récompenses en gagnant des points de valeur pour l'achat d'objets.

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
• le nombre de points de valeur et d'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

• l’affichage des objets du système de récompense 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’intégration des méthodes de récompense.

• Get virtual items list ;
• Get current user’s reward chains ;
• Get current user’s value point balance ;
• Claim step reward.

Configuration dans le Compte éditeur

Avant de créer une chaîne de récompense, vous devez créer des points de valeur.

Créer des points de valeur

Pour créer des points de valeur :

1. Ouvrez votre projet dans le Compte éditeur.
2. Dans le volet latéral, cliquez sur Store.
3. Dans le volet Promotions and rewards, cliquez sur :
   • Connect — si vous n’avez pas de promotions ou de récompenses connectées ;
   • Configure — si vous avez déjà connecté de promotions ou de récompenses.

4. Dans l'onglet Rewards, cliquez sur Create value points.

5. Spécifiez les paramètres suivants :
   • Image (optional).
   • Unique value points SKU.
   • Value points name.

6. Cliquez sur Next.
7. Cliquez sur + et sélectionnez l'UGS d'un objet virtuel et le nombre de points de valeur que l'utilisateur recevra par achat.

8. Cliquez sur Save.

Les points de valeur sont créés et affichés au-dessus des chaînes de récompenses. Si nécessaire, modifiez-les en utilisant le bouton Edit.

Créer une chaîne de récompenses

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

1. Ouvrez votre projet dans le Compte éditeur.
2. Dans le volet latéral, cliquez sur Store.
3. Dans le volet Promotions and rewards, cliquez sur :
   • Connect — si vous n’avez pas de promotions ou de récompenses connectées ;
   • Configure — si vous avez déjà connecté de promotions ou de récompenses.

4. Dans l'onglet Rewards, cliquez sur Create reward.

5. Spécifiez les paramètres suivants :
   • Reward chain name.
   • Description.
   • Dans la liste déroulante, choisissez les points de valeur.

6. Cliquez sur Next.
7. Spécifiez les paramètres suivants :
   • Step name.
   • Required amount of value points for claiming the reward.
   • Required amount of virtual items for step.

8. Cliquez sur Save.

9. Cliquez sur Next.

10. Indiquez la période de validité de la chaîne de récompenses.

11. Cliquez sur Save.

La chaîne de récompenses est créée et présentée dans le catalogue.

Pour activer la chaîne de récompenses :

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

Configuration via des appels API

Pour travailler avec le système de récompense, utilisez les méthodes de la sous-section Admin du groupe de méthodes Reward chains & Value points.

1. Créez les points de valeur qui donnent accès aux récompenses dans le système de récompenses via l'API Create value point.
2. Utilisez l'API Set value points for items pour attribuer des points de valeur aux utilisateurs après l'achat de certains objets.
3. Créez le système de récompense via l'API Create reward chain.
4. Activez le système de récompense via l'API Toggle reward chain.

Vous pouvez modifier, désactiver ou supprimer le système de récompense, ainsi que supprimer les points de valeur des objets.