Параметры отчётов
Универсальные параметры, доступные при создании и настройке любого отчёта в LightLead.
Общая структура параметров
Каждый отчёт формируется на основе следующего набора параметров:
json
{
"name": "string",
"source_ids": ["uuid"],
"date_range": "object",
"dimensions": ["string"],
"metrics": ["string"],
"filters": ["object"],
"sorting": ["object"],
"write_mode": "string",
"schedule": "object|null"
}Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
name | строка | Да | Название отчёта, отображается в интерфейсе |
source_ids | массив UUID | Да | Идентификаторы источников, из которых собираются данные |
date_range | объект | Да | Диапазон дат: предустановленный или произвольный |
dimensions | массив строк | Нет | Измерения (столбцы группировки) |
metrics | массив строк | Нет | Метрики (числовые показатели) |
calculated_metrics | массив объектов | Нет | Вычисляемые метрики с формулами |
filters | массив объектов | Нет | Условия фильтрации строк |
sorting | массив объектов | Нет | Правила сортировки |
write_mode | строка | Нет | Режим обновления данных (по умолчанию Replace) |
schedule | объект | Нет | Расписание автоматического обновления |
limit | число | Нет | Максимальное количество строк в результате |
currency | строка | Нет | Валюта для приведения денежных метрик |
timezone | строка | Нет | Часовой пояс для временных метрик |
Date Range
Объект date_range может принимать одну из двух форм:
Предустановленный диапазон:
json
{
"preset": "last_7_days"
}Произвольный диапазон:
json
{
"start": "2026-01-01",
"end": "2026-01-31"
}Доступные пресеты: today, yesterday, last_3_days, last_7_days, last_14_days, last_30_days, this_week, last_week, this_month, last_month, this_quarter, last_quarter, this_year, last_year, all_time.
Filters
Каждый фильтр состоит из трёх элементов:
json
{
"field": "campaign_name",
"operator": "CONTAIN",
"value": "Поиск"
}Поддерживаются операторы AND (все условия) и OR (любое из условий). Вложенная логика задаётся через группировку фильтров:
json
{
"logic": "AND",
"conditions": [
{"field": "clicks", "operator": "GREATER_THAN", "value": 100},
{"field": "cost", "operator": "GREATER_THAN", "value": 50}
]
}