Discount promotions

How it works

General information

Discount promotions are a marketing tool designed to attract new users and increase sales. Items purchased at a discount price are granted to users in the same way as items without discounts.

Discounts are available for the following scenarios:

• sale of in-game items — virtual items, virtual currency packages, and bundles
• sale of games and DLC via game keys

Key features:

• A discount promotion can be applied to one or multiple items.
• An unlimited number of discounts can be applied to one item.
• One discount can be applied to an unlimited number of items.
• API calls for creating a catalog (Common > Catalog, Virtual Items and Currency > Catalog, and Bundles > Catalog subsections) and managing a cart return the price object for each item in which you can find item price including both discounted and regular prices.

Limitations:

• Discounts are not applied to prices specified in virtual currency. For items with both real and virtual currency prices, discounts apply only to the real currency price.
• You can’t apply regional restrictions to discount promotions.

Rules for applying discounts

If several promotions are valid for an item at the time of purchase, discounts are applied to the item one by one. The order in which discounts are applied doesn’t matter.

Example:

• Black Friday discount promotion with a discount of 10% from November 4–30
• Sale discount promotion with a discount of 20% from November 15 – December 15
• promotion with a promo code for a 5% discount from November 4–30

If the item is purchased on November 20, both discount promotions and a promotion with a promo code are valid.

The total cost of the virtual item is then calculated as (($10 - 10%) - 20%) - 5% = $10 × (100%-10%) × (100%-20%) × (100%-5%) = $10 × 0.9 × 0.8 × 0.95 and will be $6.84.

Set up promotion with discounts

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 Discount.
3. In the Discount amount field, specify the discount percentage. It can only be an integer value from 1 to 99.
4. In the Product type drop-down list, select an item type that a discount will be applied to.

5. Select the items to which you want to apply the discount.

Note

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

6. 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 the discount, turn on the Limit number of times one user can use promotion toggle and specify the necessary value.
3. To apply the discount 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.
8. 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 discount campaigns via API, use the following calls:

Customize conditions of discount promotion

You can set up a discount that is applied only if some conditions are met. For example:

• discount that is applied to a specified cart sum
• discount that is applied only if the cart has enough items
• discount on one item if users buy another one

To set up discount promotions with conditions, contact your Customer Success Manager or email to [email protected].

Display discounted items in store

If you sell items through your own interface, you can retrieve item pricing information, including discounted prices, 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 discount amount:

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.

Discount promotions are a convenient marketing tool for attracting attention to items and increasing sales.

You can apply a discount to any number of items, and any number of discounts can be applied to a single item. The system automatically calculates both the discounted and original prices, ensuring accurate display of information in the store.

Create discount promotions

To create a discount 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 Discount and click Create.

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

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

3. Specify the promotion name.
4. Specify the discount percentage.
5. Select the items to which the discount will apply:
   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.

6. Click Next.
7. Add conditions and limitations (optional):
   • To give users a discount on an item for their first purchase, set the First-time buyer discounts toggle to active.
   • To set a limit on how many times a user can use the promotion, set the Discount 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 discounts 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 discount 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 discounted items in store section.

To manage their display, click the → or ← icon to the right of the promotional 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 discounted items in store

If you sell items through your own interface, you can retrieve item pricing information, including discounted prices, 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 discount amount:

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.