Discount promotions

How it works

Discount promotions are a marketing tool for getting new players and increasing sales.

Main features:

  • Configure a discount for one or several items.
  • Apply an unlimited number of discount promotions to one item.
  • Create a catalog of items with automatic calculation of pricing for items. Methods for building a catalog return the price object for every item. This object contains prices for items with current discount and without them.

Copy
Full screen
Small screen
"price": {
  "amount": "2.9900000000000000",
  "amount_without_discount": "2.9900000000000000",
  "currency": "USD"
}
Restrictions:
  • You can set the discount only in percentage value in the range from 1 to 99.
  • If the item has several discount promotions, they don’t sum and are applied one by one.
  • You can’t apply regional restrictions to discount promotions.

Who can use it

Partners who have integrated one of the following products (or both):

  • In-Game Store with configured Virtual Items or Virtual Currency modules.
  • Buy Button with the configured Game Keys module.

How to get it

Prerequisites

  1. Create your Xsolla Publisher Account.
  2. Go to your project.

  1. Go to Project settings > Integration settings and make sure that the Integrate new Store management methods toggle is set to On.

  1. Configure modules for In-Game Store or Buy Button.

Set up discount campaign

You can set up discount campaigns in one of the following ways:

Set up via Publisher Account

If you set up discount promotions via Publisher Account, you have the following features:

  • Set up a discount with the integer percentage value.
  • Set up discount promotions that are available for a limited time period.
  • Set up discounts that apply to one or several items of one of the types:
    • virtual currency packages
    • virtual items (including nonrenewing subscriptions)
    • game keys

Note:
There is a list of actions that aren’t available in Publisher Account:
  • Set up discounts for physical goods.
  • Set up discounts with fraction values.
  • Set up discounts with an unlimited time period.
  • Set up discounts for different item types in one discount promotion.
  • Edit discount promotions with the Active status.
You can use API methods to enhance your discount promotions configuration options.

To set up a promotion via Publisher Account:

  1. Go to Store > Promotions and click Create promotion in Publisher Account.

  1. Specify the required parameters:
    1. Enter the promotion title.
    2. Choose Discount as a promotion type.
    3. Decide the discount amount.
    4. Choose the product type.

    1. Choose one or several items that will have a discount.

    1. Set the campaign start and end dates.

  1. Check the settings and click Save and exit.

  1. Find the newly created promotion in the promotions catalog. Click the ••• menu button to open a menu and click Edit.

  1. To activate the promotion, click the switch and choose the corresponding option.

Set up via API methods

To work with discount promotions, you can use the methods from the Discount subsection from the Promotions method group.

To create the promotion via API methods:

  1. Call the Create discount promotion for item method with required parameters.
  2. Call the Update item promotion method with the “is_enabled”:true parameter to activate the promotion.

To edit the promotion via an API, call the Update item promotion method with new promotion parameters. You can also edit the promotion that has the Active status.

When creating or editing a discount promotion via API methods, you can also:

Copy
Full screen
Small screen
"items": null
  • Configure a discount for physical goods. Pass an array with SKUs of physical goods to [Create discount promotion for item](https://developers.xsolla.com/publisher-account-api/promotions/create-item-promotion) or [Update item promotion](https://developers.xsolla.com/publisher-account-api/promotions/update-item-promotion/) methods.
Copy
Full screen
Small screen
"items": [{
     “sku”: “strw2030”
  }, {
     “sku”: “strw4060”
  }, {
     “sku”: “cupred200”
  }
]
  • Configure a discount with the fraction percentage value. Pass the discount.percent parameter with a fraction discount to [Create discount promotion for item](https://developers.xsolla.com/publisher-account-api/promotions/create-item-promotion) or [Update item promotion](https://developers.xsolla.com/publisher-account-api/promotions/update-item-promotion/) methods.
Copy
Full screen
Small screen
"discount": {
    “percent”: ”49.9”
}
  • Configure a discount for items of different types. Pass an array with SKUs of required items to [Create discount promotion for item](https://developers.xsolla.com/publisher-account-api/promotions/create-item-promotion) or [Update item promotion](https://developers.xsolla.com/publisher-account-api/promotions/update-item-promotion/) methods.
Copy
Full screen
Small screen
"items": [{
     “sku”: “storm_shield”
  }, {
     “sku”: “heaven_crystals_pack_x500”
  },{
     “sku”: “strw2030”
  }
]
  • Configure a discount for definite DRMs of the game. Pass an array with SKUs of required DRMs to [Create discount promotion for item](https://developers.xsolla.com/publisher-account-api/promotions/create-item-promotion) or [Update item promotion](https://developers.xsolla.com/publisher-account-api/promotions/update-item-promotion/) methods.
Copy
Full screen
Small screen
"items": [{
     “sku”: “brilliant_game_sku_steam”
  }
  ]
  • Configure discount promotion that doesn’t have a specified time period. Pass the “date_end”:null parameter to [Create discount promotion for item](https://developers.xsolla.com/publisher-account-api/promotions/create-item-promotion) or [Update item promotion](https://developers.xsolla.com/publisher-account-api/promotions/update-item-promotion/) methods.
Copy
Full screen
Small screen

“date_end”: null

Customize conditions of a 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 definite sum of a cart
  • discount that is applied only if the cart has enough items
  • discount on one item if users buy another item
To set up discount promotions with conditions, contact your Account Manager.