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

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

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

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

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

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

2. Нажмите Создать товары и в раскрывающемся списке выберите Виртуальный предмет.

3. В разделе Общие настройки укажите:
   • артикул;
   • одну или несколько групп, которым должен принадлежать предмет (опционально);
   • название;
   • краткое описание;
   • расширенное описание — чтобы добавить его, включите соответствующий переключатель (опционально).

4. В разделе Media загрузите одно или несколько изображений или видео (опционально) — с устройства или по ссылке. В магазине, созданном с помощью редактора сайтов Xsolla, во всех карточках товара отображается файл с меткой Main, остальные файлы доступны только в карточках с медиагалереей. Файл с меткой Main также возвращается в ответах методов API получения каталога.

5. В разделе Настройки цен задайте цену или создайте бесплатный предмет:
   • Чтобы задать цену, выберите тип товара – Платный товар, активируйте переключатель Цены в реальной валюте и/или Цены в виртуальной валюте и укажите цену. При необходимости настройте региональные цены.
   • Чтобы создать бесплатный предмет, выберите тип товара – Бесплатный товар.

6. Чтобы ограничить количество предметов, доступное для покупки:
   1. Активируйте переключатель в разделе Лимиты покупок и введите необходимое число.
   2. Настройте частоту обновления лимитов, для этого в раскрывающемся списке выберите период:
      1. Каждый день.
      2. Каждую неделю.
      3. Каждый месяц.
      4. Настроить интервал. Интервал рассчитывается от даты начала периода показа предмета в магазине.
      5. Без регулярного обновления.
   3. Задайте расписание обновления, указав параметры, соответствующие периоду.

7. Чтобы настроить лимит по времени отображения предмета (опционально):
   1. Активируйте переключатель в разделе Добавить период отображения.
   2. Укажите часовой пояс, начало и конец периода.

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

8. Настройте атрибуты одним из способов (необязательно):
   1. Добавьте атрибуты и их значения в формате JSON.
   2. Создайте атрибуты и их значения вручную и настройте их связь с товарами.

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

10. Нажмите кнопку Создать.

11. В открывшемся окне выберите статус товара и нажмите Продолжить.

Созданный предмет отобразится в разделе Все товары.

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

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

Отображение виртуальных предметов в магазине

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

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

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

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

2. В проекте в Личном кабинете перейдите в раздел Storefronts > Websites.

3. В панели нужного сайта нажмите кнопку Open Site Builder.

2. В проекте в аккаунте для мобильных игр перейдите в раздел Web Shop.

3. Нажмите панель нужного сайта.

4. Если на сайте несколько страниц, выберите нужную:

   1. Нажмите на название текущей страницы в верхней части редактора.
   2. Выберите нужную страницу из выпадающего списка.

5. В разделе блока Store в поле Item type выберите Virtual items, а в поле Item group выберите группу товаров, которую вы хотите продавать на сайте.

6. Настройте макет карточки товара.

7. После внесения всех необходимых изменений и подготовки сайта к запуску:

   1. В правом верхнем углу редактора сайта нажмите Publish.
   2. Отметьте страницы, которые нужно опубликовать.
   3. Нажмите Publish.

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

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

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

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

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

• Если вы интегрировали PlayFab, виртуальная валюта и предметы автоматически зачисляются в инвентарь пользователя в PlayFab.
• Если вы используете собственную систему выдачи, все виртуальные предметы и валюту вы выдаете на своей стороне. Рекомендуем настроить обработчик вебхуков, чтобы получать данные о заказе на вашем бэкенде. Необходимые данные содержатся в вебхуке Successful payment for order.

Подробная информация об этом и других способах получения данных о покупке приведена в разделе Set up order status tracking.

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