Дата и время в Meta Ads
Корректная работа с датами и временем критически важна для точности рекламной аналитики. Коннектор Meta Ads использует часовой пояс рекламного аккаунта и стандартизированные форматы дат.
Часовые пояса
Часовой пояс аккаунта
Все данные статистики Meta Ads привязаны к часовому поясу рекламного аккаунта. Часовой пояс задаётся при создании аккаунта и не может быть изменён.
Поле timezone_name в сущности аккаунта содержит часовой пояс в формате IANA (например, Europe/Moscow, America/New_York).
Важно: при анализе данных учитывайте разницу между часовым поясом аккаунта и вашим локальным временем.
Влияние на данные
- Границы суток: определяются по часовому поясу аккаунта
- Данные за "сегодня": могут быть неполными до конца суток по времени аккаунта
- Сравнение с Ads Manager: Ads Manager также использует часовой пояс аккаунта
Форматы дат
Стандартный формат
Все даты в API и в LightLead используют формат YYYY-MM-DD:
2026-07-25Поле date в статистике
Поле date в Insights представляет собой строку в формате YYYY-MM-DD и соответствует дню (в часовом поясе аккаунта), за который рассчитаны метрики.
Временные периоды (date_preset)
Предустановленные периоды
LightLead использует функцию resolveGraphDateRange для преобразования предустановленных периодов в конкретные даты:
| Период | Описание | Реализация |
|---|---|---|
today | Текущий день | since=today, until=today |
yesterday | Вчерашний день | since=yesterday, until=yesterday |
last_7d | Последние 7 дней | since=today-7d, until=today (не включая сегодня) |
last_30d | Последние 30 дней | since=today-30d, until=today (не включая сегодня) |
Кастомный период (time_range)
Произвольный диапазон дат через объект time_range:
{
"time_range": {
"since": "2026-07-01",
"until": "2026-07-25"
}
}Особенности:
since— начальная дата включительноuntil— конечная дата не включается в результат- Максимальный период: 37 месяцев (ограничение Meta API)
Агрегация по времени
По умолчанию
Данные агрегируются по дням. Каждая строка статистики соответствует одному дню.
Hourly-статистика
Доступна через разбивку hourly_stats_aggregated_by_advertiser_time_zone:
- Данные агрегируются по часам в часовом поясе аккаунта
- Полезно для анализа эффективности по времени суток
- Доступно только для ограниченного периода (обычно 7-30 дней)
Задержка данных
Данные Meta Ads обновляются с задержкой:
- Данные за сегодня: могут быть неполными, обновляются в течение дня с задержкой 15-60 минут
- Данные за вчера: обычно полные к утру следующего дня (по времени аккаунта)
- Исторические данные: стабильны и не меняются
Атрибуционная задержка
Конверсии могут быть засчитаны с задержкой до 7 дней после клика (в зависимости от окна атрибуции). Это означает, что данные за последние 7 дней могут измениться при повторном запросе.
Рекомендации
- Не анализируйте "сегодня": данные за текущий день неполные
- Учитывайте задержку конверсий: при анализе ROAS за последние дни добавляйте поправку на незасчитанные конверсии
- Используйте yesterday для daily-отчётов: данные за вчерашний день наиболее актуальны и полны
- Сравнивайте периоды одинаковой длины: week-over-week, month-over-month