How to set up limiting the display time for items in the store

You can set the display period for an items 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
• bundels

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 an 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"
      }
]

Rate this page

Is there anything we can improve? Send

Don’t want to answer

Thank you for your feedback!