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

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

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

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

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

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

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

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

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

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

• расходуемые
• нерасходуемые
• непродлеваемые подписки

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• через Личный кабинет;
• через методы API.

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

• Группы виртуальных предметов
• Виртуальные предметы

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

"regions": [{
     “id”: “123”
  }, {
     “id”: “456”
  }
]

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

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

Оценить страницу

Что может сделать страницу еще лучше? Отправить

В другой раз

Спасибо за обратную связь!