Виртуальная валюта

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

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

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

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

Варианты продажи валюты

Продажа валюты возможна в двух видах: 

• в любом количестве;
• пакетом.

Продажа любого количества валюты

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

Пакеты виртуальной валюты

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

ПРИМЕР: “Золотой пакет” содержит 100 золотых монет и стоит 90$ при стоимости золота 1$ за монету.

Ограничения:

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

Доставка валюты

Виртуальная валюта доставляется:

• В инвентарь (способ по умолчанию). Пакет виртуальной валюты перед доставкой распаковывается, и в инвентарь игрока начисляется виртуальная валюта из его состава.
• В PlayFab, если настроена интеграция.

Премиум-валюта

Премиум-валюта — это виртуальная валюта, которая привязана к платформе, где осуществляется покупка, и которая продается только за реальную валюту.

Ограничения: 

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

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

• Установите переключатель Премиум-валюта в положение Вкл.

• При вызове API методов управления инвентарем передайте в поле platform строку с платформой, для которой совершается покупка.

ПРИМЕР

"platform": “playstation_network”

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

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

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

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

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

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

4. Настройте модули для продукта Внутриигровой магазин или Buy Button.

Настройка виртуальной валюты

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

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

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

• Виртуальная валюта
• Пакеты виртуальной валюты

Чтобы настроить виртуальную валюту через Личный кабинет:

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

2. В разделе Магазин > Виртуальная валюта нажмите кнопку Новая виртуальная валюта.

3. Задайте необходимые параметры:
   1. Загрузите изображение виртуальной валюты.
   2. Укажите артикул виртуальной валюты.
   3. Укажите название виртуальной валюты.
   4. Укажите цены в нужных валютах.
   5. Укажите валюту по умолчанию.
   6. Если валюта определена как Премиум-валюта, обратитесь к инструкции по ее настройке.
4. Проверьте настройки и нажмите Создать валюту.

Чтобы настроить пакет виртуальной валюты через Личный кабинет:

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

2. Убедитесь, что в проекте создана хотя бы одна виртуальная валюта.
3. Перейдите в раздел Магазин > Виртуальная валюта > Пакеты и нажмите кнопку Новый пакет.

4. Задайте необходимые параметры:
   1. Загрузите изображение пакета.
   2. Укажите артикул пакета.
   3. Укажите название пакета.
   4. Укажите краткое описание пакета.
   5. Укажите виртуальную валюту в составе пакета.
   6. Укажите цены пакета в реальной и/или виртуальной валюте.
   7. Укажите валюту по умолчанию.
   8. Для отображения пакета в каталоге магазина установите переключатель Показывать в магазине в положение Вкл.

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

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

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