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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ПРИМЕР: Доступ к локациям, статусы персонажа, косметические улучшения, предустановленные 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:
Предварительно необходимо настроить регионы в проекте. Для этого обратитесь к аккаунт-менеджеру проекта.