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
Note
When you create a catalog interface using Site Builder, the timer is displayed automatically. When you create a catalog in your own interface, you need to implement the timer.
Limiting the display time is available for the following item types:
- virtual items
- virtual currency and virtual currency packages
- bundels
Note
For virtual items, virtual currency packages and bundles, configuration is available through the Publisher Account and using API calls. For virtual currency, configuration is available using API calls only.
To set a time limit for displaying a virtual currency, virtual currency packages and bundles in the store via Publisher Account:
- When creating an item in Publisher Account, set the Show in store toggle to On.
- 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 inYYYY-MM-DDThh:mm:ss±TMZ
format, whereTMZ
is the time zone indicator inhh:mm
GMT formatperiods[0].date_until
with the date and time of the end of the item display period inYYYY-MM-DDThh:mm:ss±TMZ
format, whereTMZ
is the time zone indicator inhh:mm
GMT format. To not indicate the end of an item's display period, passnull
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:
Copy
"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"
}
]
Was this article helpful?
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.Rate this page
Rate this page
Don’t want to answer
Thank you for your feedback!
Found a typo or other text error? Select the text and press Ctrl+Enter.