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

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

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

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

  • Настройка цен в реальной и виртуальной валюте.
  • Настройка каталога с одним или несколькими уровнями вложенности.
  • Автоматическое определение валюты и страны пользователя.

Особенности настройки цен:

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

Ограничения настройки цен:

  • Нельзя создать предмет без указания цены в реальной или виртуальной валюте.
  • Нельзя создать предмет с нулевой ценой.

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

Расходуемые виртуальные предметы

Расходуемый предмет — это предмет в инвентаре, который можно накапливать и покупать многократно. После использования его количество уменьшается.

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

  • Пополнение количества предметов в инвентаре.
  • Хранение множества единиц предмета в инвентаре пользователя.
  • Можно расходовать с клиента игры.

ПРИМЕР: Гранаты, патроны и т.д.

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

Нерасходуемый предмет — это предмет в инвентаре, который можно начислить или купить только один раз.

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

  • Хранение предмета в инвентаре пользователя в единственном экземпляре.
  • Нельзя расходовать с клиента игры, изымается из инвентаря только серверным методом.

ПРИМЕР: Доступ к локациям, статусы персонажа, косметические улучшения, предустановленные DLC, опция для отключения рекламы в игре и т.д.

Непродлеваемые подписки

Непродлеваемая подписка — это предмет с ограниченным периодом действия, который пользователь покупает единоразово.

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

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

ПРИМЕР: Battle Pass, Season Pass, временный доступ к скину, предмету или другой дополнительный контент, доступный на ограниченный период времени.

Подробная информация приведена в рецепте Непродлеваемая подписка.

Для кого подходит

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

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

Предварительные действия

  1. Зарегистрируйтесь в Личном кабинете Иксолла.
  2. Перейдите к вашему проекту.

  1. Перейдите в Настройки проекта > Настройки интеграции и убедитесь, что переключатель Интегрировать методы Commerce API установлен в положение Вкл.

Сценарий интеграции

  1. Настройте виртуальные предметы и их группы.
  2. Настройте региональные ограничения и региональные цены.

Настройка виртуальных предметов и их групп

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

Виртуальные предметы и их группы можно настроить одним из следующих способов:

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

Чтобы настроить группы виртуальных предметов:

  1. В Личном кабинете подключите модуль Виртуальные предметы.

  1. В разделе Магазин > Виртуальные предметы выберите Создать группу.

  1. Задайте необходимые параметры:
    1. Код группы.
    2. Название группы.

  1. Установите переключатель Показывать группу в магазине в положение Вкл.
  2. Нажмите Создать группу.

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

  1. В Личном кабинете подключите модуль Виртуальные предметы .

  1. Создайте предмет.

  1. Для каждого предмета укажите:
    1. изображение;
    2. артикул;
    3. одну или несколько групп, которым должен принадлежать предмет;
    4. название предмета;
    5. описание предмета;
    6. свойство предмета — расходуемый, нерасходуемый или непродлеваемая подписка;
    7. цены в реальной и виртуальной валюте.

  1. Установите переключатель Показывать предмет в магазине в положение Вкл.
  2. Нажмите Создать предмет.

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

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

Для использования методов требуется базовая аутентификация. Передайте в запросе параметр Authorization:Basic <your_authorization_basic_key>, где <your_authorization_basic_key> — пара ID продавца:ключ API, закодированная по стандарту Base64. ID продавца указано в разделе Настройки проекта > Оповещения Личного кабинета. Ключ API указан в разделе Настройки компании > Ключ API Личного кабинета.

Notice
Методы из подраздела Admin не предназначены для построения каталога в магазине на клиенте. Они не должны использоваться на лендингах, в веб-магазинах и внутриигровой логике.

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

Чтобы получить весь список предметов, независимо от их групп, используйте метод Get virtual items list. Чтобы получить список предметов определенной группы, передайте в метод Get items list by specified group параметр external_id.

Настройка региональных ограничений и региональных цен

Чтобы настроить региональные ограничения на виртуальные предметы, передайте в метод Create item или Update item массив объектов с идентификаторами регионов, в которых предмет будет доступен для продажи.

Copy
Full screen
Small screen
"regions": [{
     “id”: “123”
  }, {
     “id”: “456”
  }
]

Чтобы настроить региональные цены для виртуальных предметов, передайте в метод Create item или Update item массив объектов с настройками цен для регионов.

Copy
Full screen
Small screen
"regional_prices": [{
     “region_id”: “123”,
     “country_iso”: “CHN”,
     “amount”: 40,
     “currency_iso”: “CNY”,
     “is_default”: true,
     “is_enabled”: true
  }
]

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