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

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

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

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

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

Доступны следующие способы продажи виртуальной валюты:

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

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

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

• В пакет можно добавить только один тип виртуальной валюты.
• Настроить цену в другой виртуальной валюте можно только с помощью API.
• Пакет виртуальной валюты можно сделать бесплатным — без указания цены в реальной или виртуальной валюте. Это можно настроить через Личный кабинет или с помощью API. Бесплатную виртуальную валюту, не в составе пакета, можно создать только с помощью API.
• Количество виртуальной валюты в пакете можно задать только целым числом.

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

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

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

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

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Все товары.
2. Нажмите Добавить и в раскрывающемся списке выберите Виртуальная валюта.

3. Добавьте:
   1. изображение (опционально);
   2. артикул;
   3. название виртуальной валюты.
4. Чтобы настроить отображение виртуальной валюты в магазине, выберите соответствующий статус.

5. Чтобы задать цену, нажмите Настроить цены и укажите цену в реальной валюте. При необходимости настройте региональные цены.
6. Настройте атрибуты для предмета одним из следующих способов (опционально):

1. 1. Добавьте атрибуты и их значения в формате JSON.

1. 2. Создайте атрибуты и их значения вручную и настройте их связь с товарами.

7. Проверьте настройки и нажмите Создать валюту.

Примечание

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

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

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Все товары.
2. Нажмите Добавить и в раскрывающемся списке выберите Пакет виртуальной валюты.

3. Добавьте:
   1. изображение (опционально);
   2. артикул;
   3. группу, содержащую этот пакет в магазине;
   4. название;
   5. краткое описание (опционально).
4. Чтобы настроить отображение виртуальной валюты в магазине, выберите соответствующий статус.

5. Укажите виртуальную валюту в составе пакета и ее количество.
6. Задайте цены или создайте бесплатный предмет в поле Платно или бесплатно:

1. • Чтобы создать бесплатный предмет, выберите Бесплатный предмет.

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

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

1. 1. В раскрывающемся списке выберите период:
      • Каждый день.
      • Каждую неделю.
      • Каждый месяц.
      • Настроить интервал. Интервал рассчитывается от даты начала периода показа пакета в магазине.
      • Без регулярного обновления.

1. 2. Задайте расписание обновления, указав параметры, соответствующие периоду.

9. Чтобы настроить ограничение времени отображения пакета (опиционально):

1. 1. В поле Показывать товар в магазине выберите Ограниченное время.

1. 2. Укажите часовой пояс, начало и конец периода.

1. 1. Чтобы не указывать конец периода отображения предмета, установите флажок Без даты окончания.

10. Настройте атрибуты для предмета одним из следующих способов (опционально):

1. 1. Добавьте атрибуты и их значения в формате JSON.

1. 2. Создайте атрибуты и их значения вручную и настройте их связь с товарами.

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

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

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

Отображение виртуальной валюты в каталоге товаров

Отображение виртуальной валюты или пакетов виртуальной валюты зависит от способа реализации каталога – через конструктор сайтов или с помощью API.

Отображение через конструктор сайтов

1. Создайте пакет виртуальной валюты.
2. В проекте в Личном кабинете перейдите в раздел Каналы продаж > Веб-сайты.
3. В панели необходимого сайта нажмите Открыть Site Builder.

4. В разделе блока Магазин в поле Тип товара выберите пакет виртуальной валюты, который вы хотите продавать на сайте.

5. Настройте стиль карточки товара.
6. Чтобы изменения вступили в силу, опубликуйте сайт:
   1. В правом верхнем углу конструктора сайтов нажмите Опубликовать.
   2. Установите флажки напротив страниц, которые вы хотите опубликовать.
   3. Подтвердите, что сайт готов к публикации, и нажмите Опубликовать.

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

Получение информации о виртуальной валюте через API

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

Начисление виртуальной валюты пользователям

Способ доставки зависит от настроек интеграции в вашем проекте:

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