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

Глоссарий

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Цепочка вознаграждений:

Описание	Пример	Ограничения
Название	Xsolla bonus system	Максимальное количество символов — 35.
Сопроводительный текст	Выполнение каждого шага дает вам уникальные награды. Собирайте осколки и получайте доступ к более крутым наградам!	Максимальное количество символов — 175.
Срок действия	01.05.2023 — 31.05.2023
Размер изображения	1065 x 515 px

Шаг цепочки вознаграждений:

Описание	Пример	Ограничения
Название шага	Tier 1	Максимальное количество символов — 35.
Количество накопленных очков наград, при котором пользователь получает награду	25
Список с артикулами предметов и количеством наград, которые пользователь получает на этом шаге	sword_1 x 1, coin_pack_50 x 2
Размер изображения	18 x 18 px

Очки наград:

Описание	Пример
Название	Осколок
Сопроводительный текст	Собирайте осколки, чтобы получать награды.
Артикул	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 на вашей стороне не требуется.

Для работы системы вознаграждений реализуйте вызов методов API:

• Get virtual items list
• Get current user's reward chains
• Get current user's value point balance
• Claim step reward

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

Для управления работой системы вознаграждений реализуйте методы подраздела Admin из группы методов Reward chains & Value points.

1. Создайте очки наград, за которые будет предоставляться доступ к наградам в системе вознаграждений, с помощью метода API Create value point.
2. Настройте товары, после покупки которых пользователи получают очки наград, с помощью метода API Set value points for items.
3. Создайте систему вознаграждений с помощью метода API Create reward chain.
4. Включите систему вознаграждений с помощью метода API Toggle reward chain.

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

Примечание
Если вы захотите удалить очки наград с одного или нескольких товаров с помощью метода Delete value points from items, очки наград будут удалены со всех товаров.

Была ли статья полезна?

Спасибо!

Что может сделать страницу еще лучше? Сообщение Отправить

Жаль, что так произошло

Расскажите, почему статья не была полезна. Сообщение Отправить

Спасибо за обратную связь!

Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Оценить страницу


Оценить страницу

Что может сделать страницу еще лучше? Отправить

В другой раз

Спасибо за обратную связь!

Последнее обновление: 28 ноября 2023

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