Create bonus promotion
Bonus promotions are a marketing tool that helps increase sales by offering users bonus items when they purchase an item. A purchase can include multiple bonus items, and a single item can be included in multiple bonus promotions.
If there is a limit set on purchasing a bonus item, and the user has received all available items within that limit, the promotional item will not be available for purchase.
If a bonus promotion has a usage limit, and the remaining number of promotions available to the user is zero, the promotional item will be displayed in the catalog without the bonus item.
Examples
Depending on the restrictions that are set, there are different user scenarios for purchasing promotional items with bonuses.
Example of limits on purchasing bonus items:
In its settings, the Booster item has a purchase restriction — it can be bought by a user no more than 2 times.
Booster is a bonus item when purchasing Empire Lootbox.
User bought Booster 1 time and also bought Empire Lootbox 1 time, receiving Booster as a bonus.
When attempting to buy Empire Lootbox again, the response to the order creation method will indicate that the user has exceeded the purchase limit for the Booster item.
Example of limits on using bonus promotions:
In its settings, the bonus promotion has a usage limits — no more than 1 time per user.
Booster is a bonus item when purchasing Empire Lootbox.
User bought Empire Lootbox 1 time and received Booster as a bonus.
When attempting to buy Empire Lootbox again, the bonus item Booster will not be displayed and delivered to the user.
Example of limits on purchasing bonus items and on using bonus promotions:
In its settings, the Booster item has a purchase restriction — it can be bought by a user no more than 1 time.
Booster is a bonus item when purchasing the Empire Lootbox.
The bonus promotion has a usage limits — no more than 2 times per user.
User bought Empire Lootbox 1 time and received Booster as a bonus.
When attempting to buy Empire Lootbox again, the response to the order creation method will indicate that the user has exceeded the purchase limit for the Booster item.
Create bonus promotion
To create a bonus promotion:
- In your project in Publisher Account, go to the LiveOps > Canvas section.
- In the project in your account for mobile games, go to the Operation > LiveOps section.
- In the project in your account, go to the LiveOps > Canvas section.
- In the project in your account, go to the LiveOps > More > Canvas section.
- Start creating a promotion in one of the following ways:
- Option 1:
- In the toolbar, click the
icon. - In the promotion list area, click the + icon.
- In the toolbar, click the
- Select Bonus and click Create.
- Option 2: In the toolbar, click the + icon and select Bonus.
- Option 3: Open the context menu anywhere on the canvas and select Bonus.
- Specify the promotion name.
- Select the promotional items:
- In the Promotional items field, click Select items.
- In the window that opens, check the boxes next to the required items.
- Click Add items.
- Select the items to be provided as a bonus when purchasing a promotional item:
- In the Bonus items field, click Select items.
- In the window that opens, check the boxes next to the required items and specify their quantity.
- Click Add items.
- Click Next.
- Add conditions and limitations (optional):
- To give users a bonus for their first purchase, set the First-time buyer bonuses toggle to active.
- To set a limit on the number of times a user can redeem the promotion, set the Bonus limits toggle to active and enter the required number.
- To create a personalized promotion (for example, available only to users above a certain in-game level), set the Custom user bonuses toggle to active and specify the necessary conditions.
To set up a personalized promotion, user attributes must be configured.
You can define one or multiple conditions for a personalized promotion. Keep in mind that while the promotion is active, you can’t modify it.
- Click Next.
- Specify the promotion period.
- Click Next.
- Review the promotion settings.
- To activate the promotion immediately (optional), set the Create in Active status toggle to active.
- Click Create.
- To add the created bonus promotion to the site (optional):
- Open the site in the builder by clicking Open or Open in Site Builder on the banner in the editing form.
- Follow the instructions from the Display bonus items in store section.
On the canvas, a visual link is shown between the promotion card and the promotional item.
To manage its display, click the → or ← icon to the right of the item card, next to the
When setting up a promotion via the canvas, the following options are not available:
- Setting up a promotion with game keys.
- Setting up a promotion with no end date.
Advanced options for configuring bonus promotions are available via Publisher Account and API calls.
When setting up a promotion via the canvas, the following options are not available:
- Setting up a promotion with game keys.
- Setting up a promotion with no end date.
Advanced options for configuring bonus promotions are available via API calls.
When setting up a promotion via the canvas, the following options are not available:
- Setting up a promotion with game keys.
- Setting up a promotion with no end date.
Advanced options for configuring bonus promotions are available in your account and via API calls.
Display bonus items in store
If you sell items through your own interface, you can retrieve item information by calling client API methods to get an item catalog (calls from the Common > Catalog, Virtual Items and Currency > Catalog, and Bundles > Catalog subsections).
If your site is created using Xsolla site builder, a timer appears on an item’s card 30 days before the end of the promotion to show the remaining time:
- If the end of the promotion is in more than a week, the timer shows days and hours.
- If the end of the promotion is in more than one day, the timer shows hours and minutes.
- If the end of the promotion is in less than a day, the timer shows minutes and seconds.
To change the color of the timer and Bonus label:
- In your project in Publisher Account, go to the Storefronts > Websites section.
- Select your site and click Open Site Builder.
- Open the project in your account and go to the Storefronts > Website section.
- Click the pane of your site.
- Open the project in your account and go to the Storefronts > Website section.
- Click the pane of your site.
- Open the project in your account and go to the Storefronts > Website section.
- Click the pane of your site.
- Open the project in your account and go to the Web Shop section.
- Click the pane of your site.
- In the side menu, go to the Theme section.
- Select a new color in the Secondary field.
- To apply changes, publish the website:
- In the upper-right corner of the site builder, click Publish.
- Check the boxes next to the pages you want to publish.
- Click Publish.
If site publication is not available, make sure all the conditions are met:
- There are no empty sections in the builder (marked with a red indicator).
- The licensing agreement with Xsolla has been signed.
- The main page is published or selected for publication. You can’t publish child pages before the main page.
Found a typo or other text error? Select the text and press Ctrl+Enter.