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

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

Обзор

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

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

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

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

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

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

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

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

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

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

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

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

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

Пример:

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

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

Примечание

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

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

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

Примечание

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

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

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

Примечание

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

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

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

Примечание

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

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

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

Примечание

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

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

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

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

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

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

  1. В проекте в Личном кабинете перейдите в раздел LiveOps > Offer chains.
  1. В проекте в аккаунте перейдите в раздел LiveOps > Offer chains.
  1. Нажмите Create offer chain.
  2. Укажите:
    • Название цепочки.
    • Описание цепочки (опционально).
  3. Нажмите Next.
  4. Настройте необходимое количество шагов цепочки:
    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.
  1. В проекте в аккаунте перейдите в раздел LiveOps > Offer chains.
  1. В строке с цепочкой предложений нажмите ••• и выберите Activate в выпадающем списке.

Настройка в аккаунте

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

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

  1. В проекте в Личном кабинете перейдите в раздел LiveOps > Offer chains.
  1. В проекте в аккаунте перейдите в раздел LiveOps > Offer chains.
  1. Нажмите Create offer chain.
  2. Укажите:
    • Название цепочки.
    • Описание цепочки (опционально).
  3. Нажмите Next.
  4. Настройте необходимое количество шагов цепочки:
    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.
  1. В проекте в аккаунте перейдите в раздел LiveOps > Offer chains.
  1. В строке с цепочкой предложений нажмите ••• и выберите Activate в выпадающем списке.

Настройка в канвасе

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

  1. В вашем проекте в Личном кабинете перейдите в раздел LiveOps-инструменты > Canvas.
  1. В проекте в вашем аккаунте для мобильных игр перейдите в раздел Operation > LiveOps.
  1. В проекте в вашем аккаунте перейдите в раздел LiveOps > Canvas.
  1. В проекте в вашем аккаунте перейдите в раздел LiveOps > More > Canvas.
  1. Приступите к созданию цепочки предложений одним из следующих способов:
    • На панели инструментов нажмите значок + и выберите Offer chain.
    • В области списка цепочек предложений нажмите значок +.
    • Откройте контекстное меню в любом месте на канвасе и выберите Offer chain.
  1. Укажите:
    • Название цепочки.
    • Описание цепочки (опционально).
  2. Нажмите Next.
  3. Добавьте предложение для каждого шага цепочки. Чтобы добавить элемент для одного шага:
    1. Нажмите Add step.
    2. Выберите элемент.
    3. Если вы указали цену при создании элемента, но хотите предложить его бесплатно, включите переключатель Give this item for free at this step. Для элементов, созданных как бесплатные, этот переключатель включен автоматически.
    4. Нажмите Add step.
  1. Чтобы изменить порядок предложений в цепочке, перетащите строку в нужное положение, используя значок (опционально).
  2. После того как вы добавили предложения для каждого шага, нажмите Next.
  3. Укажите срок действия цепочки предложений: часовой пояс, дату начала и дату окончания. Если вы не хотите указывать конец срока действия, включите переключатель No end date.
  4. Если вы хотите, чтобы цепочка предложений обновлялась в определенное время, включите переключатель Make offer chain renewable и укажите расписание обновления.
  5. Если вы хотите персонализировать цепочку предложений:
    1. Включите переключатель Personalized offer chain.
    2. Выберите один из вариантов отображения цепочки:
      • Display to eligible users — в этом случае цепочка отображается только авторизованным пользователям, которые соответствуют указанным условиям.
      • Display to ineligible users — для такой цепочки вам не нужно указывать условия персонализации — они применяются по умолчанию. Это означает, что она отображается неавторизованным пользователям, а также в случаях, когда для авторизованного пользователя не найдена соответствующая персонализированная цепочка предложений.
    3. Если вы выбрали вариант Display to eligible users, укажите условие:
      1. Укажите тип атрибута пользователя — строка, число или дата.
      2. Выберите атрибут пользователя из выпадающего списка.
      3. Выберите оператор сравнения.
      4. Укажите значение атрибута пользователя.
    4. Чтобы добавить больше условий, нажмите Add condition и заполните отображаемые поля (опционально).
  1. Нажмите Next.
  2. Проверьте цепочку.
  3. Чтобы активировать цепочку сразу (опционально), включите переключатель Create in Active status.
  4. Нажмите Create.
  5. Чтобы добавить созданную активную цепочку предложений на сайт (опционально):
    1. Откройте сайт в конструкторе, нажав Open или Open in Site Builder на баннере в форме редактирования.
    2. Следуйте инструкциям из раздела Display on website created with Xsolla.
Примечание

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

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

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

Настройка через 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. Перейдите в раздел Web Shop.
      2. Нажмите на панель вашего сайта.
    • С любой страницы вашего аккаунта:
      1. Перейдите в раздел Web Shop.
      2. Нажмите на панель вашего сайта.
    • С любой страницы вашего аккаунта:
      1. Перейдите в раздел Web Shop.
      2. Нажмите на панель вашего сайта.
    • С любой страницы вашего аккаунта:
      1. Перейдите в раздел Web Shop.
      2. Нажмите на панель вашего сайта.
  1. Если ваш сайт включает несколько страниц, выберите нужную:
    1. Нажмите на название текущей страницы в верхней части конструктора.
    2. Выберите необходимую страницу из выпадающего списка.
  2. В основной области конструктора выберите место, где вы хотите добавить новый блок, и нажмите Add block.
  3. Выберите блок Offer chain.
  1. В боковом меню перейдите в настройки блока.
  2. Из выпадающего списка выберите активную цепочку предложений.
  1. Кастомизируйте внешний вид блока (опционально):
    1. Настройте внешний вид цепочки.
    2. Настройте внешний вид шагов.
  1. Для проверки цепочки в правом верхнем углу конструктора нажмите Просмотр.
Примечание
Режим предварительного просмотра предназначен для тестирования, сайт в этом режиме может отличаться от опубликованной версии. Например, вы можете увидеть неактивные цепочки, а также повторно получать награды.
  1. Чтобы изменения вступили в силу, опубликуйте сайт:

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

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

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

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

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

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

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