Внутриигровой магазин / Виртуальная валюта
 На главную

Внутриигровой магазин

  • Руководство по интеграции

  • Возможности

  • Инструкции

  • Расширения

  • Справочники

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Пример

    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
        }
      ]
    }

    Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Была ли статья полезна?
    Спасибо!
    Что может сделать страницу еще лучше? Сообщение
    Жаль, что так произошло
    Расскажите, почему статья не была полезна. Сообщение
    Спасибо за обратную связь!
    Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
    Оценить страницу
    Оценить страницу
    Что может сделать страницу еще лучше?

    В другой раз

    Спасибо за обратную связь!
    Последнее обновление: 25 ноября 2022

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

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