Система вознаграждений
Глоссарий
Система вознаграждений
Цепочка наград
Уровень
Призовые баллы
Награда
Как это работает
Система вознаграждений дает вам возможность регулярно поощрять пользователей за внутриигровые покупки, совершенные за реальную валюту. В этом случае пользователи получают дополнительную мотивацию использовать внутриигровой магазин или веб-магазин.
Вы можете создавать цепочки наград, выдавая награды за определенное количество потраченной реальной валюты. В игре может быть несколько цепочек. Максимальная длина одной цепочки — 31 уровень. У каждого уровня есть условие выполнения — это набор заданного количества призовых баллов, которые отражают прогресс пользователя в системе вознаграждений.
За каждый уровень пользователь может получить от 1 до 10 наград.
В качестве наград можно выдавать следующие типы товаров:
- виртуальные предметы;
- виртуальную валюту;
- пакеты виртуальной валюты;
- бандлы.
Неавторизованные пользователи могут видеть цепочки наград, но не прогресс их получения. Количество заработанных призовых баллов и прогресс в системе вознаграждений отображается пользователю после авторизации.
Сценарий пользователя
- Пользователь переходит на сайт.
- Пользователь видит каталог товаров, доступные награды и то, сколько призовых баллов можно получить за покупку каждого товара.
- Пользователь авторизуется или регистрируется на сайте.
- Пользователь видит свой прогресс в системе вознаграждений и может продвинуться по цепочкам наград, получая призовые баллы за покупку товаров.
Как настроить
Чтобы настроить систему вознаграждений, вам потребуется следующая информация:
- дата начала и дата окончания действия системы вознаграждений;
- изображение, описание, артикулы и названия призовых баллов, которые обеспечивают прогресс в цепочке наград;
- количество призовых баллов и предметы в цепочке наград.
Примеры предоставления информации приведены ниже.
Цепочка наград:
Описание | Пример | Ограничения |
---|---|---|
Название | Xsolla bonus system | Максимальное количество символов — 35. |
Сопроводительный текст | Завершение каждого уровня дает вам уникальные награды. Собирайте осколки и получайте доступ к более крутым наградам! | Максимальное количество символов — 175. |
Срок действия | 01.05.2023 — 31.05.2023 | |
Размер изображения | 1065 x 515 px |
Описание | Пример | Ограничения |
---|---|---|
Название уровня | Tier 1 | Максимальное количество символов — 35. |
Размер изображения | 200 x 200 px | Поддерживаемые форматы: PNG, JPG. |
Количество накопленных призовых баллов, при котором пользователь получает награду | 25 | |
Список с артикулами предметов и количеством наград, которые пользователь получает на этом уровне | sword_1 x 1, coin_pack_50 x 2 |
Описание | Пример |
---|---|
Название | Осколок |
Сопроводительный текст | Собирайте осколки, чтобы получать награды. |
Артикул | ExampleSKU003 |
Изображение или его URL-адрес |
Уровень | Призовые баллы |
---|---|
Уровень 1 | 5 |
Уровень 2 | 10 |
Уровень 3 | 15 |
Уровень 4 | 20 |
Уровень 5 | 30 |
Уровень 6 | 40 |
Уровень 7 | 60 |
Уровень 8 | 80 |
Уровень 9 | 100 |
Уровень 10 | 150 |
Уровень 11 и последующие уровни | Предыдущий уровень + 50 |
Описание | Пример |
---|---|
Артикул товара, за покупку которого выдаются призовые баллы | Helmet_1 |
Количество призовых баллов, выдаваемое после покупки товара | 10 |
- отображение элементов системы вознаграждений в магазине:
- количество призовых баллов, которые выдаются за покупку товаров в каталоге;
- призовые баллы;
- уровни;
- цепочки наград;
- баланс призовых баллов авторизованного пользователя;
- награды;
- интеграцию методов получения вознаграждений.
Для корректной работы системы вознаграждений у вас на сайте должна быть настроена авторизация пользователя в каталоге.
Если вы используете Web Shop или Site Builder Xsolla, то отображение элементов системы вознаграждений и интеграция методов API на вашей стороне не требуется.
- Get virtual items list
- Get current user’s reward chains
- Get current user’s value point balance
- Claim step reward
Настройка через Личный кабинет
Перед тем как создавать цепочку наград, вам нужно создать призовые баллы.
Создание призовых баллов
Чтобы создать призовые баллы:
- Откройте проект в Личном кабинете.
- В боковом меню нажмите Store.
- В панели Акции и награды нажмите:
- Подключить — если у вас еще нет акций или наград;
- Настроить — если вы уже подключили акции или награды.
- На вкладке Награды нажмите Создать призовые баллы.
- Задайте необходимые параметры:
- Добавьте изображение (опционально).
- Введите уникальный артикул призового балла.
- Укажите название.
- Нажмите Далее.
- Нажмите + и выберите артикул виртуального товара и количество призовых баллов, которые пользователь получит за покупку этого товара.
- Нажмите Сохранить.
Призовые баллы созданы и отображаются над цепочками наград. При необходимости вы можете изменить их с помощью кнопки Редактировать.
Создание цепочки наград
Чтобы создать цепочку наград:
- Откройте проект в Личном кабинете.
- В боковом меню нажмите Store.
- В панели Акции и награды нажмите:
- Подключить — если у вас еще нет акций или наград;
- Настроить — если вы уже подключили акции или награды.
- На вкладке Награды нажмите Создать награду.
- Задайте необходимые параметры:
- Укажите название цепочки наград.
- Введите описание.
- В раскрывающемся списке выберите призовые баллы.
- Нажмите Далее.
- Введите следующую информацию для создания уровня:
- Укажите название уровня.
- Введите количество призовых баллов, которые нужно набрать, чтобы получить награду.
- Укажите количество виртуальных товаров в награде.
- Нажмите Сохранить.
Рекомендуемое максимальное количество уровней — 31.
- Нажмите Далее.
- Укажите период действия цепочки наград.
- Нажмите Сохранить.
Цепочка наград создана и отображается в каталоге.
Чтобы активировать цепочку наград:
- В каталоге наград выберите цепочку.
- Нажмите ••• и в раскрывающемся списке выберите Активировать.
Настройка через методы API
Для управления работой системы вознаграждений реализуйте методы подраздела Admin из группы методов Reward chains & Value points.
- Создайте призовые баллы, за которые будет предоставляться доступ к наградам в системе вознаграждений, с помощью метода API Create value point.
- Настройте товары, после покупки которых пользователи получают призовые баллы, с помощью метода API Set value points for items.
- Создайте систему вознаграждений с помощью метода API Create reward chain.
- Включите систему вознаграждений с помощью метода API Toggle reward chain.
Также вы можете изменять, отключать или удалять систему вознаграждений, а также удалять призовые баллы у товаров.
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.