Цепочки предложений

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

Обзор

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

Цепочка предложений может содержать уникальные товары, доступные только в рамках цепочки, а также товары по более выгодным ценам, чем в магазине. Это стимулирует пользователей возвращаться в игру и завершать прохождение, пока не истечет срок действия цепочки. Используйте этот маркетинговый инструмент, чтобы удерживать пользователей и повышать их вовлеченность.

В качестве товаров, предлагаемых на шагах цепочки, могут использоваться:

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

Ограничения:

  • Следующие настройки товаров игнорируются в цепочках предложений:
    • правила персонализации
    • ограничения на покупку
    • запланированная доступность (дата начала/окончания)
    • акции и скидки
  • Максимальное количество шагов в одной цепочке предложений — 30.
  • Один шаг может содержать только один товар.
  • Цена платного шага цепочки предложений равна цене товара на этом шаге.

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

  1. Пользователь заходит в магазин.
  2. Пользователь видит доступную цепочку предложений и предлагаемые товары для каждого шага.
  3. Пользователь авторизуется.
  4. Пользователь видит свой текущий прогресс в цепочке.
  5. Пользователь завершает текущий шаг:
    • Если шаг бесплатный, пользователь получает товар.
    • Если шаг платный, пользователь совершает платеж. Товар предоставляется пользователю так же, как при его покупке.
  6. Пользователь переходит к следующему шагу в цепочке.

Видимость и поведение цепочки предложений

Логика работы цепочек предложений:

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

Возвращенные товары

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

Пример:

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

Настройка цепочки предложений

Примечание

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

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

Для создания товаров вручную в проекте в Личном кабинете перейдите в раздел Каталог товаров > Все товары. Подробная информация об этом и других способах создания товаров приведена в разделах документации Каталог товаров и управление каталогом.

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

Примечание
Настройка акции также доступна через канвас.

Чтобы создать цепочку предложений:

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

  2. Если вы хотите сделать цепочку предложений персонализированной:

    1. Включите переключатель Personalized offer chain.
    2. Выберите один из вариантов отображения цепочки:
      • Show offer chain to specific users. Установите условия персонализации. В этом случае цепочка отображается только авторизованным пользователям, которые соответствуют указанным условиям.
      • Show offer chain to users who don’‎t meet conditions. Для такой цепочки вам не нужно указывать условия персонализации — они применяются по умолчанию. Это означает, что она отображается неавторизованным пользователям, а также в случаях, когда для авторизованного пользователя не найдена соответствующая цепочка предложений.
    3. Нажмите Next.
  1. Укажите часовой пояс, дату и время, когда цепочка может стать доступной пользователям.
  2. Чтобы ограничить цепочку по времени, включите переключатель Set time limit и укажите дату и время. Без этой настройки цепочка считается бессрочной.
  3. Чтобы настроить сброс цепочки, включите переключатель Make offer chain renewable, выберите необходимый срок действия и укажите требуемые параметры.
  4. Нажмите Create.

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

  1. В проекте в Личном кабинете перейдите в раздел LiveOps > Offer chains.
  2. В строке с цепочкой предложений нажмите ••• и выберите Activate в выпадающем списке.

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

Для настройки и управления цепочками предложений через API используйте следующие методы подраздела Admin из группы методов Цепочки предложений:

ЗадачаМетод API
Создать цепочку.Создание цепочки предложений.
Активировать цепочку.Передайте параметр “is_enabled”: true в метод Создание цепочки предложений или Обновление цепочки предложений. Вы также можете использовать метод Переключение цепочки предложений.
Сделать цепочку персонализированной.Создание цепочки предложений или Обновление цепочки предложений. Передайте в указанные методы условия для отображения цепочки в массиве attribute_conditions.
Вы также можете настроить видимость цепочки с помощью параметра is_always_visible. Логика отображения цепочки будет следующей:
  • “is_always_visible”: true — цепочка отображается всем пользователям.
  • “is_always_visible”: false и заданы условия отображения — цепочка считается персонализированной и отображается только для авторизованных пользователей, атрибуты которых удовлетворяют заданным условиям.
  • “is_always_visible”: false и не задано ни одного условия отображения — цепочка отображается неавторизованным пользователям и авторизованным пользователям, для которых не нашлось ни одной персонализированной цепочки.
Обновить цепочку.Обновление цепочки предложений.
Деактивировать цепочку.Переключение цепочки предложений.
Удалить цепочку.Удаление цепочки предложений.
Примечание
Если вы деактивируете или удалите активную цепочку, она станет недоступна для пользователей.

Отображение цепочки предложений в магазине

Отображение на сайте, созданном с помощью Xsolla

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

Чтобы цепочка предложений отобразилась на вашем сайте:

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

    • Из формы редактирования цепочки предложений в канвасе — нажмите Open или Open in Site Builder на баннере.
    • С любой страницы Личного кабинета:
      1. Перейдите в раздел Storefronts > Websites.
      2. Выберите ваш сайт и нажмите Open Site Builder.
  1. Если ваш сайт включает несколько страниц, выберите нужную:
    1. Нажмите на название текущей страницы в верхней части конструктора.
    2. Выберите необходимую страницу из выпадающего списка.
  2. В основной области конструктора выберите место, где вы хотите добавить новый блок, и нажмите Add block.
  3. Выберите блок Offer chain.
  1. В боковом меню перейдите в настройки блока.
  2. Из выпадающего списка выберите активную цепочку предложений.
  1. Кастомизируйте внешний вид блока (опционально):
    1. Настройте внешний вид цепочки.
    2. Настройте внешний вид шагов.
  1. Для проверки цепочки в правом верхнем углу конструктора нажмите Preview.
Примечание
Режим предварительного просмотра предназначен для тестирования, сайт в этом режиме может отличаться от опубликованной версии. Например, вы можете увидеть неактивные цепочки, а также повторно получать награды.
  1. Чтобы изменения вступили в силу, опубликуйте сайт:

    1. В правом верхнем углу конструктора сайтов нажмите Publish.
    2. Установите флажки напротив страниц, которые вы хотите опубликовать.
    3. Нажмите Publish.
Примечание

Если публикация сайта недоступна, убедитесь, что соблюдаются условия:

  • Отсутствуют незаполненные разделы на сайте (отмечены красным индикатором).
  • Подписан лицензионный договор с Xsolla.
  • Главная страница опубликована или выбрана для публикации. Вы не можете опубликовать дочерние страницы раньше главной.

Отображение в вашем собственном UI

  1. В интерфейсе приложения реализуйте элементы для отображения шагов цепочки.
  2. Реализуйте логику работы с цепочками с помощью следующих клиентских методов API из группы методов Цепочки предложений:
ЗадачаМетод API
Получить список доступных цепочек.Получение цепочек предложений для текущего пользователя.
Узнать прогресс пользователя.Получение цепочки предложений по ее ID для текущего пользователя.
Предоставить пользователю бесплатный товар.Получение награды за шаг цепочки предложений.
Предоставить пользователю платный товар.Создание заказа на награду за шаг цепочки предложений.
  1. Убедитесь, что товары корректно начисляются пользователю.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 11 августа 2026

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

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