AIO API — каталог Fields & Groupers
Подставляйте clickhouse_key вdefinitions[].key(группировка) иconditions[].key(фильтрация).
Как использовать
- Группировка
{ "definitions": [ { "key": "landing_uuids[1]" }, { "key": "location_country_code" } ] } - Фильтрация
{ "conditions": [ { "key": "campaign_uuid", "values": ["<campaign-uuid>"] } ] }
Трекер
| Ключ API (clickhouse_key) | Название | Примечания |
|---|---|---|
visit_uuid | Visit UUID | Очень высокая кардинальность; для отладки. |
campaign_uuid | Campaigns | Частый фильтр и группировка. |
source_uuid | Source | Источник трафика. |
flow_uuid | Flow | Flow AIO (если используется). |
split_group | Split Group | Группа A/B-теста, если задана. |
Локация
| Ключ API (clickhouse_key) | Название | Примечания |
|---|---|---|
location_city | City | Определяется, если доступно. |
location_continent | Continent | |
location_country_code | Country | Код страны ISO. |
location_time_zone | Time Zone | Часовой пояс IANA. |
Браузер и устройство
| Ключ API (clickhouse_key) | Название | Примечания |
|---|---|---|
browser_language_code | Browser Language | например, en, fr. |
ua_client_engine | Client Engine | Blink, Gecko и другие. |
ua_client_engine_version | Client Engine Version | |
ua_client_family | Client Family | |
ua_client_name | Client Name | Chrome, Firefox и другие. |
ua_client_type | Client Type | browser/app/bot и другие. |
ua_client_version | Client Version | |
ua_brand_name | Brand Name | Бренд устройства. |
ua_device_name | Device Name | |
ua_model | Model | Модель устройства. |
user_agent | User Agent | Полный UA; высокая кардинальность. |
ОС
| Ключ API (clickhouse_key) | Название | Примечания |
|---|---|---|
ua_os_name | OS Name | Windows, Android, iOS и другие. |
os_combined | OS Combined | Нормализованные ОС + версия. |
ua_os_platform | OS Platform | |
ua_os_version | OS Version |
Время
| Ключ API (clickhouse_key) | Название | Примечания |
|---|---|---|
created_at_day | Day | Группировка по дате. |
created_at_hour | Hour | 0–23. |
created_at_month | Month | YYYY-MM. |
created_at_week | Week | Неделя по ISO. |
created_at_year | Year | YYYY. |
day_part | Day Part | Morning/Afternoon/Evening/Night. |
week_part | Week Part | Weekday/Weekend (если настроено). |
Web
| Ключ API (clickhouse_key) | Название | Примечания |
|---|---|---|
initial_domain | Initial Domain | Первый увиденный домен. |
initial_path | Initial Path | Первый увиденный путь. |
agent_version | Agent Version | Версия JS-агента AIO. |
Лендинги и типы лендингов (позиционные)
| Ключ API (clickhouse_key) | Название | Примечания |
|---|---|---|
landing_uuids[1] | LP #1 | Первый лендинг. |
landing_uuids[2] | LP #2 | Второй лендинг. |
landing_uuids[3] | LP #3 | Третий лендинг. |
landing_type_uuids[1] | LP Type #1 | Тип LP #1. |
landing_type_uuids[2] | LP Type #2 | Тип LP #2. |
landing_type_uuids[3] | LP Type #3 | Тип LP #3. |
Destinations и рекламодатели (позиционные)
| Ключ API (clickhouse_key) | Название | Примечания |
|---|---|---|
destination_uuids[1] | Destination #1 | Первый Destination. |
destination_uuids[2] | Destination #2 | Второй Destination. |
destination_uuids[3] | Destination #3 | Третий Destination. |
advertiser_uuids[1] | Advertiser #1 | Первый рекламодатель. |
advertiser_uuids[2] | Advertiser #2 | Второй рекламодатель. |
advertiser_uuids[3] | Advertiser #3 | Третий рекламодатель. |
Custom / System / Facebook / Source
| Ключ API (clickhouse_key) | Название | Примечания |
|---|---|---|
field_fb_ad_name | FB Ad Name | |
field_fb_campaign_name | FB Campaign Name | |
field_fb_ad_set_id | FB Ad Set ID | |
field_fb_ad_set_name | FB Ad Set Name | |
field_fb_ad_id | FB Ad ID | |
field_fb_site_source_name | FB Site Source Name | |
field_fb_campaign_id | FB Campaign ID | |
field_fb_placement | FB Placement | |
referer | Referer | |
campaign_owner_uuid | Campaign Owner | Связь с пользователем. |
form_uuid | Form | |
field_launcher | Launcher | Связь с пользователем. |
Примечания и оговорки
- Всегда используйте
clickhouse_keyв API-запросе. - Кардинальность:
visit_uuid,user_agentи некоторые пользовательские поля могут давать очень большое число групп. - Переключатели атрибуции: группировки по времени (
created_at_*,day_part,week_part) учитываютevent_time_attributionиback_fix_attributionиз вашего запроса.