Цепочки предложений
Как это работает
Обзор
Цепочка предложений — это последовательность шагов, каждый из которых содержит товар. Пользователь получает этот товар бесплатно или покупает в рамках действующего предложения, проходя цепочку шаг за шагом. Следующий шаг открывается только после завершения всех предыдущих.
Цепочка предложений может содержать уникальные товары, доступные только в рамках цепочки, а также товары по более выгодным ценам, чем в магазине. Это стимулирует пользователей возвращаться в игру и завершать прохождение, пока не истечет срок действия цепочки. Используйте этот маркетинговый инструмент, чтобы удерживать пользователей и повышать их вовлеченность.
В качестве товаров, предлагаемых на шагах цепочки, могут использоваться:
- пакеты виртуальной валюты;
- виртуальные предметы;
- бандлы.
Ограничения:
- Следующие настройки товаров игнорируются в цепочках предложений:
- правила персонализации
- ограничения на покупку
- запланированная доступность (дата начала/окончания)
- акции и скидки
- Максимальное количество шагов в одной цепочке предложений — 30.
- Один шаг может содержать только один товар.
- Цена платного шага цепочки предложений равна цене товара на этом шаге.
Сценарий пользователя
- Пользователь заходит в магазин.
- Пользователь видит доступную цепочку предложений и предлагаемые товары для каждого шага.
- Пользователь авторизуется.
- Пользователь видит свой текущий прогресс в цепочке.
- Пользователь завершает текущий шаг:
- Если шаг бесплатный, пользователь получает товар.
- Если шаг платный, пользователь совершает платеж. Товар предоставляется пользователю так же, как при его покупке.
- Пользователь переходит к следующему шагу в цепочке.

Видимость и поведение цепочки предложений
Логика работы цепочек предложений:
- Доступность цепочки предложений зависит от настроек видимости и персонализации, настроенных для конкретной цепочки.
- Если пользователь уже получал или покупал товары в рамках цепочки, отображается его текущий прогресс с указанием завершенных шагов и следующего доступного.
- Если пользователь завершает все шаги, цепочка отображается как завершенная.
- Если цепочка возобновляемая, прогресс пользователя сбрасывается по расписанию.
Возвращенные товары
При возврате оплаченного товара прогресс пользователя в цепочке предложений изменяется: шаг, на котором был получен возвращенный товар, считается непройденным. Чтобы продвигаться дальше по цепочке, пользователю необходимо заново приобрести товар, связанный с этим шагом. При этом все полученные до возврата награды сохраняются.
Пример:
Пользователь получил и купил товары на шагах 1, 2 и 3, затем вернул товар со 2 шага. Шаги 1 и 3 останутся пройденными, но доступ к 4 шагу будет заблокирован, пока пользователь заново не пройдет 2 шаг.
Настройка цепочки предложений
Перед тем как создать цепочку предложений, вам необходимо настроить товары. Обратите внимание:
- Если вы хотите, чтобы товар был доступен только через цепочку, установите его статус на частично доступен.
- Если пользователь покупает товар вне цепочки предложений, это не влияет на его прогресс в цепочке.
Для создания товаров вручную в проекте в Личном кабинете перейдите в раздел Каталог товаров > Все товары. Подробная информация об этом и других способах создания товаров приведена в разделах документации Каталог товаров и управление каталогом.
Настройка через Личный кабинет
Чтобы создать цепочку предложений:
- В проекте в Личном кабинете перейдите в раздел LiveOps > Offer chains.
- Нажмите Create offer chain.
- Укажите:
- Название цепочки.
- Описание цепочки (опционально).
- Нажмите Next.
- Настройте необходимое количество шагов цепочки:
- Нажмите Add step.
- В Select SKU выпадающем списке выберите товар.
- Если при создании товара у него указана цена, но вы хотите сделать его бесплатным, активируйте переключатель Offer free reward. При выборе бесплатного товара этот переключатель активируется автоматически.
- Нажмите Save.

Нажмите Next.
Если вы хотите сделать цепочку предложений персонализированной:
- Включите переключатель Personalized offer chain.
- Выберите один из вариантов отображения цепочки:
- Show offer chain to specific users. Установите условия персонализации. В этом случае цепочка отображается только авторизованным пользователям, которые соответствуют указанным условиям.
- Show offer chain to users who don’t meet conditions. Для такой цепочки вам не нужно указывать условия персонализации — они применяются по умолчанию. Это означает, что она отображается неавторизованным пользователям, а также в случаях, когда для авторизованного пользователя не найдена соответствующая цепочка предложений.
- Нажмите Next.
- Укажите часовой пояс, дату и время, когда цепочка может стать доступной пользователям.
- Чтобы ограничить цепочку по времени, включите переключатель Set time limit и укажите дату и время. Без этой настройки цепочка считается бессрочной.
- Чтобы настроить сброс цепочки, включите переключатель Make offer chain renewable, выберите необходимый срок действия и укажите требуемые параметры.
- Нажмите Create.
Чтобы цепочка стала доступна пользователям, активируйте ее. Для этого:
- В проекте в Личном кабинете перейдите в раздел LiveOps > Offer chains.
- В строке с цепочкой предложений нажмите ••• и выберите Activate в выпадающем списке.
Настройка через API
Для настройки и управления цепочками предложений через API используйте следующие методы подраздела Admin из группы методов Цепочки предложений:
| Задача | Метод API |
|---|---|
| Создать цепочку. | Создание цепочки предложений. |
| Активировать цепочку. | Передайте параметр “is_enabled”: true в метод Создание цепочки предложений или Обновление цепочки предложений. Вы также можете использовать метод Переключение цепочки предложений. |
| Сделать цепочку персонализированной. | Создание цепочки предложений или Обновление цепочки предложений. Передайте в указанные методы условия для отображения цепочки в массиве attribute_conditions.Вы также можете настроить видимость цепочки с помощью параметра is_always_visible. Логика отображения цепочки будет следующей:
|
| Обновить цепочку. | Обновление цепочки предложений. |
| Деактивировать цепочку. | Переключение цепочки предложений. |
| Удалить цепочку. | Удаление цепочки предложений. |
Отображение цепочки предложений в магазине
Отображение на сайте, созданном с помощью Xsolla
Чтобы цепочка предложений отобразилась на вашем сайте:
Перейдите в конструктор сайта, где вы хотите добавить цепочку предложений, одним из следующих способов:
- Из формы редактирования цепочки предложений в канвасе — нажмите Open или Open in Site Builder на баннере.
- С любой страницы Личного кабинета:
- Перейдите в раздел Storefronts > Websites.
- Выберите ваш сайт и нажмите Open Site Builder.
- С любой страницы Личного кабинета:
- Если ваш сайт включает несколько страниц, выберите нужную:
- Нажмите на название текущей страницы в верхней части конструктора.
- Выберите необходимую страницу из выпадающего списка.
- В основной области конструктора выберите место, где вы хотите добавить новый блок, и нажмите Add block.
- Выберите блок Offer chain.

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

- Кастомизируйте внешний вид блока (опционально):
- Настройте внешний вид цепочки.
- Настройте внешний вид шагов.
- Для проверки цепочки в правом верхнем углу конструктора нажмите Preview.
Чтобы изменения вступили в силу, опубликуйте сайт:
- В правом верхнем углу конструктора сайтов нажмите Publish.
- Установите флажки напротив страниц, которые вы хотите опубликовать.
- Нажмите Publish.
Если публикация сайта недоступна, убедитесь, что соблюдаются условия:
- Отсутствуют незаполненные разделы на сайте (отмечены красным индикатором).
- Подписан лицензионный договор с Xsolla.
- Главная страница опубликована или выбрана для публикации. Вы не можете опубликовать дочерние страницы раньше главной.
Отображение в вашем собственном UI
- В интерфейсе приложения реализуйте элементы для отображения шагов цепочки.
- Реализуйте логику работы с цепочками с помощью следующих клиентских методов API из группы методов Цепочки предложений:
| Задача | Метод API |
|---|---|
| Получить список доступных цепочек. | Получение цепочек предложений для текущего пользователя. |
| Узнать прогресс пользователя. | Получение цепочки предложений по ее ID для текущего пользователя. |
| Предоставить пользователю бесплатный товар. | Получение награды за шаг цепочки предложений. |
| Предоставить пользователю платный товар. | Создание заказа на награду за шаг цепочки предложений. |
- Убедитесь, что товары корректно начисляются пользователю.
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.