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.

"price": {
  "amount": "2.3900000000000000",
  "amount_without_discount": "2.9900000000000000",
  "currency": "USD"
}

Restrictions:

• You can set the discount only in percentage value in the range from 1 to 99.
• You can’t apply regional restrictions to discount promotions.

You can set up promotions for any number of items. Apply an unlimited number of discount promotions to one item.

"item_id": 193166,
"sku": "helmet",
"type": "virtual_good",
"name": "{
Helmet",
"description": "---",
"image_url": "https://static.xsolla.com/misc/publisher_account/virtual_item_default_image.png",
"price": {
    "amount": "31.50",
    "amount_without_discount": "34.99",
    "currency": "TRY"
},
"virtual_prices": [],
"can_be_bought": true,
"promotions": [
    {
        "name": "store_promotion_164901_b5ef62b0551711edaedb22484f053720_name",
        "date_start": "2022-10-25T00:00:00+03:00",
        "date_end": "2022-11-30T23:59:59+03:00",
        "discount": {
            "percent": "10.00",
            "value": null
        },
        "bonus": [],
        "limits": {
            "per_user": {
                "available": 3,
                "total": 3
            }
        }
    },
    {
        "name": "store_promotion_164901_dc1fd2b2551711ed82b722484f053720_name",
        "date_start": "2022-10-24T00:00:00+03:00",
        "date_end": "2022-11-30T23:59:59+03:00",
        "discount": null,
        "bonus": [
            {
                "sku": "22",
                "quantity": 1
            },
            {
                "sku": "sword",
                "quantity": 2
            }
        ],
        "limits": {
            "per_user": {
                "available": 1,
                "total": 1
            }
        }
    }
],
"limits": null,
"attributes": [
    {
        "external_id": "sh4",
        "name": "sh4",
        "values": [
            {
                "external_id": "hd",
                "value": "20"
            }
        ]
    }
],
"is_free": false,
"groups": [
    {
        "external_id": "imported",
        "name": "Imported"
    }
],
"virtual_item_type": "consumable",
"inventory_options": {
    "consumable": {
        "usages_count": 1
    },
    "expiration_period": null
}
}

How to get it

Set up discount campaign

• via Publisher Account
• via API methods

Set up via Publisher Account

• Set up a discount with a percentage value.
• Set up discount promotions that are available for a limited time.
• Set up discounts that apply to any types of items:
  • virtual currency packages
  • virtual items (including time-limited items)
  • game keys
  • bundles

The following actions aren’t currently available in Publisher Account:

• Set up discounts with fractional values.
• Set up discounts with an unlimited time period.
• Edit discount promotions with an Active status.

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

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

• 5. Choose one or several items that will have a discount.

3. Click Next.
4. You can limit number of times one user can use promotion. To set it up, on the Condition and limit page, set Limit number of times one user can use promotion to On and specify the limit.
5. To set up personalized promotions, set Promotion for only specific users to On and follow this instruction.
6. Click Next.

7. Set the campaign start and end dates.
8. Click Next.

9. Check the settings and click Save and exit.

10. To activate a promotion:
    1. Find the promotion in your promotions catalog.
    2. Click the ••• menu button and select Edit promotion.

• 3. In the upper right corner, open the drop-down menu and choose Activate promotion.

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:

• Configure a discount to all items in the project. Pass the “items”:null parameter to Create discount promotion for item or Update item promotion methods.

"items": null

• Configure a discount for physical goods. Pass an array with SKUs of physical goods to Create discount promotion for item or Update item promotion methods.

"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 or Update item promotion methods.

"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 or Update item promotion methods.

"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 or Update item promotion methods.

"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 or Update item promotion methods.

“date_end”: null

• Set up promotion for first-time buyers. For this, pass in the Create discount promotion for item for item API or in the Update item promotion API an object in array attribute_conditions:

"attribute_conditions": [
{
"attribute": "has_purchase",
"operator": "eq",
"value": "0",
"type": "number"
}
],
"limits": {
"per_user": 1
}

Customize conditions of a discount promotion

• 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