Time limited and number limited offers

You can limit the number of sales for:

• virtual items
• promotions

Set up limits

Set up limits for virtual items

You can limit the number of items users can purchase and set the periods after which the limits will be updated.

Via Publisher Account, you can limit:

• virtual currency packages
• virtual items
• bundles

To set up virtual items, we recommend that you first configure virtual item groups. Groups allow you to have a multilevel catalog and manage how items are displayed in the store.

To create groups of virtual items:

1. In Publisher Account, go to the Store section.
2. In the Virtual Items pane, click Configure.
3. Click Create a group.
4. Specify the following parameters:
   • Group code.
   • Group name.
5. If you want to show the group in the catalog, set the Show group in Store to On.
6. Click Create group.

To set up a limit for an existing promotion:

1. In Publisher Account, go to the Store section.
2. In the Virtual Items pane, click Configure.
3. Go to the group with the item you want to use.
4. In the line of the product, click ••• and choose Edit item in the drop-down list.
5. Go to step 6.

To set up a number-limited virtual item:

1. In Publisher Account, go to the Store section.
2. In the Virtual Items pane, click Configure.
3. Click Create item.
4. Specify:
   • Image.
   • SKU.
   • One or several groups the item should belong to.
   • Name.
   • Description.
   • Item property: consumable, nonconsumable, or time-limited items.

• Prices.

5. If you want to show an item in the store, set the Show item in store toggle to On.
6. If you want to limit the number of times a user can buy an item, switch the Limit the number of times one user can buy this item toggle to On and specify the limit.

7. To set how often limits are refreshed:
   • If you do not want to refresh restrictions, choose No regular refresh from the drop-down list.
   • If you want the limits to be refreshed regularly, choose Daily from the drop-down list and set the time and time zone.

8. Click Create item.

Set up limits for promotion

For bonus and discount promotions, you can limit the number of offers available to the user.To create a number-limited promotion:

1. In Publisher Account go to the Store section.
2. In the Promotions and rewards pane, click Configure.
3. Click Create promotion.
4. Enter the promotion title.
5. In the drop-down list, choose the Discount or Bonus type.
6. Fill in the fields depending on the type of promotion you have chosen.
7. Click Next.
8. For a number of sales limitation on the Conditions page, set the Limit number of times one user can use promotion to On and enter the number of uses.

9. To set up personalized promotions, set Promotion for only specific users to On and follow these instruction.
10. Click Next.
11. Set the campaign start and end dates.
12. Click Next.
13. Check the settings and click Save and exit.

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

Refresh limits

You can refresh the limits you set earlier.
Refresh limits allows you:

• implement periodic updating of restrictions on the purchase of goods or the use of a promotion
• synchronize data with your system if the sale of goods is carried out on several game publishing platforms

You can set up limits in the following ways:

• in Publisher Account
• via API methods

Refresh in Publisher Account

In Publisher Account, you can refresh limits for a specific product or promotion for all users. You can use API methods to set up additional features.

Refresh limits for items

To refresh limits to specific product or promotion for all users (on the example of virtual objects):

1. In Publisher Account go to Store section.
2. In Virtual items pane click Configure.
3. Go to the group with the needed item.
4. In the line with needed item click ••• and in the dropdown list and choose Edit item.
5. In Limit for single user section in the drop-down list, select the frequency for refreshing limits, then set the time and time zone.

6. Click Save Changes.

Refresh limits for promotion

To set up limits for specific promotion for all users:

1. In Publisher Account, go to the Store section.
2. In the Promotions and rewards pane, click Configure.
3. In the line with promotion, click ••• and choose Edit promotion in the drop-down list.
4. On the Condition and limits page, click Refresh this limit manually.

5. Confirm the action and click Save Changes.

Limits via API calls

To set up daily, weekly or monthly limits, pass an array of objects recurrent_schedule with limits settings to the Create virtual item API call.

Limits information is shown when a catalog is requested via the Get virtual item list call.

Items for which the user got the limits are displayed in the catalog with the flag can_be_bought = false. You can refresh the limits.

Refresh via API calls

Use the API calls from the Limits section to refresh limits:

• for all promotion for specified user — Refresh all promotion limits for specified user
• specified product for all or specifies users — Refresh purchase limit
• specified promotion for all or specifies user — Refresh promotion limit for users

To clear all item limits for specifies user use the Refresh all purchase limits for specified user API.

Set up additional features via API methods:

Last updated: October 3, 2024