Reward system
Glossary
Reward system
Reward chain
Step
Value points
Reward
How it works
The reward system gives you the opportunity to incentivize users who regularly purchase items in the in-game store with real currency. In this case, users receive additional motivation to use the in-game store or web store.
You can create reward chains by giving out rewards for a certain amount of real currency spent. There can be several chains in the game. The maximum length of one chain is 31 steps. Each step has an execution condition — to gain a given number of value points that show the user’s progress in the reward system.
At each step, the user can receive from 1 to 10 rewards.
You can reward users by giving out the following item types:
- virtual items
- virtual currency
- virtual currency packages
- bundles
Unauthorized users can see reward chains, but not their own progress. The number of earned value points and progress in the reward system are displayed to the user after authorization.
User flow
- The user goes to the site.
- The user sees the item catalog, available rewards, and the number of value points that can be received for the purchase of each item.
- User logs in or signs up on the site.
- The user sees their progress in the reward system and can move up the reward chains by earning value points for purchasing items.
How to get it
Set up via Publisher Account
Share the following details to your Customer Success Manager:
- start and end dates of the reward system
- an image, description, SKUs, and names of value points that enable progress in the reward chain
- the number of value points and items in the reward chain
- display of elements of the reward system in the store:
- the number of value points that are given out for the items’ purchase in the catalog
- value points
- steps
- reward chains
- the balance of the authorized user’s value points
- rewards
- integration of reward methods
- Get virtual items list
- Get current user’s reward chains
- Get current user’s value point balance
- Claim step reward
- Create value point
- Updates value point
- Set value points for items — Users receive value points after they purchase these items.
- Delete value points from items — Removes value point rewards from all items.
- Create reward chain
- Update reward chain
- Delete reward chain
- Toggle reward chain
See the examples below.
Reward chain:
| Description | Example |
|---|---|
| Name | Xsolla bonus system |
| Explanatory text | Completing each step gives you unique rewards. Collect shards and get access to even cooler rewards! |
| Period | 01.05.2023 — 31.05.2023 |
Step of reward chain:
| Description | Example |
|---|---|
| Step name | Tier 1 |
| The number of accumulated value points at which the user receives a reward | 25 |
| List with item SKUs and the number of rewards that the user receives in this step | sword_1 x 1, coin_pack_50 x 2 |
Value points:
| Description | Example |
|---|---|
| Name | Shard |
| Explanatory text | To get rewards, collect the shards. |
| SKU | ExampleSKU003 |
| Image or its URL |  |
Value points given out for the purchase of certain goods:
| Description | Example |
|---|---|
| Item SKU for the purchase of which value points are given out | Helmet_1 |
| The number of value points given out after the items’ purchase | 10 |
Implement on your side:
For the correct work of the reward system, your site must have user authorization set up in the catalog.
If you use the Web Shop or Site Builder, then you don’t have to implement displaying the elements of the reward system and integrating API methods on your side.
To set up the reward system, implement the following API methods:
Set up via API calls
To work with the reward system, implement the following methods from the Admin subsection of the Reward chains & Value points method group:
Was this article helpful?
Rate this page
Don’t want to answer
Thank you for your feedback!
Found a typo or other text error? Select the text and press Ctrl+Enter.
