Виртуальные предметы

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

Виртуальные предметы — это внутриигровые товары, которые пользователь может приобрести за реальную или виртуальную валюту или получить в качестве бонуса. Они не имеют физического выражения и используются только внутри игры. Примеры виртуальных предметов: скины, зелья, оружие и другие элементы, влияющие на игровой процесс или внешний вид персонажа.

Основные возможности:

• Гибкая настройка цен:
  • Задание цены для одного предмета в реальной и/или виртуальной валюте.
  • Создание бесплатных предметов.
• Автоматическое определение валюты и страны пользователя.
• Настройка доступности:
  • Ограничение продажи предметов в различных регионах.
  • Ограничение количества доступных для покупки предметов.
  • Ограничение времени отображения предметов в магазине.
  • Настройка предметов, недоступных для покупки. Предмет может быть скрыт из каталога, но при этом доступен для получения в составе бандла или в качестве бонуса к другому товару.

Как настроить

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

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

3. Добавьте:
   • изображение (опционально);
   • артикул;
   • группу, содержащую этот предмет в магазине;
   • название;
   • краткое описание (опционально).
4. Чтобы настроить отображение предмета в магазине, выберите соответствующий статус.

5. Задайте цены или создайте бесплатный предмет в поле Платно или бесплатно:

1. • Чтобы создать бесплатный предмет, выберите Бесплатный предмет.

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

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

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

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

8. Чтобы настроить ограничение времени отображения предмета (опционально):

1. 1. В поле Показывать товар в магазине выберите Ограниченное время.

1. 2. Укажите часовой пояс, начало и конец периода.

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

9. Настройте атрибуты для предмета одним из следующих способов (опционально):

1. 1. Добавьте атрибуты и их значения в формате JSON.

1. 2. Создайте атрибуты и их значения вручную и настройте их связь с товарами.

10. Проверьте настройки и нажмите Создать предмет.

Настройка через методы API

Для настройки виртуальных предметов используйте методы подраздела Admin из группы методов Виртуальные предметы и валюта.

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

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

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

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

1. Создайте виртуальный предмет.

2. В проекте в Личном кабинете перейдите в раздел Каналы продаж > Веб-сайты.
3. В панели необходимого сайта нажмите Открыть Site Builder.

4. В разделе блока Магазин в поле Тип товара выберите Виртуальные предметы, а в поле Группа товаров выберите группу товаров, которую вы хотите продавать на сайте.

5. Настройте стиль карточки товара.
6. Чтобы изменения вступили в силу, опубликуйте сайт:
   1. В правом верхнем углу конструктора сайтов нажмите Опубликовать.
   2. Установите флажки напротив страниц, которые вы хотите опубликовать.
   3. Подтвердите, что сайт готов к публикации, и нажмите Опубликовать.

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

Получение информации о виртуальных предметах через API

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

Начисление виртуальных предметов пользователям

Способ начисления зависит от настроек интеграции в вашем проекте:

• Если настроена интеграция с PlayFab, виртуальные валюты и предметы начисляются в инвентарь PlayFab.
• Если вы используете собственную систему начислений, начисление пользователю виртуальных валют и предметов происходит полностью на вашей стороне. Мы рекомендуем настроить обработчик вебхуков и получать информацию о заказе на серверной части вашего приложения. Данные для начисления приходят в вебхуке Успешная оплата заказа.

Полезные ссылки