Daily rewards

How it works

Daily rewards motivate users to log into the store every day to receive free items. You can create the following types of daily rewards:

• Login reward — rewards that unlock sequentially every 24 hours starting from the user’s first login.
• Reward calendar — rewards that unlock at the same set time each day for all users. The reward schedule is global and doesn’t depend on the date a specific user first logs into the store.

1. Example: If a user logs into the store for the first time on the day 4 of the promotion, they will see the reward for day 4 of the chain.

The following item types can be used as rewards:

• Virtual items
• Virtual currency
• Virtual currency packages
• Bundles

The following item settings are ignored in daily rewards chains:

• personalization rules
• purchase limits
• scheduled availability (start/end date)
• promotions and discounts

Daily rewards are shown as chains that users can unlock consecutively. You can launch recurring daily reward chains that automatically restart after the final day in the chain is completed.

To ensure the daily rewards system works correctly, user authentication must be enabled.

Unauthenticated users can see the full daily reward chain but are not able to claim any rewards.

User flow

1. The user visits the store.
2. The user sees the daily reward chain and the reward available for today’s login.
3. The user logs in.
4. The user sees their current progress in the daily reward chain.
5. The user claims the daily reward.

Set up via Publisher Account

Before creating a daily reward chain, you need to create items that users can get for free upon logging into the store.

To create items manually in your project in Publisher Account, go to the Items catalog > All items section. Detailed information about this and other methods for creating items is available in the Items catalog documentation section.

Create daily rewards

To create daily rewards:

1. Open your project in Publisher Account and go to the LiveOps > Daily rewards section.
2. Click Create daily rewards.

3. Specify the following parameters:
   • Provide a title for the daily reward chain.
   • Enter a description (optionally).

4. Click Next.
5. Add a reward for the day of the chain. To do this:

1. 1. Click Add reward.

1. 2. Select an item, specify the quantity that users receive as a reward for this day, and click Save.

6. After you have added rewards for each day, click Next.
7. Select the type of daily rewards — Login reward or Reward calendar. Reward type is defined at the creation step and cannot be changed afterward.
8. Specify the start date and time for the daily rewards.
9. For the Login reward type, you can turn on the Add time limit toggle and specify the end date and time of the promotion.

Note

For the Reward calendar type, the end date is calculated automatically based on the number of days for which rewards are created.

10. If you want the daily rewards chain to restart after it ends, turn on the Make promotion renewable toggle.

1. The renewal logic depends on the chain type:

1. • The Login reward chain restarts after the current cycle ends, before the promotion ends.

1. 1. Example: A chain of 5 rewards is available from October 1 to October 31. If this setting is enabled, the user will be able to start a new reward cycle after the current one ends (upon earning 5 rewards or resetting the progress). Each new cycle begins with the first reward in the chain. Multiple renewals are possible throughout the promotion period, up to and including October 31.

1. • The Reward calendar chain, renews for all users with a frequency equal to the length of the reward chain.

1. 1. Example: A chain of 5 rewards is available from October 1. If this setting is enabled, the chain will renew for all users every 5 days — October 6, 11, 16, and so on.

11. Click Create.

1. Example: In a chain of 5 rewards, if the user logs in for 3 days in a row and misses the 4th day, then on day 5:
   • The user will receive the first reward in the chain if the reset setting is enabled.
   • The user will receive the fourth reward in the chain if the reset setting is disabled.

12. Click Create.

1. In your project in Publisher Account, go to the LiveOps > Daily rewards section.
2. In the row with a daily reward, click ••• and choose Activate in the drop-down list.

Edit daily rewards

You can activate, deactivate, and edit daily rewards. For rewards of the Login reward type, you can also reset the progress of all users in the current daily rewards cycle. To change the settings, click ••• in the daily reward row and select the desired action.

Configure via API

To set up and manage daily reward via API, use the following calls from the Admin section in the Daily reward group:

Display daily rewards in store

Display on website created with Xsolla

To display a daily reward on your site:

1. In your project in Publisher Account, go to the Storefronts > Websites section.
2. Select your site and click Open Site Builder.

3. In the main area of the builder, choose a place where you want to add a new block and click Add block.
4. Select the Daily rewards block.

5. In the side menu, go to the block settings.
6. In the drop-down list, choose the daily reward chain.

7. To preview the daily reward chain, click Preview in the upper-right corner of the builder.
8. To apply changes, publish the website:
   1. In the upper-right corner of the site builder, click Publish.
   2. Check the boxes next to the pages you want to publish.
   3. Click Publish.

Users will not see the daily reward chain until it is activated and its validity period begins.

Daily reward chains with expired dates or chains that have not yet started are displayed in preview mode in the site builder. This mode allows you to view all unpublished changes, including inactive chains.

Display in your own UI

1. In your application UI, implement the elements to display daily rewards chain steps.
2. Implement the logic to work with chains using the following client-side API calls from the Daily rewards group:
   • Get current user’s daily rewards
   • Get current user’s daily reward by its ID
   • Claim daily reward step
3. Ensure that items are correctly granted to the user.