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

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

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

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

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

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

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

Каналы

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

примечание

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

Подписчики

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

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

подсказка

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

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

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

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

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

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

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

Шаблоны

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

подсказка

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

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

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

Триггер

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

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

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

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

подсказка

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

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

примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Заполнение попапа

Если вы хотите запускать рассылку по триггеру "Заполнение попапа", вам необходимо обеспечить условия для матчинга. Условия для матчинга настраиваются в параметрах matching_mode и matching, например:

acpopup('create', 'AP-6eVbo2dP2Nnh0wtBp', {
    matching_mode: 'email',
    matching: {
        email: 'john@example.com',
        db_ids: [1]
    },
    smid: 'send_message_id',
})

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

Затем добавьте следующий код в JS-раздел настроек попапа:

document.querySelector('[data-ac-popup-container]')?.shadowRoot?.getElementById('ac-form')?.addEventListener('submit', (event) => {    
    const formData = new FormData(event.currentTarget);
    const email = formData.get("{{popup('form' 'email' 'fieldData')}}");

    if (email) {
        acpopup('sendEvent', 'AP-484uAZEXfQkR7d9ix', {
            web_event_name: 'submit', // идентификатор кастомного события
            matching_mode: 'email',
            matching: {
                email,
                db_ids: [1], // ID базы профилей
            },
        });
    }
});

Что нужно изменить в коде:

• AP-484uAZEXfQkR7d9ix — замените на ID вашего попапа;
• db_ids: [1] — укажите ID вашей базы профилей;
• Если поле ввода email имеет другое имя, замените 'email' в formData.get().

Настройка триггера: в поле "Имя события" укажите то же значение, что и в web_event_name (в примере — submit).

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

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

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

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

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

Условие	Тип поля	Описание
изменено	все	Любое изменение в поле профиля
равно	все, кроме теги, объект, массив объектов	Новое значение равно ожидаемому
не равно	все, кроме теги, объект, массив объектов	Новое значение не равно ожидаемому
не пустое	все, кроме теги	Поле получило любое не пустое значение
пустое	все, кроме теги	Все значения удалены для поля профиля
добавлен любой тег из списка	теги	Список определяется в триггере
удалён любой тег из списка	теги	Список определяется в триггере
свойство изменилось	объект	Указывается путь к ключу объекта. Если значение ключа изменится, сработает триггер.
свойство равно	объект	Указывается путь к ключу объекта и ожидаемое значение. Если значение этого ключа примет ожидаемое значение, сработает триггер.
свойство не равно	объект	Указывается путь к ключу объекта и ожидаемое значение. Если значение этого ключа не примет ожидаемое значение, сработает триггер.
свойство элемента изменилось	массив объектов	Указывается путь к элементу массива. Если свойство этого элемента изменится, сработает триггер. При выборе пути к свойству элемента вы также выбираете тип данных, к которому приводить сравниваемое значение. Доступно сравнение таких типов данных, как 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-настройки объединяет следующие дополнительные настройки рассылки:

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

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

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

Наблюдатели за рассылкой

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

В Smart-настройках выберите БД наблюдателей и лимит отправки сообщений для каждого запуска рассылки:

Ограничение времени жизни сообщения (TTL)

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

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

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

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

Нюансы использования TTL для сообщений

• Значение TTL должно находиться в пределах, заданных конфигурационными параметрами MTA_MIN_TTL и MTA_MAX_TTL.
• Если TTL задан в нескольких местах, применяется значение с более высоким приоритетом: API-параметр expiration > значение в Smart-настройках > конфигурационный параметр MTA_TTL_DEFAULT.
• TTL отсчитывается отдельно для каждого сообщения с момента его постановки в очередь. Соответственно, даже в рамках одной рассылки у разных получателей может быть разный TTL сообщения.
• После истечения TTL система прекращает попытки доставки, даже если канал технически ещё может доставить сообщение.
• TTL не работает для каналов, которые не возвращают статусы отправки сообщений: Telegram, MAX и пользовательские каналы.