In-Game Store / Виртуальная валюта
  На главную

In-Game Store

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

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

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

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

Примечание
Если вы хотите установить цену для виртуальной валюты или пакетов виртуальной валюты равной нулю, обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.
Внимание
В скидочных кампаниях, кампаниях с промокодами или купонами вы можете использовать только пакеты виртуальной валюты. Произвольное количество виртуальной валюты может использоваться только в бонусных кампаниях.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Пример

Copy
Full screen
Small screen

"platform": “playstation_network”

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

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

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

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

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

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

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

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

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

Подробнее о том, как настроить или обновить ограничения, вы можете прочитать в инструкции Ограничения для пользователя.

Примечание

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

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

Пример ответа c атрибутами пользователей:
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
    }
  ]
}
Примечание

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

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

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

Ограничение времени отображения валюты и пакетов валюты в магазине

Вы можете указать период отображения виртуальной валюты и пакета валюты в магазине, чтобы:
  • поддерживать актуальность каталога в заданное время, например, во время праздничных распродаж;
  • создать виртуальную валюту и пакеты валюты заранее, не отображая в каталоге;
  • мотивировать пользователей к покупке с помощью таймера, который может отображаться рядом с виртуальной валютой или пакетом валюты.
Примечание
При создании интерфейса каталога с помощью Site Builder таймер будет отображаться автоматически. При создании каталога в собственном интерфейсе таймер необходимо реализовать самостоятельно.

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

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

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

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

  1. Зарегистрируйтесь в Личном кабинете Xsolla.
  2. Перейдите к проекту.
  1. Настройте модули для продукта In-Game Store или Buy Button.

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

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

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

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

Для настройки виртуальных валют используются методы подраздела Admin из группы методов Virtual items & currency.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 10 октября 2023

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!