Number limited allows you to limit the number of available offers per user.
You can set up a number of sales limitation for:

• use promotions by user
• virtual items that user can buy

Number of permitted uses

For bonus and discount promotion you can set up a limit to the number of offers available to the user.
After setting a limit number of times one user can use promotion, on your site an item card will show:

• discount amount for discount promotions
• bonus notice for bonus promotions
• a line with the number of available items

How to get it

To create number limit promotion:

1. Open your project at Publisher Account.
2. Click Store in the side menu and connect the Promotions module.
3. Enter the promotion title.
4. In the drop-down list, choose the promotion type.
5. Fill in the fields depending on the type of promotion you have chosen.
6. Click Next.
7. 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.

8. To set up personalized promotions, set Promotion for only specific users to On and follow these instruction.
9. Click Next.
10. Set the campaign start and end dates.
11. Click Next.

12. Check the settings and click Save and exit.

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

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

Number limitation for virtual item

You can limit the number of items available to users. After setting up, a counter available to the user items will appear on the site.

How to get it

To set up virtual items, you need to 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. Open your project in Publisher Account.
2. Click Store in the side menu and connect the Virtual Items module.
3. Click Create a group.
4. Specify the following parameters:
   • Group code.
   • Group name.
5. If you want to show the group in a catalog, set the Show group in Store to On.

6. Click Create group.

To set up a number limited virtual item:

1. Open your project in Publisher Account.
2. Click Store in the side menu and connect the Virtual Items module.
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.

1. • Prices in real or virtual currencies.

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. Click Create item.

After setting a number of sales limitation for items, on your site an item card will show a line with the number of available items.

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

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 Promotion pane, click Configure.
3. In the line with promotion, click ••• and choose Edit plan 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.

You can set a time limit for:

• use promotions by user

• virtual items that user can buy

Time limitation for promotion

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.

Time limitation for items

You can set the display period for an item in the store to:

• maintain the relevance of the catalog at a given time, for example, during holiday sales

• create an item in advance without displaying it in the catalog

• motivate users to buy items by displaying a timer next to the item

Limiting the display time is available for the following item types:

• virtual items

• virtual currency and virtual currency packages

• bundles

To set a time limit for displaying a virtual currency, virtual currency packages and bundles in the store via Publisher Account:

1. When creating an item in Publisher Account, set the Show in store toggle to On.

2. Select Time period and specify the time zone, the beginning, and end of the period. To not indicate the end of the item display period, check the No end date box.

To set a time limit for displaying items in the store via API, use:

• Create virtual item or Update virtual item API call for virtual items

• Create virtual currency or Update virtual currency API call for virtual currency

• Create virtual currency package or Update virtual currency package API call for virtual currency packages

• Create bundle or Update bundle API call for bundles

Pass following parameters to the item creation or item update API call:

• periods[0].date_from with the date and time of the beginning of item display period in YYYY-MM-DDThh:mm:ss±TMZ format, where TMZ is the time zone indicator in hh:mm GMT format

• periods[0].date_until with the date and time of the end of the item display period in YYYY-MM-DDThh:mm:ss±TMZ format, where TMZ is the time zone indicator in hh:mm GMT format. To not indicate the end of an item’s display period, pass null

You can set up multiple periods for displaying an item in the store. To do this, pass an array of objects with the start and end dates of all periods in the API calls.

Example:

"periods": [
      {
        "date_from": "2022-06-10T14:00:00+03:00",
        "date_until": "2022-06-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-07-10T14:00:00+03:00",
        "date_until": "2022-07-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-08-10T14:00:00+03:00",
        "date_until": "2022-08-30T14:00:00+03:00"
      }
]