In-Game Store / Система вознаграждений
  На главную

In-Game Store

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

Глоссарий

Система вознаграждений
Система, которая дает возможность поощрять пользователей за внутриигровые покупки, совершенные за реальную валюту.
Цепочка наград
Набор уровней, которые должен завершить пользователь, чтобы получить награду.
Уровень
Уровень цепочки наград, на котором пользователь, накопив нужное количество призовых баллов, получает награду.
Призовые баллы
Очки, которые отображают прогресс пользователя в системе вознаграждений.
Награда
Товар, полученный пользователем в результате накопления установленного количества призовых баллов.

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

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

Вы можете создавать цепочки наград, выдавая награды за определенное количество потраченной реальной валюты. В игре может быть несколько цепочек. Максимальная длина одной цепочки — 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.
Размер изображения200 x 200 pxПоддерживаемые форматы: PNG, JPG.
Количество накопленных призовых баллов, при котором пользователь получает награду25
Список с артикулами предметов и количеством наград, которые пользователь получает на этом уровнеsword_1 x 1, coin_pack_50 x 2
Призовые баллы:
ОписаниеПример
НазваниеОсколок
Сопроводительный текстСобирайте осколки, чтобы получать награды.
АртикулExampleSKU003
Изображение или его URL-адресCrystal
Рекомендуемые значения для призовых баллов:
УровеньПризовые баллы
Уровень 15
Уровень 210
Уровень 315
Уровень 420
Уровень 530
Уровень 640
Уровень 760
Уровень 880
Уровень 9100
Уровень 10150
Уровень 11 и последующие уровниПредыдущий уровень + 50
Призовые баллы, выдаваемые за покупку определенных товаров:
ОписаниеПример
Артикул товара, за покупку которого выдаются призовые баллыHelmet_1
Количество призовых баллов, выдаваемое после покупки товара10
На своей стороне реализуйте:
  • отображение элементов системы вознаграждений в магазине:
    • количество призовых баллов, которые выдаются за покупку товаров в каталоге;
    • призовые баллы;
    • уровни;
    • цепочки наград;
    • баланс призовых баллов авторизованного пользователя;
    • награды;
  • интеграцию методов получения вознаграждений.
Примечание

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

Если вы используете Web Shop или Site Builder Xsolla, то отображение элементов системы вознаграждений и интеграция методов API на вашей стороне не требуется.

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

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

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

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

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

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

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

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

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

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

Примечание
Виртуальные товары должны быть созданы заранее.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Настройка через методы 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, призовые баллы будут удалены со всех товаров.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 3 октября 2024

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

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