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

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

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

Глоссарий

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

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

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

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

Логика уровней и цены

Каждый уровень цепочки предложений связан с конкретным артикулом товара. Цена уровня определяется автоматически на основе цены этого товара:

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

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

Видимость и поведение товара

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

Игнорируемые свойства товара

Цепочка предложений не учитывает следующие параметры товара:

  • правила персонализации;
  • ограничения на покупку;
  • периоды доступности (даты начала и окончания);
  • акции и скидки.

Ограничения

  • Максимум 30 уровней в одной цепочке.
  • Каждый уровень должен содержать один товар.

Возвраты

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

Примечание
Все полученные до возврата награды сохраняются. Повторные покупки и возвраты автоматически отслеживаются и учитываются в истории прогресса пользователя.

Пример:

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

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

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

Как настроить

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

ОписаниеПримерОграничения
НазваниеWelcome Offer ChainДо 35 символов
ОписаниеПолучайте уникальные награды на каждом уровне.До 175 символов
Дата начала и окончания цепочки предложений01.07.2023 — 15.07.2023Необязательно
Примечание
Если дата окончания не указана, цепочка предложений будет действовать бессрочно.
Чтобы настроить уровень цепочки предложений, вам потребуется указать:
ОписаниеПримерОграничения
Содержимое уровняsword_1Артикул должен существовать в каталоге.
Примечание
На этапе настройки цепочки предложений не требуется указывать изображения товаров — они уже заданы в их индивидуальных настройках. Указывая артикул товара для конкретного уровня цепочки, система автоматически подтягивает название и изображение соответствующего товара.
В интерфейсе вашего магазина реализуйте отображение:
  • уровней цепочки предложений и их статуса;
  • времени действия цепочки предложений;
  • прогресса пользователя;
  • разблокированных предложений с кнопками действия.

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

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

Создание цепочки предложений

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

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

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

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

Удаление цепочки предложений

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

  1. В проекте в Личном кабинете перейдите в раздел LiveOps-инструменты > Цепочки предложений.
  2. Нажмите значок справа от нужной цепочки предложений.
  3. Нажмите Удалить.

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

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

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

Вы также можете изменять, отключать или удалять цепочки предложений.

Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 8 октября 2025

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

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