In-Game Store / Как настроить ограничение времени отображения товаров в магазине
  На главную

In-Game Store

Как настроить ограничение времени отображения товаров в магазине

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

  • поддерживать актуальность каталога в заданное время, например, во время праздничных распродаж;
  • создать товар заранее, не отображая его в каталоге;
  • мотивировать пользователей к покупке с помощью таймера, который может отображаться рядом с товаром.
Примечание
При создании интерфейса каталога с помощью Site Builder таймер будет отображаться автоматически. При создании каталога в собственном интерфейсе таймер необходимо реализовать самостоятельно.
Ограничение времени отображения доступно для следующих типов товаров:
  • виртуальные предметы;
  • виртуальная валюта и пакеты виртуальной валюты;
  • бандлы.
Примечание
Для виртуальных предметов, пакетов виртуальной валюты и бандлов доступна настройка через Личный кабинет и с помощью методов API. Для виртуальной валюты доступна настройка только с помощью методов API.
Чтобы настроить ограничение времени отображения виртуальных предметов, пакетов виртуальной валюты и бандлов через Личный кабинет, выберите пункт Период времени и укажите часовой пояс, начало и конец периода. Чтобы не указывать конец периода отображения бандла, установите флажок Без даты окончания.
Примечание
После создания виртуального предмета, виртуальной валюты или пакета виртуальной валюты вы можете задать статусы для товара, чтобы определить, будет ли он доступен, недоступен или частично доступен для покупки.
Чтобы настроить ограничение времени отображения товаров через методы API, используйте метод:Передайте в метод создания или обновления товара параметры:
  • 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.

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

Пример:

Copy
Full screen
Small screen
    "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"
          }
    ]
    

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

    Примечание

    Ограничение времени отображения товара не учитывается в составе бандла.

    ПРИМЕР

    1. Вы создаете виртуальный предмет Booster и задаете период его отображения — с 29 октября по 15 ноября.

    2. Вы создаете бандл Legendary Start Pack, в состав которого входит Booster. Ограничение на отображение бандла не задано, поэтому бандл отображается в магазине всегда.

    3. 20 октября пользователь открывает ваш магазин внутриигровых товаров. Вы используете методы:

    Параметр show_inactive_time_limited_items в методах не передаете.

    4. Вы получаете каталог товаров:

    • Booster не придет в ответе на Get virtual items list, так как период его отображения — с 29 октября по 15 ноября. Если вы передадите параметр show_inactive_time_limited_items:1 в Get virtual items list, в ответе Booster придет и в массиве periods будет указан период, когда он доступен для покупки.
    • Booster придет в составе бандла Legendary Start Pack в ответе на Get list of bundles и пользователь сможет его получить вне зависимости от значения параметра show_inactive_time_limited_items.

    Была ли статья полезна?
    Спасибо!
    Что может сделать страницу еще лучше? Сообщение
    Жаль, что так произошло
    Расскажите, почему статья не была полезна. Сообщение
    Спасибо за обратную связь!
    Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
    Последнее обновление: 3 октября 2024

    Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

    Сообщите о проблеме
    Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
    Укажите email-адрес, чтобы мы могли связаться с вами
    Спасибо за обратную связь!