Система вознаграждений

Глоссарий

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

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

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

За каждый уровень пользователь может получить от 1 до 10 наград.

В качестве наград можно выдавать следующие типы товаров:

• виртуальные предметы;
• виртуальную валюту;
• пакеты виртуальной валюты;
• бандлы.

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

Сценарий пользователя

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

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

Чтобы настроить систему вознаграждений, вам потребуется следующая информация:

• дата начала и дата окончания действия системы вознаграждений;

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

Примеры предоставления информации приведены ниже.

Цепочка наград:

Описание	Пример
Название	Осколок
Сопроводительный текст	Собирайте осколки, чтобы получать награды.
Артикул	ExampleSKU003
Изображение или его URL-адрес

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

• Получение списка виртуальных предметов
• Get current user’s reward chains
• Получение призовых баллов текущего пользователя
• Claim step reward

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

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

Создание призовых баллов

Чтобы создать призовые баллы:

1. Откройте проект в Личном кабинете.
2. В боковом меню нажмите Store.
3. В панели Акции и награды нажмите:
   • Подключить — если у вас еще нет акций или наград;
   • Настроить — если вы уже подключили акции или награды.

4. На вкладке Награды нажмите Создать призовые баллы.

5. Задайте необходимые параметры:
   • Добавьте изображение (опционально).
   • Введите уникальный артикул призового балла.
   • Укажите название.

6. Нажмите Далее.
7. Нажмите + и выберите артикул виртуального товара и количество призовых баллов, которые пользователь получит за покупку этого товара.

8. Нажмите Сохранить.

Призовые баллы созданы и отображаются над цепочками наград. При необходимости вы можете изменить их с помощью кнопки Редактировать.

Создание цепочки наград

Чтобы создать цепочку наград:

1. Откройте проект в Личном кабинете.
2. В боковом меню нажмите Store.
3. В панели Акции и награды нажмите:
   • Подключить — если у вас еще нет акций или наград;
   • Настроить — если вы уже подключили акции или награды.

4. На вкладке Награды нажмите Создать награду.

5. Задайте необходимые параметры:
   • Укажите название цепочки наград.
   • Введите описание.
   • В раскрывающемся списке выберите призовые баллы.

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

8. Нажмите Сохранить.

9. Нажмите Далее.

10. Укажите период действия цепочки наград.

11. Нажмите Сохранить.

Цепочка наград создана и отображается в каталоге.

Чтобы активировать цепочку наград:

1. В каталоге наград выберите цепочку.
2. Нажмите ••• и в раскрывающемся списке выберите Активировать.

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

Для управления работой системы вознаграждений реализуйте методы подраздела Admin из группы методов Цепочки наград и призовые баллы.

1. Создайте призовые баллы, за которые будет предоставляться доступ к наградам в системе вознаграждений, с помощью метода API Создание призовых баллов.
2. Настройте товары, после покупки которых пользователи получают призовые баллы, с помощью метода API Настройте призовые баллы для товаров.
3. Создайте систему вознаграждений с помощью метода API Создайте цепочку наград.
4. Включите систему вознаграждений с помощью метода API Переключение цепочки наград.

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