Appearance
События программы лояльности
События программы лояльности генерирует платформа, когда меняется участие клиента в программе: он вступает в программу, меняет уровень, приглашает друга, оформляет или теряет платную подписку. Передавать эти события отдельно не нужно — они возникают из вызовов 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 | Название тарифа |
Сценарии:
- Оформление — приветствие и список преимуществ подписки.
- Скорое окончание — напоминание продлить подписку. Стоп-событие — «Подписка продлена».
- Просрочка — предложение вернуться со скидкой на первый месяц.
- Отмена — опрос о причинах отмены.