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_uuidVisit UUIDОчень высокая кардинальность; для отладки.
campaign_uuidCampaignsЧастый фильтр и группировка.
source_uuidSourceИсточник трафика.
flow_uuidFlowFlow AIO (если используется).
split_groupSplit GroupГруппа A/B-теста, если задана.

Локация

Ключ API (clickhouse_key)НазваниеПримечания
location_cityCityОпределяется, если доступно.
location_continentContinent
location_country_codeCountryКод страны ISO.
location_time_zoneTime ZoneЧасовой пояс IANA.

Браузер и устройство

Ключ API (clickhouse_key)НазваниеПримечания
browser_language_codeBrowser Languageнапример, en, fr.
ua_client_engineClient EngineBlink, Gecko и другие.
ua_client_engine_versionClient Engine Version
ua_client_familyClient Family
ua_client_nameClient NameChrome, Firefox и другие.
ua_client_typeClient Typebrowser/app/bot и другие.
ua_client_versionClient Version
ua_brand_nameBrand NameБренд устройства.
ua_device_nameDevice Name
ua_modelModelМодель устройства.
user_agentUser AgentПолный UA; высокая кардинальность.

ОС

Ключ API (clickhouse_key)НазваниеПримечания
ua_os_nameOS NameWindows, Android, iOS и другие.
os_combinedOS CombinedНормализованные ОС + версия.
ua_os_platformOS Platform
ua_os_versionOS Version

Время

Ключ API (clickhouse_key)НазваниеПримечания
created_at_dayDayГруппировка по дате.
created_at_hourHour0–23.
created_at_monthMonthYYYY-MM.
created_at_weekWeekНеделя по ISO.
created_at_yearYearYYYY.
day_partDay PartMorning/Afternoon/Evening/Night.
week_partWeek PartWeekday/Weekend (если настроено).

Web

Ключ API (clickhouse_key)НазваниеПримечания
initial_domainInitial DomainПервый увиденный домен.
initial_pathInitial PathПервый увиденный путь.
agent_versionAgent 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_nameFB Ad Name
field_fb_campaign_nameFB Campaign Name
field_fb_ad_set_idFB Ad Set ID
field_fb_ad_set_nameFB Ad Set Name
field_fb_ad_idFB Ad ID
field_fb_site_source_nameFB Site Source Name
field_fb_campaign_idFB Campaign ID
field_fb_placementFB Placement
refererReferer
campaign_owner_uuidCampaign OwnerСвязь с пользователем.
form_uuidForm
field_launcherLauncherСвязь с пользователем.

Примечания и оговорки

  • Всегда используйте clickhouse_key в API-запросе.
  • Кардинальность: visit_uuid, user_agent и некоторые пользовательские поля могут давать очень большое число групп.
  • Переключатели атрибуции: группировки по времени (created_at_*, day_part, week_part) учитывают event_time_attribution и back_fix_attribution из вашего запроса.

Связаться с поддержкой

Telegram