Структуры сообщений захвата событий
Общая структура
Общая структура hook-сообщения для большинства типов событий:
| Параметр | Тип | Обязательный | Пример | Описание |
|---|---|---|---|---|
| event_type | string | Да | "click" | Название события как в таблице типы событий |
| event_date | string | Да | "2018-03-04T13:13:19.034315796Z" | Дата возникновения события в формате RFC 3339 |
| profile_id | string | Нет | "abcdefgh12345678" | ID профиля получателя |
| _xxh | string | Нет | "ad1850e0d1d9481e" | Хеш от email подписчика, используемый для идентификации в Altcraft |
| _md5 | string | Нет | "145bb30f7ddf1184cb560bc4b7705646" | MD5 хеш от email подписчика |
| list_id | int | Нет | 111 | ID Базы данных, в рамках которого возникло событие |
| account_id | int | Да | 23 | ID Аккаунта, в рамках которого возникло событие |
| sends_trying_num | int | Нет | 2 | Число попыток отправки сообщения (присутствует, только если количество попыток больше 0) |
| is_test | bool | Да | false | Было ли событие вызвано тестовой отправкой сообщения |
| is_static | bool | Нет | false | Использовались ли динамические подстановки в отправляемый контент |
| subscription_hash_id | string | Нет | "0a4b910312345" | Хеш подписки |
| custom_data | JSON object | Нет | {"alice@example.org"} | Набор данных о подписчике, настраиваемый в интерфейсе редактирования Action Hook |
| event_data | JSON object | Да | {"browser": "Firefox"} | Набор данных, зависящий от типа события (есть два типа — событие в трекинге и возникающее в процессе доставки) |
| subscription | array | Нет | [ | Массив с деталями подписки, включающий информацию о ресурсе, канале связи, получателе и статусе подписки. Структура описана ниже. |
Обратите внимание
При экспорте исторических событий контент сообщений не передается, события отправляются тем же форматом, что и в реальном времени, а для удаленных профилей передается null.
Структура event_data
События кампаний
Для событий следующих типов:
- sc_add — профиль добавлен в аудиторию кампании
- sc_gcg_suppress — профиль не добавлен в аудиторию кампании из-за нахождения в ГКГ
- sc_test_group_assign — профиль распределен в тестовую группу
- sc_control_group_assign — профиль распределен в контрольную группу
- sc_remove — профиль исключен из аудитории кампании
| Параметр | Тип | Обязательн ый | Пример | Описание |
|---|---|---|---|---|
| scampaign_id | int | Нет | 1 | ID кампании в Altcraft |
| segment_id | int | Нет | 5 | ID сегмента, связанного с аудиторией кампании |
| prev_st | int | Нет | 1 | Идентификатор группы: 1 — тестовая, 2 — ЛКГ |
События системы трекинга
Для событий следующих типов:
- Email: uopen, open, uclick, click, confirm, confirmsub, unsub, read, glanced, skimmed
- SMS: uclick_sms, click_sms, unsub_sms
- Push: uopen_push, open_push, click_push, uclick_push
| Параметр | Тип | Обязательный | Пример | Для какого канала | Описание |
|---|---|---|---|---|---|
| message_id | int | Да | 17 | Email, SMS, Push | ID сообщения в системе Altcraft |
| campaign_id | int | Да | 973 | Email, SMS, Push | ID рассылки в системе Altcraft |
| scampaign_id | int | Нет | 973 | Для всех | ID кампании в системе Altcraft |
| segment_id | int | Нет | 0 | Email, SMS, Push | ID сегмента, если доступно |
| resource_id | int | Да | 3 | Email, SMS, Push | ID ресурса |
| ip | string | Нет | "10.9.0.14" | Email, Push | IPv4 адрес подписчика |
| country | string | Нет | ".us" ".ru" | Email, Push | Страна в TLD виде |
| city | string | Нет | "New York" "Moscow" | Email, Push | Город подписчика |
| postal_code | string | Нет | "101000" | Email, Push | Почтовый код подписчика |
| region | string | Нет | "Ohio" "Moskovskaya oblast" | Email, Push | Регион подписчика |
| tz | string | Нет | "Europe/Vaduz" | Email, Push | Временная зона подписчика |
| lat | float | Нет | 55.244075 | Email, Push | Географическая широта |
| lon | float | Нет | 55.244075 | Email, Push | Географическая долгота |
| user_agent | string | Нет | "Mozilla/5.0 (X11; Linux x86_64; rv:59.0) Gecko/20100101 Firefox/59.0" | Email, Push | Строка в заголовке User-Agent |
| os | string | Нет | "Linux x86_64" | Email, Push | Операционная система |
| browser | string | Нет | "Firefox" | Email, Push | Браузер, версия |
| device | string | Нет | "web" | Email, Push | Устройство |
| wick | int |