По каким событиям можно запустить сценарий

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

Есть контексты фильтров, ожидания и параметры, которые доступны во всех сценариях и механиках. Событие же несет информацию конкретно о себе, поэтому в сценарии становятся доступны дополнительные фильтры и ожидания, а в рассылках можно выводить данные по событию.
Например, в сценарии по заказу можно задавать условия по конкретному заказу, ставить ожидание по его дополнительному полю и использовать рассылку с выводом данных по нему с помощью параметра Order.

В данной статье рассмотрим все события, в ответ на которые можно настроить сценарий, и их особенности.

Окончена сессия

Сессией считается нахождение клиента на сайте с установленным трекером Mindbox. Она автоматически закрывается через полчаса после бездействия клиента на сайте. Также ее можно завершить принудительно, введя на вкладке ’Консоль’ инструментов разработчика:

mindbox("closeSession")

Фильтры:

• по сессии

Параметры:

• Session

Примеры использования:

• Сценарий по брошенной сессии — как отправить клиенту рассылку после ухода с сайта без заказа.

Заказ добавлен или изменен

Заказ попал на проект или произошло любое изменение. Даже если в изменении пришли те же данные с тем же статусом: если есть действие по заказу — сценарий запускается.

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

     

     Например, сценарий сразу после заказа отправляет рассылку; актуальность у группы шагов — сутки. Заказ попал в базу 10 июня в 10:00 с переданной датой заказа 6 июня 20:00. Шаг мог сработать с 6 июня 20:00 до 7 июня 20:00 (с учетом актуаности группы шагов в сутки). Это время уже прошло, поэтому сценарий откидывает событие и не срабатывает по нему.

     Немного изменим сценарий из примера: допустим, между заказом и рассылкой стоит ожидание в 3 дня. 3 дня опять же отсчитаются от даты, с которой пришло действие, то есть рассылка может отправиться с 9 июня 20:00 до 10 июня 20:00. Заказ попадает в актуальность шага, поэтому сценарий отрабатывает по нему.

  2. Не должно быть изменения по заказу с более поздней датой. Ведь в таком случае пришедшие данные уже не самые актуальные по заказу.

Фильтры:

• по заказу
• по действию

Динамическое ожидание:

• из поля заказа
• из поля действия

Параметры:

• Order
• CustomerAction

Примеры использования:

• Сценарий «Ваш заказ оформлен» — как сообщить клиенту об успешном создании заказа.

Статус заказа изменен

Заказ перешел в выбранный статус. В том числе сразу пришел в нужном статусе.

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

     

     Например, сценарий сразу после заказа отправляет рассылку; актуальность у группы шагов — сутки. Заказ попал в базу 10 июня в 10:00 с переданной датой заказа 6 июня 20:00. Шаг мог сработать с 6 июня 20:00 до 7 июня 20:00 (с учетом актуаности группы шагов в сутки). Это время уже прошло, поэтому сценарий откидывает событие и не срабатывает по нему.

     Немного изменим сценарий из примера: допустим, между заказом и рассылкой стоит ожидание в 3 дня. 3 дня опять же отсчитаются от даты, с которой пришло действие, то есть рассылка может отправиться с 9 июня 20:00 до 10 июня 20:00. Заказ попадает в актуальность шага, поэтому сценарий отрабатывает по нему.

  2. Не должно быть изменения по заказу с более поздней датой. Ведь в таком случае пришедшие данные уже не самые актуальные по заказу.

Все позиции заказа перешли

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

Любая позиция заказа перешла

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

Фильтры:

• по заказу
• по действию

Динамическое ожидание:

• из поля заказа
• из поля действия

Параметры:

• Order
• CustomerAction

Клиент приобрел продукт (позиция доставлена)

Позиция заказа перешла в статус «Доставлена». В том числе сразу пришла в данном статусе.
Запускается на каждую доставленную позицию, даже если они пришли в одном заказе. То есть доставка заказа с двумя позициями запустит сценарий два раза.

• Работает повторно по позиции, если что-то в ней поменялось (цена, количество, дополнительные поля).
• На заказах с процессингом сценарий запускается при условии завершения транзакции.
• На заказах, добавленных задним числом, сценарий срабатывает, но есть два ньюанса:
  1. Действие должно попадать в актуальность группы шагов.
     Как это работает

     

     Например, сценарий сразу после заказа отправляет рассылку; актуальность у группы шагов — сутки. Заказ попал в базу 10 июня в 10:00 с переданной датой заказа 6 июня 20:00. Шаг мог сработать с 6 июня 20:00 до 7 июня 20:00 (с учетом актуаности группы шагов в сутки). Это время уже прошло, поэтому сценарий откидывает событие и не срабатывает по нему.

     Немного изменим сценарий из примера: допустим, между заказом и рассылкой стоит ожидание в 3 дня. 3 дня опять же отсчитаются от даты, с которой пришло действие, то есть рассылка может отправиться с 9 июня 20:00 до 10 июня 20:00. Заказ попадает в актуальность шага, поэтому сценарий отрабатывает по нему.

  2. Не должно быть изменения по позиции с более поздней датой. Ведь в таком случае пришедшие данные уже не самые актуальные по позиции.

Фильтры:

• по позиции заказа
• по продукту

Динамическое ожидание:

• из поля позиции заказа
• из поля продукта
• истечение срока годности продукта

Параметры:

• OrderItem
• Product

Примеры использования:

• Сценарий «Продукт из заказа скоро закончится» — как напомнить клиенту пополнить запасы продукта из прошлого заказа.

Настало время Лучшего следующего предложения

Алгоритм подбирает для клиента дату лучшего следующего предложения.

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

Примеры использования:

• Сценарий Next Best Action

Продукт из списка клиента стал доступен

Продукт из списка клиента, который ранее был не в наличии или о наличии которого не было данных, стал доступен.

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

С региональными данными:

• если у продукта есть региональные данные — смотрит по региону клиента;
• если у продукта нет данных по доступности в регионе — смотрит по основному фиду;
• если у продукта нет региональных данных — смотрит по основному фиду.

Фильтры:

• продукт из списка
• продукт

Динамическое ожидание:

• из поля продукта
• истечение срока годности продукта

Параметры:

• ProductListItem
• Product

Примеры использования:

• Сценарий «Продукт стал доступен» — как сообщить клиенту о том, что продукт из его списка снова в наличии.

У продукта из списка продуктов уменьшилась цена

У продукта из списка клиента снизилась цена на N процентов и больше.

Подробнее: при добавлении продукта в список записывается цена, с которой клиент его добавлял. Она не зависит от цены продукта в продуктовом фиде и может от нее отличаться. Затем цена на продукт в фиде может поменяться. Сравнивается, уменьшилась ли текущая цена и стала ли она меньше цены, с которой клиент добавлял продукт. Если да, сценарий запускается.

• Работает каждый раз, в том числе:
  • При ещё большем снижении цены.
  • При подорожании и новом снижении цены относительно цены в списке.
• Работает на каждый продукт. Если два продукта из списка стали дешевле, сценарий сработает два раза.

С региональными данными:

• если у продукта есть региональные данные — смотрит по региону клиента;
• если у продукта нет данных по цене в регионе — смотрит по основному фиду;
• если у продукта нет региональных данных — смотрит по основному фиду.

Фильтры:

• продукт из списка
• продукт

Динамическое ожидание:

• из поля продукта
• истечение срока годности продукта

Параметры:

• ProductListItem
• Product

Примеры использования:

• Сценарий «Цена на продукт снизилась» — как сообщить клиенту о том, что продукт из его списка стал дешевле.

Список продуктов изменился

В список клиента добавили или удалили продукт, произошла корректировка списка или автоудаление продуктов из него.

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

Фильтры:

• продукт из списка
• продукт

Динамическое ожидание:

• из поля продукта
• истечение срока годности продукта

Параметры:

• ProductListItem
• Product

Выдано действие

Выдано действие. Доступен выбор нескольких шаблонов действия одновременно.

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

  

  Например, сценарий сразу после заказа отправляет рассылку; актуальность у группы шагов — сутки. Заказ попал в базу 10 июня в 10:00 с переданной датой заказа 6 июня 20:00. Шаг мог сработать с 6 июня 20:00 до 7 июня 20:00 (с учетом актуаности группы шагов в сутки). Это время уже прошло, поэтому сценарий откидывает событие и не срабатывает по нему.

  Немного изменим сценарий из примера: допустим, между заказом и рассылкой стоит ожидание в 3 дня. 3 дня опять же отсчитаются от даты, с которой пришло действие, то есть рассылка может отправиться с 9 июня 20:00 до 10 июня 20:00. Заказ попадает в актуальность шага, поэтому сценарий отрабатывает по нему.

Фильтры:

• по действию

Динамическое ожидание:

• из поля действия

Параметры:

• CustomerAction

Выдано действие связанное с продуктом

Выдано действие с продуктом: просмотр продукта, добавление/удаление из списка продуктов. Доступен выбор нескольких шаблонов действия одновременно.

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

  

  Например, сценарий сразу после заказа отправляет рассылку; актуальность у группы шагов — сутки. Заказ попал в базу 10 июня в 10:00 с переданной датой заказа 6 июня 20:00. Шаг мог сработать с 6 июня 20:00 до 7 июня 20:00 (с учетом актуаности группы шагов в сутки). Это время уже прошло, поэтому сценарий откидывает событие и не срабатывает по нему.

  Немного изменим сценарий из примера: допустим, между заказом и рассылкой стоит ожидание в 3 дня. 3 дня опять же отсчитаются от даты, с которой пришло действие, то есть рассылка может отправиться с 9 июня 20:00 до 10 июня 20:00. Заказ попадает в актуальность шага, поэтому сценарий отрабатывает по нему.

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

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

Фильтры:

• по действию
• по продукту

Динамическое ожидание:

• из поля действия
• из поля продукта
• истечение срока годности продукта

Параметры:

• CustomerActionProduct
• CustomerAction
• Product

Клиент попал в БД

Новый клиент добавлен в базу любым способом: вручную, по API, импортом по файлу. Если появляется новый Mindbox ID — событие срабатывает.

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

Примеры использования:

• Welcome-сценарий — как поприветствовать нового клиента.

Клиент был сдедублицирован

Любое объединение клиентов, в том числе ручное.

Затирание контактов с действием «Похожие клиенты» не считается дедубликацией.

Изменение email

Изменение email с одного на другой.

Что не входит:

• заполнение email;
• затирание email;
• создание клиента с email.

С подтверждением email

Что входит:

• добавление неподтвержденного email при наличии подтвержденного;
• email без данных по подтверждению стал неподтвержденным (при вызове из точки интеграции с соответствующими настройками).

Что не входит:

• подтверждение email;
• email без данных по подтверждению стал подтвержденным (при вызове из точки интеграции с соответствующими настройками).

Фильтры:

• по действия

Динамическое ожидание:

• из поля действия

Параметры:

• CustomerAction

Первое подтверждение email

При каждом подтверждении email.

Что входит:

• подтверждение основной почты;
• повторное подтверждение почты;
• заполнение почты сразу подтвержденным email;
• email без данных по подтверждению стал подтвержденным и основным (при вызове из точки интеграции с соответствующими настройками).

Что не входит:

• подтверждение неподтвержденного email у клиента с подтвержденным и неподтвержденным адресами;
• смена одного подтвержденного email на другой подтвержденный.

Изменение мобильного телефона

Изменение мобильного с одного на другой.

Что не входит:

• заполнение телефона;
• затирание телефона;
• создание клиента с телефоном.

С подтверждением телефона

Что входит:

• добавление неподтвержденного телефона при наличии подтвержденного;
• телефон без данных по подтверждению стал неподтвержденным (при вызове из точки интеграции с соответствующими настройками).

Что не входит:

• подтверждение телефона;
• телефон без данных по подтверждению стал подтвержденным и основным (при вызове из точки интеграции с соответствующими настройками).

Фильтры:

• по действию

Динамическое ожидание:

• по действию

Параметры:

• CustomerAction

Первое подтверждение мобильного телефона

При каждом подтверждении телефона.

Что входит:

• подтверждение основного телефона;
• повторное подтверждение телефона;
• заполнение телефона сразу подтвержденным номером;
• телефон без данных по подтверждению стал подтвержденным и основным (при вызове из точки интеграции с соответствующими настройками).

Что не входит:

• подтверждение неподтвержденного телефона у клиента с подтвержденным и неподтвержденным телефона;
• смена одного подтвержденного телефона на другой подтвержденный.

Обновление данных клиента

Изменение данных клиента, которое появляется на вкладке ’История изменений’: заполнение и затирание данных, признание валидным и невалидным email и т.д.

Что не входит:

• создание клиента, когда данные по нему впервые появляются в базе;
• объединение;
• изменение дополнительных полей, если отключено их хранение. Уточнить о состоянии этой функции можно через поддержку или у менеджера. В таком случае эти изменения также не отображаются на вкладке.

Редактирование анкеты клиентом

Изменение данных клиента с действием из категории ’Личные’, которое появляется на вкладке ’История изменений’.

Что не входит:

• создание клиента, когда данные по нему впервые появляются в базе.

Изменилось значение дополнительного поля у клиента

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

Что входит:

• заполнение поля;
• изменение значения поля;
• затирание поля.

Состояние функции хранения изменений дополнительных полей не влияет на работу события.

Что не входит:

• создание клиента с полем.

Изменился статус подписки

У клиента появился выбранный статус подписки в канале/тематике.

Что входит:

• статус стал нужным, но неявным;
• статус сразу стал нужным;
• клиент появился сразу с нужным статусом;
• статус повторно стал нужным.

Что не входит:

• неявный нужный статус стал таким же, но явным;
• после объединения основной клиент получил нужный статус.

Клиент попал в сегментацию

Клиент попал в выбранный пересчитываемый или статический сегмент.

Клиент вышел из сегментации

Клиент вышел из выбранного пересчитываемого или статического сегмента.

Баланс клиента стал отрицательным

После изменения баланса он стал отрицательным.
Например, клиент потратил начисленные за заказ баллы, а потом отменил заказ.

Событие также срабатывает, если после начисления баланс остается отрицательным или приходят ещё списания.

Фильтры:

• изменение баланса
• действие

Динамическое ожидание:

• сгорания баллов
• из поля действия

Параметры:

• CustomerBalanceChange
• CustomerAction

Бонусные баллы стали доступны (перешли из заблокированных)

Начисленные баллы стали доступны.

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

Фильтры:

• изменение баланса
• действие

Динамическое ожидание:

• сгорания баллов
• из поля действия

Параметры:

• CustomerBalanceChange
• CustomerAction

Примеры использования:

• Сценарий «Ваши баллы доступны» — как сообщить клиенту, что полученные баллы можно тратить.

Изменения заданного баланса

Любое изменение баланса на балльном счету: начисление, списание, обнуление.

Фильтры:

• изменение баланса
• действие

Динамическое ожидание:

• сгорания баллов
• из поля действия

Параметры:

• CustomerBalanceChange
• CustomerAction

Примеры использования:

• Сценарий «Ваши баллы скоро сгорят» — как напомнить клиенту потратить баллы, пока они не сгорели.

Выдан промокод

Выдан одноразовый или реферальный промокод.

Фильтры:

• по промокоду

Параметры:

• PromoCode

Гашение промокода

Использование любого промокода, в том числе многоразового, в любой акции, в том числе внешней.

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

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

Фильтры:

• по промокоду

Параметры:

• PromoCode

Использован реферальный промокод клиента

Использован реферальный промокод, выданный клиенту.

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

Фильтры:

• по промокоду

Параметры:

• PromoCode

Статус карты изменен

Статус карты стал «Активирована», «Заблокирована» или «Не активирована».

Обратите внимание, что карты всегда выдаются с изменением статуса.

Фильтры:

• информация о дисконтной карте
• действие

Динамическое ожидание:

• из поля информации о дисконтной карте
• из поля действия

Параметры:

• CustomerAction

Замена дисконтной карты

Замена карты.
Выдача новой карты не считается заменой.

Фильтры:

• по действию

Динамическое ожидание:

• по полю действия

Параметры:

• CustomerAction

Устаревшие шаги

• Создание FMCG-заказа
• Изменение статуса FMCG-заказа
• Клиент получил приз

На большинстве проектов уже не работают.