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

Содержание

Как это работает
Для кого подходит
Как настроить

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Если логика внутриигрового магазина реализована на ваших серверах, вы можете настроить вебхук о покупке товаров.

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

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

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

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

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

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

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

Пример

Copy

Full screen

Small screen

"platform": “playstation_network”

Ограничение количества доступных для покупки пакетов виртуальной валюты

Вы можете ограничить покупку пакетов виртуальной валюты. Например, вы можете продавать:

ограниченное количество пакетов виртуальной валюты одному пользователю;
приветственные пакеты виртуальной валюты, которые доступны к покупке только один раз.

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

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

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

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

В ответе, кроме информации о пакете виртуальной валюты, вы получите следующую информацию:

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

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

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

Пример ответа:

Copy

Full screen

Small screen

{
  "items": [
    {
      "sku": "vc_package_1",
      "name": "VC Name first package",
      "groups": [],
      "attributes": [],
      "type": "bundle",
      "description": "VC Short Package Description",
      "image_url": "http://vc_package_image.png",
      "is_free": false,
      "price": {
        "amount": "2.0000",
        "amount_without_discount": "2.0000",
        "currency": "USD"
      },
      "bundle_type": "virtual_currency_package",
      "content": [
        {
          "description": "Big Rocket - short description",
          "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
          "sku": "big_rocket",
          "name": "Big Rocket",
          "type": "virtual_currency",
          "quantity": 100,
          "inventory_options": {
            "consumable": {
              "usages_count": 1
            },
            "expiration_period": null
          }
        }
      ],
      "virtual_prices": [],
      "limits": {
        "per_user": {
          "total": 5,
          "available": 5
          },
        "per_item": null
       },
      "can_be_bought": true
    },
    {
      "sku": "vc_package_3",
      "name": "VC Name third package",
      "groups": [],
      "attributes": [],
      "type": "bundle",
      "description": "VC Short Package Description",
      "image_url": "http://vc_package_image.png",
      "is_free": false,
      "price": {
        "amount": "4.0000",
        "amount_without_discount": "4.0000",
        "currency": "USD"
      },
      "bundle_type": "virtual_currency_package",
      "content": [
        {
          "description": "description",
          "image_url": "http://image.png",
          "sku": "shotgun_raider",
          "name": "SHOTGUN FOR TRUE RAIDERS",
          "type": "virtual_currency",
          "quantity": 200,
          "inventory_options": {
            "consumable": {
              "usages_count": 1
            },
            "expiration_period": null
          }
        }
      ],
      "virtual_prices": [],
      "limits": {
        "per_user": {
          "total": 5,
          "available": 5
          },
        "per_item": null
       },
      "can_be_bought": true
    }
  ]
}

Иксолла контролирует соблюдение ограничений и не позволяет пользователям приобрести превышающее лимит количество пакетов виртуальной валюты.

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

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

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

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