Узлы сценария

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

Любой сценарий должен содержать как минимум 2 узла: стартовый узел и узел, связанный с ним.

Управление узлами

Добавление узла

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

Настройка узла

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

Добавление связи между узлами

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

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

Удаление узла

Чтобы удалить узел или связь между узлами, выделите объект, кликнув на него. Затем нажмите правую кнопку мыши и в выпадающем меню выберите Переместить в корзину или воспользуйтесь Backspace/Delete. Доступно удаление нескольких узлов, включая связи между ними.

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

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

предупреждение

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

Клонирование узла

Чтобы клонировать узел, выделите его, щелкните правой кнопкой мыши на нем и выберите Копировать или используйте комбинацию клавиш Ctrl + C. Затем нажмите правую кнопку мыши и выберите Вставить или используйте комбинацию клавиш Ctrl + V. Таким же образом можно клонировать несколько узлов, включая связи между ними.

подсказка

Для выделения нескольких узлов сценария активируйте инструмент "Указатель". Затем зажмите левую кнопку мыши и выделите область с нужными объектами или зажмите клавишу Ctrl и, удерживая ее, последовательно выберите нужные объекты правой кнопкой мыши.

Панель инструментов

Инструменты для управления узлами

— активировать инструмент "Указатель". Используется для управления узлами сценария: перемещение, соединение, выделение и т.д.

— активировать инструмент "Рука" (Space + drag). Используется для перемещения по рабочему пространству сценария.

— отменить последнее действие Ctrl + Z.

— вернуть последнее отмененное действие Ctrl + Shift + Z.

— открыть "Корзину". "Корзина" содержит все удаленные из сценария узлы.

— отобразить ID каждого узла вместо названия.

Инструменты для настройки сценария

— активировать сценарий.

— деактивировать сценарий.

— показать информацию о сценарии (описание, теги и группы для сценария).

— просмотреть аналитику сценария в отчете по каналам.

— показать настройки сценария (режим повторного входа профиля в сценарий и др.).

Инструменты для управления рабочим пространством

— увеличить масштаб рабочего пространства Ctrl +.

— уменьшить масштаб рабочего пространства Ctrl -.

— применить выравнивание. Узлы выравниваются относительно друг друга внутри рабочего пространства.

— подогнать вид. Масштаб изменяется на оптимальный, что позволяет увидеть все узлы внутри рабочего пространства.

Список узлов

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

• Триггеры — узлы, определяющие способ захвата профиля в сценарий.
• Операторы — узлы, влияющие на движение профиля по сценарию.
• Каналы — узлы, с помощью которых профилю отправляется сообщение.
• Действия — узлы, запускающие определенное действие в платформе в момент вхождения профиля.

Триггеры

Триггер — это узел, который запускает сценарий. Можно настроить один или несколько триггеров. Максимальное количество триггеров в одном сценарии — 10. Один тип триггера можно использовать несколько раз в одном сценарии.

к сведению

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

Захват профилей по умолчанию

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

Подробнее

Данный узел обеспечивает захват профилей при следующих действиях:

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

Выполнение действия

Активируется, когда подписчик совершает нужное действие в сообщении.

Подробнее

В выпадающем списке выберите действие в одном из каналов отправки, а также укажите шаблон, в котором хотите отслеживать это действие:

Действие	Описание
Любой клик в Email	Получатель кликнул по любой ссылке в выбранном шаблоне сообщения.
Клик по ссылке в Email	Получатель кликнул по конкретной ссылке в выбранном шаблоне сообщения.
Открыт Email	Пиксель отслеживания зафиксировал открытие письма по выбранному шаблону.
Прочитан Email	Пиксель отслеживания зафиксировал прочтение письма по выбранному шаблону.
Клик на confirm ссылку в Email	Получатель кликнул по ссылке подтверждения подписки в выбранном шаблоне.
Клик в SMS	Платформа зарегистрировала клик по любой ссылке в выбранном шаблоне.
Клик по ссылке в SMS	Платформа зарегистрировала первый переход по конкретной ссылке в выбранном шаблоне.
Открыт Push	Платформа зарегистрировала открытие выбранного шаблона Push-уведомления. Push-уведомления обычно открываются автоматически, если разрешены в браузере или ОС мобильного устройства.
Любой клик в Push	Клик по любой ссылке в выбранном шаблоне Push-уведомления.
Открыт попап	Платформа зарегистрировала показ выбранного шаблона попапа пользователю.
Клик по попапу	Пользователь кликнул по выбранному шаблону попапа.
Закрыт попап	Платформа зарегистрировала клик по кнопке закрытия попапа.
Пользовательское событие попапа	Платформа зарегистрировала пользовательское событие в попапе.
Заполнен попап	Платформа зарегистрировала заполнение полей в выбранном шаблоне попапа пользователем.
Notify прочтение	Платформа зарегистрировала прочтение шаблона Notify.
MAX bot прочтение	Платформа зарегистрировала прочтение шаблона MAX bot.
Whatsapp*/Viber™/Notify/Telegram bot/MAX bot клик	Платформа зарегистрировала любой переход по ссылке в выбранном шаблоне. Триггер срабатывает при каждом переходе и повторно отправляет профиль в сценарий, если не указано иное.
Whatsapp*/Viber™/Notify/Telegram bot/MAX bot уник. клик	Платформа зарегистрировала первый переход по любой ссылке в шаблоне.
Whatsapp*/Viber™/Telegram bot/MAX bot уник. клик по ссылке	Платформа зарегистрировала первый переход по конкретной ссылке в выбранном шаблоне.
Whatsapp*/Viber™/Notify/Telegram bot подтверждение подписки	Платформа зарегистрировала клик по ссылке подтверждения подписки в шаблоне.

Обновление через форму

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

Подробнее

В выпадающем окне укажите форму, к которой будет привязан триггер:

Добавление/изменение подписки

Триггер активируется, когда профилю добавляется новая подписка или меняется статус существующей. Для триггера можно отдельно указать Ресурс и Канал, по которым будут отслеживаться изменения. В противном случае, рассылка будет ожидать изменений по всем каналам выбранного ресурса, по всем ресурсам для выбранного канала или по любым подпискам профиля.

Подробнее

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

• Подписка на новый канал в ресурсе — добавлена подписка на новый (для профиля) канал в ресурсе. То есть, была подписка на email рассылки, добавилась ещё и на SMS или Push.

• Новый контакт в канале — активирует триггер при каждом появлении новой подписки. Первая подписка на канал также считается "новым контактом в канале".

• Статус изменён на (выбрать статусы) — запустится при изменении статуса подписки на выбранные из выпадающего меню.

• Первые три пункта выбраны — триггер сработает при каждой новой подписке.

• Все галочки сняты — ничего не происходит.

примечание

На подписки, которые добавлены со статусом, отличным от "Подписан", триггер не активируется.

Сегмент по расписанию

Группа профилей, соответствующая определенным условиям, попадает в сценарий по заданному расписанию.

Подробнее

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

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

После внесения изменений под расписанием отобразится таблица со следующими запусками сценария.

подсказка

Настройка расписания подробно описана в отдельной статье.

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

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

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

подсказка

Сценарий по расписанию запускается аналогично регулярной рассылке. Сегмент клиентов рассчитывается динамически при каждом запуске.

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

Изменение в статическом сегменте

Триггер запускается при изменении в статическом сегменте: профиль может как войти в указанный статический сегмент, так и выйти из него.

Подробнее

В выпадающем окне выберите действие (вход или выход из статического сегмента) и сегмент, который хотите отслеживать:

Изменение связи

Триггер запускается при изменении связи между профилями: как прямой, так и обратной. При этом может учитываться появление, изменение или удаление связи, а также достижение свойством связи заданного в триггере значения.Delete/Backspace

Подробнее

Чтобы настроить триггер, укажите:

• связь,
• тип события, привязанного к ней,
• направление связи,
• свойство связи,
• значение свойства.

API импорт

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

Подробнее

предупреждение

При выборе способа Любой импорт этот триггер становится недоступен.

Любой импорт

Триггер активируется, когда в базу данных добавляется новый профиль любым способом: посредством API-запроса или вручную из карточки профиля.

Подробнее

предупреждение

При выборе способа Любой импорт остальные триггеры на импорт становятся недоступными.

Импорт вручную

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

Подробнее

предупреждение

При выборе способа Любой импорт этот триггер становится недоступен.

Импорт через попап

Триггер сработает, если в базе будет создан новый профиль в результате того, что пользователь заполнил и отправил форму в pop-up окне.

Подробнее

Выберите попап, заполнение которого необходимо отслеживать. Pop-up окно можно создать в разделе Веб-слой —> Попапы, а настроить импорт профилей в базу можно в pop-up редакторе в разделе Действия.

предупреждение

При выборе способа Любой импорт этот триггер становится недоступен.

Активация пикселя

Профиль попадает в сценарий, когда активируется пиксель.

Подробнее

В выпадающем окне выберите необходимый пиксель:

Данный триггер может отслеживать срабатывание пикселя по умолчанию:

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

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

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

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

Также можно отфильтровать профили по дополнительным полям. Значения дополнительных полей передаются посредством API-запроса.

подсказка

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

Импорт через форму

Триггер сработает, если в базе будет создан новый профиль в результате того, что пользователь заполнил и отправил форму.

Подробнее

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

предупреждение

При выборе способа Любой импорт этот триггер становится недоступен.

Заполнение формы

Триггер сработает только в случае, если форма была заполнена по переходу из письма.

Подробнее

В выпадающем списке укажите форму, заполнение которой хотите отслеживать:

подсказка

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

Изменение заказа

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

Подробнее

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

Доступны следующие варианты типов событий:

• Добавление заказа — триггер сработает при добавлении в маркет заказа с одним из указанных статусов.

• Изменение статуса заказа — триггер сработает, если статус существующего заказа примет одно из выбранных значений.

Можно выбрать один или несколько статусов заказа, приводящих к срабатыванию триггера:

подсказка

Настройка заказов подробно описана в отдельной статье.

Изменение значения поля

Триггер активируется, когда заданное поле профиля принимает нужное значение.

Подробнее

Выберите поле профиля, условие и ожидаемое значение:

Условия различаются в зависимости от типа поля:

Условие	Тип поля	Описание
изменено	все	Любое изменение в поле профиля
равно	все, кроме теги, объект, массив объектов	Новое значение равно ожидаемому
не равно	все, кроме теги, объект, массив объектов	Новое значение не равно ожидаемому
не пустое	все, кроме теги	Поле получило любое не пустое значение
пустое	все, кроме теги	Все значения удалены для поля профиля
добавлен любой тег из списка	теги	Список определяется в триггере
удалён любой тег из списка	теги	Список определяется в триггере
свойство изменилось	объект	Указывается путь к ключу объекта. Если значение ключа изменится, сработает триггер.
свойство равно	объект	Указывается путь к ключу объекта и ожидаемое значение. Если значение этого ключа примет ожидаемое значение, сработает триггер.
свойство не равно	объект	Указывается путь к ключу объекта и ожидаемое значение. Если значение этого ключа не примет ожидаемое значение, сработает триггер.
свойство элемента изменилось	массив объектов	Указывается путь к элементу массива. Если свойство этого элемента изменится, сработает триггер. При выборе пути к свойству элемента вы также выбираете тип данных, к которому приводить сравниваемое значение. Доступно сравнение таких типов данных, как string, int, float, и bool. Сравнение сложных типов данных (объект, массив) невозможно. В примере ниже вы не сможете отследить изменения в свойствах элементов key_1 and key_4. [ {    "key_1": [1,2,3,4,5],    "key_2": 2 }, {    "key_3":"value",    "key_4": [1,2,3,4,5] } ] Обратите внимание, выпадающий список содержит доступные пути к свойству поля, но индекс любого элемента по умолчанию равен 0 — $[0].key_3. Чтобы задать путь к нужному элементу, введите индекс вручную в формате jsonpath — $[1].key_3.
свойство элемента равно	массив объектов	Указывается путь к элементу массива и ожидаемое значение. Если свойство этого элемента примет ожидаемое значение, сработает триггер.
свойство элемента не равно	массив объектов	Указывается путь к элементу массива и ожидаемое значение. Если свойство этого элемента не примет ожидаемое значение, сработает триггер.
добавлен элемент	массив объектов	В массив добавляется новый элемент.
удален элемент	массив объектов	Из массива удаляется элемент.

предупреждение

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

Смена уровня лояльности

Триггер активируется, когда профиль переходит на другой уровень в программе лояльности.

Подробнее

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

Изменение баллов

Триггер активируется, когда у профиля изменяется количество баллов в программе лояльности.

Подробнее

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

• Начисление
• Списание
• Активация
• Сгорание
• Отмена начисления
• Отмена списания

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

Операторы

Пауза

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

Подробнее

Доступны следующие варианты:

Пауза относительно предыдущего действия

Чтобы ожидать определённое время после захвата профиля клиента сценарием или после выполнения предыдущего действия, выберите вариант "Ожидать дни, часы или минуты":

Пересчитать время ожидания

При использовании функции пересчета времени ожидания, платформа будет пересчитывать время паузы для тех, кто уже есть в этом узле сценария. Например, изначально вы установили паузу длительностью 10 дней, а затем увеличили время ожидания до 20 дней. В таком случае профиль, который захвачен в сценарий после внесения изменений, будет ожидать 20 дней. Что касается профиля, который уже находился в этом узле 8 дней до внесения изменений, время его ожидания составит еще 12 дней, а не 20.

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

Пауза до наступления определённого времени

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

• Ожидать определенного времени — указывается точное время перехода профиля на следующий узел.

• Ожидать дату и время — указывается точное время и дата перехода на следующий узел.

• Ожидать дня недели и времени — настраивается точное время и один или несколько дней недели.

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

подсказка

Приведем пример, как работает список дат в узле "Пауза".

Предположим, вы установили следующие даты: "2023-02-01", "2023-07-01" и "2023-10-01". Если профиль попал на узел 1 января 2023, то он продолжит движение по сценарию 1 февраля. Если профиль попал на узел 1 марта 2023, то он пойдет дальше 1 июля. Если же профиль попал на узел в августе, то он будет ожидать до 1 октября. Каждый профиль единожды ожидает до ближайшей к моменту попадания на узел даты.

Пауза до наступления определённого периода времени

Вариант Ожидать периода времени устанавливает часы активности следующего узла сценария. Например, если вы хотите, чтобы определённая рассылка запускалась с 9 утра до 9 вечера:

Вариант "Ожидать дня недели и периода времени" устанавливает дни и часы активности следующего узла сценария. Например, если необходимо, чтобы определённая рассылка запускалась только по субботам и воскресеньям с 10 до 12.

Ожидание даты и времени из профиля

Эти настройки позволят поставить сценарий на паузу до наступления даты или времени, которые указаны в одном из полей профиля:

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

• Ожидать время из профиля (независимо от даты) — профиль перейдет на следующий узел, когда наступит время, указанное в выбранном поле. Дата может не совпадать с текущей.

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

Выберите поле в базе с нужными данными. Это может быть дата рождения (_bdate), дата регистрации в системе (_regdate) или любое кастомное поле с типом "Дата" (например, дата запланированного события).

Далее настройте работу сценария в случае, если у профиля не заполнено выбранное поле:

• Игнорировать паузу — профиль сразу перейдет на следующий узел, не дожидаясь наступления определенного времени.

• Прервать выполнение сценария для профиля — профиль выйдет из сценария.

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

Лучшее время отправки

Устанавливает перед следующим узлом сценария паузу, рассчитанную на основе данных ML-сервиса. Профиль не перейдёт на следующий узел, пока не наступит оптимальное время для отправки ему сообщения. Оптимальный вариант работы — добавить после узла "Ожидание лучшего времени доставки" узел из категории "Каналы". В таком случае рассылка отправит профилю сообщение в наиболее удобное для него время.

Подробнее

к сведению

Расчёт лучшего времени происходит через алгоритмы машинного обучения. ML-сервис определяет лучший час, когда вероятность открытия сообщения профилем самая высокая, а также подбирает массив с несколькими хорошими часами отправки.

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

Профиль перейдет на следующий узел, когда наступит его лучший час отправки.

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

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

Ожидание события

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

Подробнее

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

Настройки времени ожидания:

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

  

• Ожидать определенного времени — профиль перейдет по нижней ветке, если событие не произойдет до указанного времени.

  

• Ожидать дату и время — профиль перейдет по нижней ветке, если событие не произойдет до конкретной даты и времени.

  

• Ожидать дня недели и времени — настраивается один или несколько дней недели и точное время. Профиль перейдет по нижней ветке, если событие не произойдет до ближайшего выбранного дня и времени.

  

• Ожидать даты из списка — выбирается несколько дат и время. Профиль перейдет по нижней ветке, если событие не произойдет до ближайшей даты из списка. Каждый профиль ожидает до ближайшей к моменту попадания на узел даты.

  

• Ожидать дату из профиля — профиль перейдет по нижней ветке, если событие не произойдет до даты, указанной в выбранном поле профиля.

  

• Ожидать время из профиля (независимо от даты) — профиль перейдет по нижней ветке, если событие не произойдет до времени, указанного в выбранном поле профиля. Дата может отличаться от текущей.

  

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

  

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

Тип события	Описание
Выполнение действия	Событие будет зарегистрировано, когда профиль выполнит выбранное действие в канале. Полный список действий можно найти в описании узла "Выполнение действия".
Обновление через форму	Событие будет зарегистрировано при обновлении полей профиля после заполнения формы. Для активации этого триггера требуется форма, которая будет импортировать захваченные профили в выбранную для данного сценария базу данных.
Добавление/изменение подписки	Событие будет зарегистрировано при добавлении или изменении статуса подписки профиля.
Изменение в статическом сегменте	Событие будет зарегистрировано, когда для профиля будет зафиксировано определенное изменение в сегменте.
Изменение связи	Событие будет зарегистрировано при изменении связей профиля.
Активация пикселя	Событие будет зарегистрировано при активации пикселя для профиля.
Заполнение формы	Событие будет зарегистрировано при заполнении формы пользователем с существующим профилем.
Изменение/добавление заказа	Событие будет зарегистрировано при изменении статуса заказа у профиля. Для активации этого триггера необходим канал продаж, привязанный к базе данных, выбранной для данного сценария.

Условие

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

подсказка

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

Подробнее

Основные настройки

Введите название узла для отображения в сценарии.

подсказка

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

Правила выполнения условия

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

JSON фильтр

В случае вызова сценария через API можно передать специальное поле content, с неопределенной структурой в формате JSON (её определяете вы). Эти данные можно использовать для вставки в сообщения, возврата в Action Hook или для построения условий в сценарии. Например, когда пользователь совершает какое-то действие, веб-сайт (или приложение) активирует сценарий и передает туда все данные, связанные с действием. Узел "JSON фильтр" определяет дальнейшие действия для профиля на основе проверки этих данных.

Подробнее

JSON-фильтр работает так же, как и обычное условие. Можно неоднократно использовать этот узел для построения сложных схем.

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

Пример поля "content" в API запросе:

{
  "content": {
    "customer_id": "12345",
    "total_purchases": 5,
    "last_purchase_amount": 250,
    "average_purchase_amount": 100,
    "preferred_category": "electronics",
    "loyalty_points": 300,
    "membership_status": "premium",
    "discount_coupons_used": 2,
    "active_coupon": "win0513",
    "promo": null
  }
}

Обратите внимание, ключ JSON-объекта указывается без кавычек (например, membership_status="premium").

Оператор	Пример	Описание
|| ИЛИ	(preferred_category = "electronics") || (preferred_category = "computers")	Условие выполнится, если клиент интересуется категориями "Электроника" или "Компьютеры".
&& И	(total_purchases >= 5) && (average_purchase_amount >= 100)	Условие выполнится, если клиент совершил 5 или более покупок и средний чек превышает 100.
= Равно	membership_status = 'premium'	Условие выполнится, если у клиента premium-статус.
!= Не равно	membership_status != 'standard'	Условие выполнится, если у клиента не standard-статус.
> Больше чем	last_purchase_amount > (2 * average_purchase_amount)	Условие выполнится, если у клиента сумма последней покупки превышает в два раза среднюю сумму покупок.
>= Больше или равно	last_purchase_amount >= 250	Условие выполнится, если сумма последней покупки равна или превышает 250.
< Меньше чем	loyalty_points < 500	Условие выполнится, если количество бонусных баллов меньше 500.
<= Меньше или равно	loyalty_points <= 500	Условие выполнится, если количество бонусных баллов 500 или меньше.
~= Регулярное выражение	active_coupon ~= '^win'	Условие выполнится, если промокод начинается с "win".
!~= Обратное регулярное выражение	active_coupon !~= '^win'	Условие выполнится, если промокод НЕ начинается с "win".
+ Сложение	(loyalty_points + bonus_points) < 200'	Оператор арифметического сложения.
- Вычитание	(loyalty_points - penalty_points) > 100'	Оператор арифметического вычитания.
* Умножение	(bonus_points * years) > 360	Оператор арифметического умножения.
/ Деление	(total_purchase / 365) > 5	Оператор арифметического деления.
% Деление по модулю	(total_sum % 15) = 5	Оператор вычисления остатка от деления.
^ Возведение в степень	(promotion_points ^ 3) > 360'	Оператор возведения числа в степень.
is defined Проверка существования поля	promo is defined	Условие выполнится, если поле "promo" существует, вне зависимости от того, указано для него значение или нет.
isnot defined Проверка отсутствия поля	promo isnot defined	Условие выполнится, если поле "promo" отсутствует в коде.
is null Проверка пустого значения поля	promo is null	Условие выполнится, если у поля "promo" нет значения (его значение равно null).
isnot null Проверка значения поля	promo isnot null	Условие выполнится, если поле "promo" имеет какое-либо значение (равно чему угодно, кроме null).
contains Проверка, содержится ли значение справа в поле слева	Строка: "hello" contains "he" Массив: [1, 2, 3] contains 2	Условие выполнится, если поле "hello" содержит значение "he".
in Проверка, содержится ли значение слева в поле или массиве справа	Строка: "he" in "hello" Массив: 2 in [1, 2, 3]	Условие выполнится, если значение 2 содержится в массиве [1, 2, 3].
notin Проверка, НЕ содержит ли строка или массив значение поля слева	"bye" notin "hello"	Условие выполнится, если поле "hello" НЕ содержит значение "bye".

Для обращения к вложенному полю объекта используйте следующий синтаксис: object.field.

Для обращения к элементам массива по индексу используйте следующий синтакис: array.[0].field.

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

// Объект:

{
  "content": {
    "customer_id": "12345",
    "total_purchases": 5,
    "promo_campaign": {
      "tickets": 115
    },
    "tickets_info": [
      {
        "ticket_id": "T001",
        "price": 50,
        "date": "2024-08-30"
      },
      {
        "ticket_id": "T002",
        "price": 75,
        "date": "2024-08-31"
      }
    ]
  }
}

// Обращение к вложенному полю объекта: 

promo_campaign.tickets >= 100

// Обращение к первому элементу массива: 

tickets_info.[0].ticket_id

Перейти в сценарий

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

Подробнее

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

Узел распределения

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

Подробнее

Основные настройки

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

Распределение перебором

Распределение профилей происходит в момент попадания в узел сценария в соответствии с указанными пропорциями. В его основе лежит механизм Smooth Weighted round-robin balancing.

Статическое распределение

При использовании статического распределения профиль всегда будет попадать в один и тот же процент распределения, который нельзя изменить. Статическое распределение не рекомендуется использовать для небольшого количества профилей (до 10 000).

Каналы

Узел этой категории запускают триггерную рассылку через определенный канал. Новая рассылка создаётся непосредственно в редакторе узла.

подсказка

Узел Размещение позволяет запустить рассылку-размещение в сценарии. Настройка такой рассылки описана в этой статье.

Подробнее

Основные настройки

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

Настройки рассылки

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

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

Подписчики

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

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

Также можно отфильтровать получателей рассылки по дополнительным полям канала в ресурсе. Чтобы создать фильтр по полям, выберите стандартное или дополнительное поле подписки. В поле "Условие отбора" выберите логический оператор и при необходимости укажите значение.

Контент

На третьей вкладке выберите Шаблон сообщения, который хотите отправить подписчикам. Есть возможность выбрать сразу несколько шаблонов (до 16 шаблонов в одной рассылки). В таком случаи они будут отправляться в случайном порядке. Как и при создании рассылки, вы можете открыть предпросмотр нужного шаблона и перейти к его редактированию, если это необходимо:

После выбора контента нажмите кнопку "Готово". Настройки рассылки отобразятся на одной вкладке, и вы сможете внести необходимые изменения в любой момент по нажатию на кнопку редактирования:

Ограничения рассылки

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

Smart настройки

В умных настройках вы можете дополнительно настроить рассылку:

• SUBID статистики
• Выбор виртуального сендера
• Пользовательские домены для отслеживания событий (помимо настроенного в ресурсе)
• Список адресов для скрытой копии к отправляемым письмам
• Другие опции в зависимости от конфигурации платформы

предупреждение

Если при отправке рассылки возникла ошибка, профиль продолжит идти по сценарию.

Действия

Обновить профиль

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

Подробнее

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

Действие	Тип поля	Описание
Установить значение	Все	Вручную указывается новое значение поля. Для полей типа Список (Enum) значение меняется на одно из заданных в списке, например, выбранный пакет услуг. Для полей типа Boolean значение меняется на Да или Нет.
Удалить значение	Все	Удаляет значение из выбранного поля.
Взять значение из поля	Все	Значение берется из поля apicontent. Используется вместе с узлом "API Запрос", который способен сохранить результат запроса в объект apicontent.
Увеличить на	Целое число	Увеличивает или уменьшает значение. Для уменьшения значения нужно ввести отрицательное число.
Добавить элемент	Теги	Записать в поле еще один тег.
Удалить элемент	Теги	Удалить из поля один из существующих тегов.

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

к сведению

При обращении к порядковому номеру элемента массива из apicontent необходимо использовать знак %. Счет в таких массивах начинается с нуля. Например, мы имеем следующий объект с массивом:

{
    "results": [
        {
            "objectId": "12asd34",
            "name": "Организация 1"
        }
    ]
}

Для того чтобы получить название первой организации, нам нужно использовать следующий запрос — res.results.%0.name, в котором res является полем для хранения ответа из узла "Вызов API". Также обратите внимание, что запросы не подерживают JSONPath.

Пример корректной структуры запроса: resp.data.data.%0.profile._region Пример некорректной структуры запроса: {jsonpath(resp.data "$.data[0].profile._region" "item")}

Импорт в базу данных

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

Подробнее

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

Вы также можете перенести историю профилю из исходной базы в целевую. Для этого воспользуйтесь опцией Копировать историю профиля" и выберите период, данные за который хотите перенести. История профиля включает действия в рассылках (отправки, открытия, клики и др.), события подписок, импорта, пикселей, назначение промокодов и участие в статических сегментах.

Вызов API

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

Подробнее

Введите название узла.

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

Выберите тип запроса к внешней системе. В поле URL введите адрес сервиса, принимающего данные:

В URL запроса также используются переменные. Нажмите кнопку </> или введите значение вручную. Пример использования промокода в адресе запроса:

http://www.example.org/api/?Promocode={loyalty.black_friday.promocode}

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

Принцип работы ограничителя

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

Чтобы совершить вызов API, профиль должен получить токен — разрешение на попытку выполнения запроса. Токены хранятся в узле ("ведре") и поступают в него с интервалом W/L, где W — указанный в ограничителе временной интервал, а L — установленный лимит.

Максимальное количество хранимых токенов в узле — L/2, то есть половина от значения лимита. Количество токенов намеренно составляет половину лимита, поскольку на целевом сервере могут использоваться другие алгоритмы ограничения (например, фиксированное или скользящие окно), которые могут некорректно взаимодействовать с лимитером платформы. Уменьшая размер "ведра" с токенами, мы сглаживаем пик нагрузки и предотвращаем выпадение профилей из сценария даже при высокой загруженности.

Если в узле есть токены, то профиль получит разрешение на вызов API. Если же в узле не осталось токенов, то профиль "усыпится" на некоторое время, затем повторно запросит токен. Это будет продолжаться до тех пор, пока профиль не получит токен:

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

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

• "Accept"
• "Accept-Encoding"
• "Authorization"
• "Cache-Control"
• "Cookie"
• "Connection"
• "Content-Type"
• "Content-Length"
• "Host"
• "Referer"
• "User-Agent"
• "X-Forwarded-For"
• "X-Requested-With"
• "Keep-Alive"
• "Transfer-Encoding"
• "Trailer"
• "Upgrade"
• "Date"
• "Location"
• "Server"

Тело запроса состоит из параметров. Для того чтобы добавить параметр, нажмите соответствующую кнопку и источник значения (так же, как при добавлении заголовка).

подсказка

При выборе в параметре запроса Указать своё можно использовать переменные, связанные с профилем. Например, промокоды программ лояльности. Если к профилю не привязан промокод от выбранной программы лояльности, в запросе придёт пустая строка "code": "". Параметр может выглядеть так:

{loyalty.<'Имя шаблона' из настроек программы лояльности>.promocode}

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

Успешным считается запрос, который соответствует заданному в узле условию:

• Status 200 — сервер возвращает HTTP код ответа 200.

• Plain — ответ от сервера должен попасть в указанный Regex.

• Parsed — используется, если сервер возвращает JSON или XML объект. Необходимо указать путь к имени поля и ожидаемое значение. Значение может быть пустым.

После вызова API вы можете сохранить полученный ответ (например, JSON объект) в переменную {apicontent} и использовать эти данные на следующих шагах сценария. Для этого активируйте опцию Сохранить http-ответ в поле {apicontent}.

Введите имя поля, в которое будет записан объект. Это имя будет использоваться при подстановке переменной в шаблон сообщения. Например, если задать имя поля — field_name, то в шаблоне обращение к JSON-объекту будет выглядеть следующим образом: {apicontent.field_name}. Однако при использовании в других узлах сценария префикс apicontent не нужен, требуется только имя поля.

Обновление статистического сегмента

Добавляет профиль клиента в статический сегмент аудитории или удаляет из сегмента.

Подробнее

В настройках узла выберите добавление или удаление и доступный статический сегмент:

Подписки

Подписывает клиента на определённый ресурс или обновляет данные существующей подписки. В качестве источника подписок могут использоваться данные профиля или данные подписок на другой ресурс.

Подробнее

В системе используются два типа каналов подписки:

• Indirect-канал — отправляет сообщение неопределенному количеству пользователей. Используется только для рассылки в кастомные каналы и в Telegram Group-канал.
• Direct-канал — отправляет персонализированное сообщение конкретному получателю.

Добавление и обновление подписки

• Подписку можно добавить, если клиент ещё не подписан на ресурс.
• Можно изменить статус подписки. Например, при подтверждении подписки или при использовании в кастомных сценариях отписки.

Как добавить или обновить подписку на ресурс:

1. Введите название узла.
2. Нажмите Добавить подписку или Обновить.
3. Укажите ресурс из выпадающего списка.
4. При необходимости измените статус подписки.
5. Выберите доступные каналы связи.
6. В качестве источника подписки используйте данные профиля (например, Email, Телефон) или данные подписок другого ресурса.

подсказка

Подписаться на Push-уведомления можно только если в качестве источника подписки выбран ресурс, для которого уже настроена отправка Push.

Промокод

Назначает профилю клиента промокод от выбранной программы лояльности. Промокод может быть затем отправлен клиенту с помощью одного из узлов в категории "Каналы" или использован для расчёта персональных предложений.

Подробнее

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

предупреждение

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

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

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

Регистрация цели

Записывает в профиль клиента достижение определённой цели и связанную стоимость действия. Может использоваться для скоринга подписчиков, LTV и RFM сегментации, в отчётах по конверсии и прибыли.

Подробнее

Введите название узла и пиксель, к которому будет привязана цель. Регистрация одинаковых целей на разные пиксели может быть использована в партнёрских программах или для A/B тестирования интерфейса вашего сайта или других ресурсов.

Ниже выберите существующие цели или добавьте новые. Укажите стоимость, которую необходимо передать для целей.

подсказка

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

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

Cтоп-список

Добавляет определённые контактные данные клиента (email адрес и номер телефона) в стоп-список платформы. Коммуникация с клиентом по этим данным будет заблокирована. Или наоборот, удаляет контактные данные из стоп-списка, восстанавливая возможность коммуникации с клиентом.

Подробнее

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

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

Участие в лояльности

Регистрирует или исключает пользователя из программы лояльности.

Подробнее

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

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

• Дата попадания профиля в узел — время, в которое профиль оказался на этом узле сценария;
• Дата из поля профиля — время регистрации будет взято из выбранного поля профиля в формате даты;
• API-контент — время регистрации будет взято из указанного API-поля.

Для последних двух вариантов доступны два варианта обработки некорретных данных: использование даты попадания профиля в узел или регистрация ошибки.

Управление баллами

Изменяет количество баллов профиля в программе лояльности.

Подробнее

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

Затем укажите промоакцию, в рамках которой будет проводиться начисление, и вид баллов. Количество баллов можно указать либо числом, либо взять из поля профиля, либо передать из API-content.

Помимо этого можно указать:

• Дата и время активации (мгновенно, по полю из профиля или по значению из API-content);
• Дата и время сгорания (в соответствии с настройками баллов, по полю из профиля или по значению из API-content);
• Комментарий к транзакции;
• Дополнительные поля JSON;
• Дополнительный идентификатор транзакции.

---

*Организация Meta, которой принадлежат продукты Instagram, Facebook и WhatsApp, признана экстремистской и запрещена на территории РФ.

** Viber™ является товарным знаком Rakuten Group, Inc. Заблокирован на территории РФ