Skip to content

События программы лояльности ​

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

События доступны при подключенной программе лояльности. О сгорании бонусов — в отдельной статье Сгорание бонусов.

Во всех сообщениях программы лояльности доступны переменные loyalty_balance_active_bonuses, loyalty_balance_pending_bonuses и loyalty_current_level.

Участие в программе ​

СобытиеКлючКогда срабатывает
Регистрация в программе лояльностиloyalty_joinПри вызове метода вступления в программу для нового участника. Повторный вызов для существующего участника событие не создает
Регистрация в реферальной программеreferral_joinПри вызове метода вступления в реферальную программу

Переменные события «Регистрация в реферальной программе»:

ПеременнаяОписание
referral_program_idИдентификатор реферальной программы
referral_program_nameНазвание реферальной программы
referral_codeРеферальный код клиента

Типичная цепочка на регистрацию — приветствие с рассказом о программе и приветственными бонусами. На регистрацию в реферальной программе — письмо с реферальным кодом, которым можно поделиться.

Уровни ​

СобытиеКлючКогда срабатывает
Повышение уровня программы лояльностиloyalty_level_upКлиент получил первый уровень или перешел на более высокий
Понижение уровня программы лояльностиloyalty_level_downСрок действия уровня истек, и клиент перешел на более низкий уровень
Понижение уровня через N днейloyalty_level_down_soonДо окончания срока уровня осталось N дней, а покупок за период не хватает для его сохранения

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

Количество дней для события «Понижение уровня через N дней» задается в настройках программы лояльности. Событие получают клиенты, у которых есть покупки за расчетный период, но их недостаточно для сохранения уровня.

Название уровня доступно в переменной loyalty_current_level.

Сценарии:

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

Платные подписки ​

События платных подписок программы лояльности:

СобытиеКлючКогда срабатывает
Клиент оформил подпискуloyalty_subscription_joinПри вызове метода оформления подписки, в том числе при смене тарифа
Клиент отменил подпискуloyalty_subscription_cancelПри вызове метода отмены подписки
Подписка продленаloyalty_subscription_prolongПри вызове метода продления подписки
Подписка скоро закончитсяloyalty_subscription_expire_soonЗа 3 дня до окончания оплаченного периода. Проверяется раз в сутки
Подписка просроченаloyalty_subscription_expiredНа следующий день после окончания оплаченного периода, если подписка не продлена

Переменные всех событий подписок:

ПеременнаяОписание
loyalty_subscription_codeКод подписки
loyalty_subscription_nameНазвание подписки
loyalty_subscription_plan_codeКод тарифа
loyalty_subscription_plan_nameНазвание тарифа

Сценарии:

  • Оформление — приветствие и список преимуществ подписки.
  • Скорое окончание — напоминание продлить подписку. Стоп-событие — «Подписка продлена».
  • Просрочка — предложение вернуться со скидкой на первый месяц.
  • Отмена — опрос о причинах отмены.