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

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

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

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

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

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

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

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

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

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

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

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

Настройка и обновление через методы 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. Чтобы не указывать конец периода отображения валюты, передайте значение 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 в методах получения каталога товаров:

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