Ограничение времени отображения товаров в магазине

Как это работает

Вы можете указать период отображения товаров в магазине, чтобы:

• Поддерживать актуальность каталога в заданное время, например, во время праздничных распродаж.
• Создать товар заранее, не отображая его в каталоге.
• Мотивировать пользователей к покупке с помощью таймера, который отображается рядом с товаром. При создании интерфейса каталога с помощью конструктора сайтов таймер будет отображаться автоматически. При создании каталога в собственном интерфейсе таймер необходимо реализовать самостоятельно.

• продажа внутриигровых товаров – виртуальных предметов, пакетов виртуальной валюты, бандлов;
• продажа игр и DLC через игровые ключи.

Настройка и обновление лимитов

Настройка и обновление через Личный кабинет

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Все товары > Виртуальные предметы.
2. Нажмите Добавить и выберите Виртуальные предметы.

3. Укажите:
   • изображение;
   • артикул;
   • одну или несколько групп, которым должен принадлежать предмет;
   • название предмета;
   • описание предмета;
   • цену.

4. Чтобы ограничить количество предметов, доступное для покупки, активируйте переключатель Ограничивать покупку предметов пользователем и введите необходимое число.
5. Чтобы настроить частоту обновления лимитов:
   1. В раскрывающемся списке выберите период:
      • Каждый день.
      • Каждую неделю.
      • Каждый месяц.
      • Настроить интервал. Интервал рассчитывается от даты начала периода показа предмета в магазине.
      • Без регулярного обновления.

1. 2. Задайте расписание обновления, указав параметры, соответствующие периоду.

6. Чтобы настроить лимит по времени отображения предмета в магазине, выберите пункт Период времени и укажите часовой пояс, начало и конец периода. Чтобы не указывать конец периода отображения предмета, установите флажок Без даты окончания.

Примечание

Чтобы добавить еще один период отображения предмета в магазине, нажмите +. Если у предмета несколько периодов отображения, каждый из них должен иметь дату окончания. Период завершается в последнюю секунду указанной минуты. Например, если указано время 12:00, он завершится в 12:00:59.

7. Если предмет платный и будет использоваться в любых механиках со случайной наградой (например, в лутбоксах или гача), активируйте переключатель Отметить как платное случайное вознаграждение.

8. Нажмите Создать предмет.

Настройка и обновление через методы API

Чтобы настроить лимит по времени отображения товаров через методы API, используйте методы:

• Создание виртуального предмета или Обновление виртуального предмета
• Создание виртуальной валюты или Обновление виртуальной валюты
• Создание пакета виртуальной валюты или Обновление пакета виртуальной валюты
• Создание бандла или Обновление бандла
• Создание игры, Обновление игры по артикулу или Обновление игры по ID

• periods[0].date_from с данными о дате и времени начала периода отображения валюты в формате YYYY-MM-DDThh:mm:ss±TMZ, где TMZ — указатель часового пояса в формате hh:mm GMT;

• periods[0].date_until с данными о дате и времени конца периода отображения валюты в формате YYYY-MM-DDThh:mm:ss±TMZ, где TMZ — указатель часового пояса в формате hh:mm GMT. Чтобы не задавать конец периода отображения валюты, укажите только один период и передайте “periods[0].date_until”: null.

Вы можете настроить несколько периодов отображения товаров в магазине. Для этого передайте в методе массив объектов с датами начала и конца всех периодов.

Пример:

 1"periods": [
 2      {
 3        "date_from": "2022-06-10T14:00:00+03:00",
 4        "date_until": "2022-06-30T14:00:00+03:00"
 5      },
 6       {
 7        "date_from": "2022-07-10T14:00:00+03:00",
 8        "date_until": "2022-07-30T14:00:00+03:00"
 9      },
10       {
11        "date_from": "2022-08-10T14:00:00+03:00",
12        "date_until": "2022-08-30T14:00:00+03:00"
13      }
14]

По умолчанию в методах получения каталога возвращаются товары, которые отображаются в магазине на момент запроса. Чтобы получить информацию о товарах, период отображения которых еще не наступил или уже истек, передайте параметр show_inactive_time_limited_items со значением 1 при запросе каталога.

Отображение лимитов в каталоге товаров

Отображение товаров с лимитом по времени зависит от способа реализации каталога — через конструктор сайтов или с помощью API.

Отображение через конструктор сайтов

Если вы используете конструктор сайтов, лимиты отображаются автоматически. За 30 дней до конца периода продажи товара на карточке товара автоматически появляется таймер, который показывает оставшееся время:

• Если до конца продажи остается больше недели, таймер показывает дни и часы.
• Если до конца продажи остается больше суток, таймер показывает часы и минуты.
• Если до конца продажи остается меньше суток, таймер показывает минуты и секунды.

Получение информации о лимитах через API

Если отображение каталога реализовано с помощью API, информация о периоде продажи товара возвращается в массиве items.periods в методах получения каталога товаров:

• Получение списка виртуальных предметов
• Получение списка виртуальных валют
• Получение списка пакетов виртуальной валюты
• Получение списка бандлов
• Получение списка игр