Захват событий Altcraft
Захват событий (Action Hooks) — это механизм уведомления внешних систем о событиях платформы. Это могут быть как системные действия, связанные с доставкой сообщений или импортом профилей подписчиков, так и действия клиентов, отслеженные пикселями платформы Altcraft на Вашем сайте или в приложении.
Захват событий может работать со всеми базами данных или с какой-либо конкретной. Захваченные события могут передаваться батчем в формате JSON по HTTP или отправляться в очередь брокера асинхронно.
Конфигурируется мастер-пользователем аккаунта для определенной базы данных или для всех сразу.
Чтобы начать работу, в главном меню выберите Интеграции → Захват событий:
Существующие захваты событий вы можете активировать или остановить, клонировать или удалить с помощью контекстного меню. Если вы хотите отредактировать захват, нажмите на его заголовок. Чтобы добавить новый, нажмите + Создать в верхней части страницы:
Основные настройки захвата событий
В Основных настройках введите имя нового захвата. Здесь же находится переключатель для активации процесса отправки событий:
Выбор действий для захвата
Захваты событий могут работать со всеми Базами профилей сразу или с одной конкретной. В блоке Настройки захвата выберите необходимый вариант в выпадающем меню База данных:
В поле Действия выберите из выпадающего меню события, которые будут передаваться во внешние системы. Типы событий, их обозначения в меню и в запросе захвата, а также описания вы найдёте в этой статье.
По умолчанию Захват регистрирует все события выбранных вами типов. Ограничить события так, чтобы получать более узкую выборку, можно в блоке Дополнительные фильтры:
- Ресурсы — будут захвачены события, связанные с коммуникациями в рамках определённых ресурсов.
- Кампания — будут захвачены события определённых маркетинговых кампаний.
- Сообщения — будут захвачены события кампаний, использующих определённые шаблоны сообщений.
- Сегменты — будут захвачены события, связанные с подписчиками, входящими в определённые сегменты.
- Пиксели — будут захвачены действия подписчиков на внешних ресурсах, зарегистрированные определёнными пикселями.
Настройки обратного запроса
Доступны следующие типы запроса:
- Отправить JSON запрос батчем. Подробнее.
- Отправить сообщение в очередь RabbitMQ. Подробнее.
- Отправить сообщение в exchange RabbitMQ. Подробнее.
- Отправить сообщение в Kafka broker. Подробнее.
Функция повторной отправки
Если во время отправки сообщения по каким-то причинам произошла ошибка (например, сбой сети), через определенное время сообщение будет отправлено снова. Количество повторных отправок и их периодичность устанавливаются в конфигурационном файле системы "main.json":
"HOOK_RETRY_TIMES"
: устанавливает максимальное количество попыток отправки (по умолчанию — 4)
"HOOK_RETRY_PERIOD_SEC"
: Периоды между попытками отправки, в секундах (по умолчанию — 15)