Ежедневные награды
Как это работает
Ежедневные награды позволяют вам мотивировать пользователей заходить в магазин каждый день, чтобы получать бесплатные товары. Вы можете создавать награды следующих типов:
- Награда за вход — награды, которые открываются последовательно каждые 24 часа, начиная с момента первого входа пользователя в магазин.
- Календарь наград — награды, которые открываются каждый день в одно и то же установленное время для всех пользователей. Расписание наград при этом глобальное и не зависит от даты первого входа конкретного пользователя в магазин.
- Пример: Если пользователь впервые зашел в магазин в 4 день действия акции, он сразу увидит награду за 4 день цепочки.
В качестве наград можно выдавать следующие типы товаров:
- виртуальные предметы;
- виртуальную валюту;
- пакеты виртуальной валюты;
- бандлы.
Для ежедневных наград не учитываются следующие свойства товара:
- правила персонализации;
- ограничения на покупку;
- периоды доступности (даты начала и окончания);
- акции и скидки.
В интерфейсе ежедневные награды отображаются в виде цепочек наград, которые пользователи могут последовательно получать. Вы можете запускать повторяющиеся цепочки ежедневных наград, которые автоматически перезапускаются по завершении последнего дня в цепочке.
Для корректной работы ежедневных наград у вас должна быть настроена авторизация пользователей.
Неавторизованные пользователи видят всю цепочку ежедневных наград, но получать награды не могут.
Сценарий пользователя
- Пользователь заходит в магазин.
- Пользователь видит цепочку ежедневных наград и награду, которую он может получить за сегодняшний вход в игру.
- Пользователь авторизуется.
- Пользователь видит текущий прогресс в цепочке ежедневных наград.
- Пользователь получает ежедневную награду.
Настройка через Личный кабинет
Перед настройкой ежедневных наград вам нужно создать товары, которые пользователи будут бесплатно получать за вход в магазин.
Для создания товаров вручную в проекте в Личном кабинете перейдите в раздел Каталог товаров > Все товары. Подробная информация об этом и других способах создания товаров приведена в разделе документации Каталог товаров.
Создание ежедневных наград
Чтобы создать ежедневные награды:
- В проекте в Личном кабинете перейдите в раздел LiveOps-инструменты > Ежедневные награды.
- Нажмите Создать награды.
- Укажите:
- название цепочки ежедневных наград;
- описание (опционально).
- Нажмите Далее.
- Добавьте награду для дня цепочки. Для этого:
- Нажмите Добавить награду.
- Выберите товар, укажите количество, которое пользователи получат в качестве награды в этот день, и нажмите Сохранить.
- После того как вы добавили награды на каждый день, нажмите Далее.
- Выберите тип ежедневных наград — Награда за вход или Календарь наград. Тип задается только на этапе создания ежедневной награды, позднее вы не сможете его отредактировать.
- Укажите дату и время начала действия ежедневных наград.
- Для типа Награда за вход вы можете активировать переключатель Добавить ограничение по времени и указать дату и время окончания акции.
Для типа Календарь наград дата окончания рассчитывается автоматически исходя из количества дней, для которых созданы награды.
- Если вы хотите, чтобы цепочка с ежедневными наградами перезапускалась после ее завершения, активируйте переключатель Сделать акцию автообновляемой.
- Логика перезапуска зависит от типа цепочки:
- Цепочка типа Награда за вход перезапускается после завершения текущего цикла до наступления окончания акции.
- Пример: Цепочка из 5 наград, даты доступности с 1 по 31 октября. При включенной настройке пользователь сможет начать новый цикл получения наград после завершения текущего (при получении 5 наград или сбросе прогресса). Каждый новый цикл начинается с первой награды в цепочке. Перезапуск возможен в течение всего периода действия акции — до 31 октября включительно.
- Цепочка типа Календарь наград, перезапускается для всех пользователей с периодичностью, равной длине цепочки наград.
- Пример: Цепочка из 5 наград с датой начала акции 1 октября. При включенной настройке цепочка будет перезапускаться для всех пользователей каждые 5 дней — 6, 11, 16 октября и далее.
- Нажмите Создать.
- Пример: Цепочка из 5 наград, пользователь заходил в игру 3 дня подряд и пропустил 4. При входе в игру на 5 день:
- пользователь получит первую награду в цепочке, если настройка включена;
- пользователь получит четвертую награду в цепочке, если настройка выключена.
- Нажмите Создать.
- В проекте в Личном кабинете перейдите в раздел LiveOps-инструменты > Ежедневные награды.
- В строке необходимой цепочки нажмите ••• и в раскрывающемся списке выберите Активировать.
Редактирование ежедневных наград
Вы можете активировать, деактивировать и редактировать ежедневные награды. Для наград с типом Награда за вход также доступен сброс прогресса всех пользователей в текущем цикле ежедневных наград. Чтобы изменить настройки, нажмите ••• в строке ежедневной награды и выберите необходимое действие.
Активную цепочку ежедневных наград редактировать нельзя — перед изменениями ее нужно деактивировать.
Редактирование типа цепочки наград (Награда за вход или Календарь наград) недоступно. Вы можете задать этот параметр только на этапе создания ежедневной награды.
Для цепочек типа Награда за вход следующие изменения требуют сброса прогресса у всех пользователей:
- изменение настройки Сделать акцию автообновляемой;
- изменение настройки Сбрасывать прогресс пользователя при пропуске дня;
- добавление и удаление шагов.
После повторной активации цепочка начинается заново для всех пользователей, которые вошли в магазин после даты начала акции, включая тех, кто уже получил все награды.
Изменение названия, награды, описания, дат, времени или часового пояса не требует сброса прогресса — пользователи продолжат с того дня, на котором остановились.
Для цепочек типа Календарь наград изменения не требуют сброса прогресса.
Настройка через API
Для настройки и управления цепочками ежедневных наград через API используйте следующие методы подраздела Admin из группы методов Ежедневные награды:
| Задача | Метод API |
|---|---|
| Создать ежедневную награду. | Создание ежедневной награды. |
| Активировать ежедневную награду. | Передайте параметр “is_enabled”: true в метод Создание ежедневной награды или Обновление ежедневной награды. Вы также можете использовать метод Переключение ежедневной награды. |
| Обновить ежедневную награду. | Обновление ежедневной награды. |
| Деактивировать ежедневную награду. | Переключение ежедневной награды. |
| Удалить ежедневную награду. | Удаление ежедневной награды. |
Отображение ежедневных наград в магазине
Отображение на сайте, созданном с помощью Xsolla
Чтобы ежедневные награды отобразились на вашем сайте:
- В проекте в Личном кабинете перейдите в раздел Каналы продаж > Веб-сайты.
- Выберите ваш сайт и нажмите Открыть Site Builder.
- В основной части конструктора выберите место, где вы хотите добавить новый блок и нажмите Добавить блок.
- Выберите блок Ежедневные награды.
- В боковом меню перейдите к настройке блока.
- В раскрывающемся списке выберите цепочку ежедневных наград.
- Для проверки цепочки ежедневных наград в правом верхнем углу конструктора нажмите Просмотр.
- Чтобы изменения вступили в силу, опубликуйте сайт:
- В правом верхнем углу конструктора сайтов нажмите Опубликовать.
- Установите флажки напротив страниц, которые вы хотите опубликовать.
- Нажмите Опубликовать.
Если публикация сайта недоступна, убедитесь, что вы выполнили все необходимые условия:
- Отсутствуют незаполненные разделы на сайте (отмечены красным).
- Подписан лицензионный договор с Xsolla.
- Главная страница опубликована или выбрана для публикации. Вы не можете опубликовать дочерние страницы раньше главной.
Пользователи не увидят ежедневную цепочку наград до ее активации и начала периода ее действия.
Ежедневные цепочки предложений с истекшим сроком действия или цепочки, которые еще не начали действовать, отображаются в режиме предпросмотра в конструкторе сайтов. Этот режим позволяет вам просматривать все неопубликованные изменения, включая неактивные цепочки.
Отображение в собственном интерфейсе
- В интерфейсе приложения реализуйте элементы для отображения шагов цепочки ежедневных наград.
- Реализуйте логику работы с цепочками с помощью следующих клиентских методов API из группы методов Ежедневные награды:
- Убедитесь, что товары корректно начисляются пользователю.
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.
