Bonus promotions

How it works

Overview

The following items can be used as bonuses:

• virtual currency packages
• game keys
• virtual items
• bundles

Key features:

• A user can get an unlimited number of bonuses when purchasing an item.
• One item can be granted as a bonus in an unlimited number of bonus campaigns.
• You can set up limits on the number of times a bonus is available to a user.
• You can set up personalized bonus promotions.

User flow

1. The user goes to the store.
2. The user chooses an item with the Bonus label.

3. In the item card, the user sees bonus items.

4. The user adds items to the cart or proceeds to purchase a selected item directly.
5. The user completes the payment.
6. The items are granted to the user.

Limits logic

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 won’t be available for purchase.

Depending on the limits that are set, there are different scenarios for purchasing promotional items with bonuses. For example, when there are limits on purchasing bonus items, the logic will be the following:

• The Booster item has a purchase limit — no more than 2 times per user.
• Booster is a bonus item for Empire Lootbox.
• A user bought Booster 1 time and also bought Empire Lootbox 1 time, receiving Booster as a bonus. When they try to buy Empire Lootbox again, the response to the order creation call will indicate that the user has exceeded the purchase limit for the Booster item. As a result, the user won’t be able to receive Booster in any way.

Set up campaign with bonuses

To create a new campaign with bonuses:

2. On the Promotions tab, click Create promotion.

3. Specify the main promotion parameters:

1. Specify Promotion name.
2. In the Promotion type drop-down list, select Bonus.
3. Configure promotional items:
   1. In the Promotional items drop-down list, select an item type for the purchase of which users will get bonus items.

1. 2. Select the items.

Note

You can select different types of items. To switch between different item types, use the Promotional items field. Information about all selected items is displayed in the List of promotional items area.

To configure different bonus item types, use the Bonus items field.

4. Configure bonus items:
   1. In the Bonus items drop-down list, select an item type that users will get when purchasing promotional items.
   2. Select the items.
5. Click Next.

4. Configure discount limits:

1. To limit the promotion to a user’s first purchase only, turn on the Trigger promotion only for first-time buyers toggle. When this setting is enabled, you can’t configure other limits.
2. To limit the number of times a single user can get a bonus, turn on the Limit number of times one user can use promotion toggle and specify the necessary value.
3. To apply the promotion to users whose attributes match specified conditions, turn on the Trigger promotion only for specific users toggle and define the attribute validation conditions.
4. Click Next.

5. Specify the promotion validity period: a time zone, start date, and end date. To create a promotion without an end date, check the No end date box.

Note

To add another promotion validity period, click +. If a promotion has multiple validity periods, each must have an end date. The promotion ends at the last second of the specified minute. For example, if an end time is set to 12:00, the promotion runs until 12:00:59.

6. Click Next.
7. Review the promotion settings and click Save and exit.

To make the promotion available to users, you must activate it. To do this:

2. In the row with a promotion, click ••• and choose Edit promotion in the drop-down list.

3. In the drop-down list in the upper-right corner, select Activate promotion.

Configure via API

To set up and manage bonus campaigns via API, use the following 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:

3. In the side menu, go to the Theme section.
4. Select a new color in the Secondary field.

5. 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.

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.

Create bonus promotion

To create a bonus promotion:

2. Start creating a promotion in one of the following ways:
   • Option 1:

1. 1. 1. In the toolbar, click the  icon.
      2. In the promotion list area, click the + icon.

1. 1. 3. Select Bonus and click Create.

1. • Option 2: In the toolbar, click the + icon and select Bonus.

1. • Option 3: Open the context menu anywhere on the canvas and select Bonus.

3. Specify the promotion name.
4. Select the promotional items:
   1. In the Promotional items field, click Select items.
   2. In the window that opens, check the boxes next to the required items.
   3. Click Add items.

5. Select the items to be provided as a bonus when purchasing a promotional item:
   1. In the Bonus items field, click Select items.
   2. In the window that opens, check the boxes next to the required items and specify their quantity.
   3. Click Add items.

6. Click Next.
7. 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.

8. Click Next.
9. Specify the promotion period.
10. Click Next.
11. Review the promotion settings.
12. To activate the promotion immediately (optional), set the Create in Active status toggle to active.
13. Click Create.

14. To add the created bonus promotion to the site (optional):
    1. Open the site in the builder by clicking Open or Open in Site Builder on the banner in the editing form.
    2. 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  icon. If an item is included in multiple promotions, you can display the link for only one promotion at a time.

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:

3. In the side menu, go to the Theme section.
4. Select a new color in the Secondary field.

5. 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.