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

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

Основная информация

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

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

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

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

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

  • В цепочке предложений не учитываются следующие свойства товара:
    • правила персонализации;
    • ограничения на покупку;
    • периоды доступности (даты начала и окончания);
    • акции и скидки.
  • Максимальное количество шагов в одной цепочке — 30.
  • На одном шаге может быть только один товар.
  • Вы не можете использовать один и тот же товар на разных шагах цепочки.

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

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

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

Отображение цепочки предложений происходит согласно следующей логике:

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

Возвраты товаров

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

Пример:

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

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

Примечание

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

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

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

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

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

  1. В проекте в Личном кабинете перейдите в раздел LiveOps-инструменты > Цепочки предложений.
  2. Нажмите Создать цепочку.
  3. Укажите:
    • Название цепочки.
    • Описание цепочки (опционально).
  4. Нажмите Далее.
  5. Настройте необходимое количество шагов цепочки:
    1. Нажмите Добавить уровень.
    2. В раскрывающемся списке Выберите артикул выберите товар.
    3. Если при создании товара у него указана цена, но вы хотите сделать его бесплатным, активируйте переключатель Бесплатная награда. При выборе бесплатного товара этот переключатель активируется автоматически.
    4. Нажмите Сохранить.
  1. Нажмите Далее.
  2. Укажите часовой пояс, дату и время, когда цепочка может стать доступной пользователям.
  3. Чтобы задать для цепочки ограничение по времени, активируйте переключатель Установить ограничение по времени и выберите дату и время. Без этой настройки цепочка будет считаться бессрочной.
  4. Чтобы настроить обновление цепочки, активируйте переключатель Сделать цепочку предложений автообновляемой, выберите необходимый пункт и укажите параметры, соответствующие периоду.
  5. Нажмите Создать.

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

  1. В проекте в Личном кабинете перейдите в раздел LiveOps-инструменты > Цепочки предложений.
  2. В строке необходимой цепочки нажмите ••• и в раскрывающемся списке выберите Опубликовать.

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

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

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

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

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

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

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

  1. В проекте в Личном кабинете перейдите в раздел Каналы продаж > Веб-сайты.
  2. Выберите ваш сайт и нажмите Открыть Site Builder.
  3. В основной части конструктора выберите место, где вы хотите добавить новый блок и нажмите Добавить блок.
  4. Выберите блок Offer chain.
  1. В боковом меню перейдите к настройке блока.
  2. В раскрывающемся списке выберите цепочку предложений.
  1. Кастомизируйте внешний вид блока (опционально):
    1. Настройте внешний вид цепочки.
    2. Настройте внешний вид шагов.
  1. Чтобы изменения вступили в силу, опубликуйте сайт:
    1. В правом верхнем углу конструктора сайтов нажмите Опубликовать.
    2. Установите флажки напротив страниц, которые вы хотите опубликовать.
    3. Нажмите Опубликовать.
Примечание

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

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

Отображение в собственном интерфейсе

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

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

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