Перейти к основному содержимому
Документация для версии v74

Триггерная рассылка

Триггерная рассылка — это инструмент создания транзакционных сообщений в Altcraft Platform. Триггерная рассылка отличается от других рассылок тем, что не имеет расписания и лимита. Вместо этого триггер постоянно находится в ожидании события, которое его запустит. Рассылает по одному сообщению каждому подписчику, который попал под условие запуска триггера.

Чтобы создать новую рассылку, в главном меню выберите Рассылки → Триггеры и нажмите кнопку + Создать. Или воспользуйтесь календарём рассылок.

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

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

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

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

Каналы

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

примечание

Для отправки по Email доступно использование основных контактных данных подписчика - поля Email в базе данных.

Подписчики

Рассылки в Альткрафт отправляются в рамках определённого Ресурса: это может быть отдельный сайт, продукт, акция, или другое направление ваших коммуникаций с клиентами.

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

подсказка

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

Источника данных (база данных или сегмент подписчиков) у триггерной рассылки нет. Аудитория рассылки зависит от запускающего триггер события.

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

Если триггерное событие — импорт в базу данных, убедитесь, что база данных доступна в выбранном Ресурсе рассылки! В противном случае сообщения отправлены не будут.

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

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

В фильтре по полям возможно добавление нескольких правил и их объединение с помощью логического И (все условия должны выполняться) и ИЛИ (хотя бы одно условие должно выполняться).

Шаблоны

В этом блоке выберите контент, который хотите использовать в рассылке. Шаблоны сообщений в Альткрафт объединяют контент для отправки по всем доступным каналам.

подсказка

Убедитесь, что контент для выбранного в рассылке канала присутствует в шаблоне!

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

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

Триггер

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

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

После генерации контента сообщение передаётся в общую очередь на отправку, где приоритет больше не учитывается — сообщения отправляются в порядке поступления. Исключение — отправка через email-канал с использованием AKMTA. В этом случае внутри сендера выделяется отдельная виртуальная очередь для приоритетных сообщений, что ускоряет их отправку. Для остальных каналов приоритет не влияет на порядок отправки на стороне сендера.

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

подсказка

Типы триггерных событий описаны в следующем пункте этой статьи!

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

Типы триггерных событий

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

При использовании особого вызова API

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

Для запуска триггерной рассылки доступны два варианта запроса к API:

  • В версии 1.0 возможно только запустить рассылку по ссылке, передав email, md5 или xxh нужного профиля. Используется простой GET запрос.
  • В версии 1.1 можно передать рассылке дополнительные параметры.

Нажмите примеры вызова API чтобы получить примеры запроса на запуск триггера:

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

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

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

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

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

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

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

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

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

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

При импорте через API

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

При импорте вручную

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

При любом импорте

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

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

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

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

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

Когда какое-либо поле изменено

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

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

УсловиеТип поляОписание
измененовсеЛюбое изменение в поле профиля
равновсе, кроме теги, объект, массив объектовНовое значение равно ожидаемому
не равновсе, кроме теги, объект, массив объектовНовое значение не равно ожидаемому
не пустоевсе, кроме тегиПоле получило любое не пустое значение
пустоевсе, кроме тегиВсе значения удалены для поля профиля
добавлен любой тег из спискатегиСписок определяется в триггере
удалён любой тег из спискатегиСписок определяется в триггере
свойство изменилосьобъектУказывается путь к ключу объекта. Если значение ключа изменится, сработает триггер.
свойство равнообъектУказывается путь к ключу объекта и ожидаемое значение. Если значение этого ключа примет ожидаемое значение, сработает триггер.
свойство не равнообъектУказывается путь к ключу объекта и ожидаемое значение. Если значение этого ключа не примет ожидаемое значение, сработает триггер.
свойство элемента изменилосьмассив объектовУказывается путь к элементу массива. Если свойство этого элемента изменится, сработает триггер.

При выборе пути к свойству элемента вы также выбираете тип данных, к которому приводить сравниваемое значение. Доступно сравнение таких типов данных, как 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.
свойство элемента равномассив объектовУказывается путь к элементу массива и ожидаемое значение. Если свойство этого элемента примет ожидаемое значение, сработает триггер.
свойство элемента не равномассив объектовУказывается путь к элементу массива и ожидаемое значение. Если свойство этого элемента не примет ожидаемое значение, сработает триггер.
добавлен элементмассив объектовВ массив добавляется новый элемент.
удален элементмассив объектовИз массива удаляется элемент.
предупреждение

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

Когда пиксель активирован

Пиксели Altcraft — это стек технологий для отслеживания действий клиентов на веб-сайтах. Вы можете разместить пиксель на своём веб-ресурсе или передать партнёрам и другим рефералам.

Триггерная рассылка может отслеживать, когда пиксель активируется для клиента с активными подписками на какой-либо канал, и отправлять сообщения сразу или по прошествии заданного времени:

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

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

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

подсказка

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

При изменении связи

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

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

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

При импорте через форму

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

Выберите форму и базу профилей:

При заполнении формы

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

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

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

При изменении заказа

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

  • добавление заказа (новый заказ был добавлен в маркет)
  • изменение заказа (изменился статус существующего заказа)

Возможные статусы заказа:

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

При импорте через попап

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

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

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

При изменении баланса баллов

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

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

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

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

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

Smart settings

Блок Smart settings (умные настройки) доступен в аккаунтах с активированной опцией "IS_SMART": true в файле конфигурации main.json. Он объединяет следующие дополнительные настройки рассылки:

  • Виртуальный сендер — позволяет выбрать для рассылки виртуальный сендер (набор правил для отправки сообщений с реальных сендеров платформы).
  • Свои трекинг-домены — позволяет отслеживать действия с сообщениями рассылки, используя дополнительные трекинг-серверы. Домены укажите, разделяя переносом строки.
  • Список email адресов для скрытой копии — BCC для отправляемых сообщений. Адреса укажите, разделяя переносом строки.
  • Дополнительные опции — зависят от конфигурации вашей установки Альткрафт. Доступны такие опции, как отправка без учёта статуса подписки или без учёта уникальности данных при отправке.
предупреждение

Проконсультируйтесь с администратором Altcraft вашей организации или со специалистами поддержки Altcraft, если не уверены, какие Smart настройки необходимо выбрать!