Параметры запроса Meta Ads
При формировании запроса данных через коннектор Meta Ads используются следующие параметры, определяющие уровень детализации, временной период и логику атрибуции.
Уровень детализации (level)
Определяет, на каком уровне иерархии будут сгруппированы данные:
| Значение | Описание |
|---|---|
account | Уровень рекламного аккаунта — агрегированные данные по всем кампаниям |
campaign | Уровень кампании — данные сгруппированы по кампаниям |
adset | Уровень группы объявлений — данные по каждой группе |
ad | Уровень объявления — самые детальные данные по каждому объявлению |
По умолчанию: ad (максимальная детализация)
Временной период (date_preset)
Предустановленные диапазоны дат через Graph API:
| Значение | Описание |
|---|---|
today | Только сегодняшний день |
yesterday | Вчерашний день |
last_7d | Последние 7 дней (не включая сегодня) |
last_30d | Последние 30 дней (не включая сегодня) |
this_month | Текущий месяц |
last_month | Прошлый месяц |
lifetime | За всё время |
По умолчанию: last_30d
Реализация: через функцию resolveGraphDateRange
Кастомный период (time_range)
Для произвольного диапазона дат используется объект time_range:
{
"time_range": {
"since": "2026-07-01",
"until": "2026-07-25"
}
}Формат дат: YYYY-MM-DD. Период until не включается в результат.
Поля для запроса (fields)
Список полей, которые будут включены в ответ. LightLead автоматически формирует оптимальный набор полей в зависимости от конфигурации отчёта. Основные категории:
- Структурные поля:
campaign_name,adset_name,ad_name,account_name - Метрики:
spend,impressions,clicks,ctr,cpc,cpm,reach,frequency - Конверсионные метрики:
purchases,purchase_value,purchase_roas - Действия:
actions,action_values,cost_per_action_type
Лимит записей (limit)
Количество записей на одной странице ответа API:
| Параметр | Значение |
|---|---|
| Максимум на страницу | Определяется META_MAX_PAGES |
| По умолчанию | Настраивается в runtimeConfig.providers.meta.maxPages |
При превышении лимита страниц в лог записывается событие meta_paging_truncated.
Параметры асинхронных отчётов
Для больших объёмов данных используются асинхронные отчёты — см. Асинхронные отчёты.