Решение проблем Meta Ads

В этом разделе описаны типовые проблемы при работе с коннектором Meta Ads, их причины и способы решения.

Ошибки троттлинга (Throttle Errors)

Троттлинг — наиболее частая проблема при интенсивной работе с Meta API. Возникает при превышении лимитов запросов.

Код 4: Application request limit reached

• Описание: Превышен лимит запросов на уровне всего приложения
• Причина: Интеграция отправляет слишком много запросов в короткий промежуток времени
• Решение: Ожидание и автоматический повтор через экспоненциальный backoff. Если повторяется часто — проверьте нагрузку на уровне приложения, уменьшите количество параллельных запросов

Код 17: User request limit reached

• Описание: Превышен лимит запросов от конкретного пользователя
• Причина: Слишком много запросов от одного пользовательского токена
• Решение: Подождите и повторите позже. Распределите запросы на более длительный период

Код 32: Page-level throttling

• Описание: Троттлинг на уровне Facebook-страницы
• Причина: Слишком много запросов к данным конкретной страницы
• Решение: Распределите запросы между страницами или уменьшите частоту запросов к одной странице

Код 613: Custom-level throttling

• Описание: Пользовательское ограничение на уровне приложения
• Причина: Включены кастомные ограничения в настройках Meta Business
• Решение: Проверьте настройки rate limiting в Meta Business App Dashboard

Код 80000: Instagram business use case throttling

• Описание: Ограничение Instagram для бизнес-сценариев
• Причина: Превышена частота запросов к Instagram API
• Решение: Уменьшите частоту запросов к Instagram API. Разделите запросы Meta Ads и Instagram Insights

Код 80003: Ads management throttling (custom audiences)

• Описание: Ограничение для custom audiences в ads management
• Причина: Частые запросы к custom audiences через ads management API
• Решение: Подождите и повторите. Оптимизируйте запросы к аудиториям

Код 80004: Ads management general throttling

• Описание: Общее ограничение для ads management
• Причина: Превышение лимита запросов к ads management API
• Решение: Снизьте частоту запросов. Используйте batch-запросы где возможно

Код 80014: Ads insights throttling

• Описание: Троттлинг для ads insights
• Причина: Слишком много запросов к /insights endpoint
• Решение: Уменьшите количество параллельных запросов статистики. Используйте асинхронные отчёты для больших объёмов данных

Ошибки размера запроса (Payload Errors)

Payload too large (code: 1, subcode: 99)

• Описание: Запрос превышает допустимый размер (code: 1, subcode: 99)
• Причина: Слишком много полей или метрик в одном запросе
• Решение: Разбейте запрос на несколько меньших. Запрашивайте метрики группами по 10-15 штук за раз

Payload too large (code: 100, subcode: 1487534)

• Описание: Запрос превышает допустимый размер (code: 100, subcode: 1487534)
• Причина: Аналогично — слишком большой запрос
• Решение: Уменьшите размер запроса: меньше полей, меньше разбивок, короче период

Транспортные ошибки

HTTP 5xx Server Error

• Описание: Ошибка на стороне серверов Meta (500, 502, 503, 504)
• Причина: Временная недоступность или перегрузка серверов Meta
• Решение: Автоматический повтор через backoff. Обычно проходит в течение нескольких минут

ECONNABORTED — Connection Aborted

• Описание: Соединение прервано
• Причина: Сервер Meta разорвал соединение до получения полного ответа
• Решение: Автоматический повтор через backoff

ECONNRESET — Connection Reset

• Описание: Соединение сброшено сервером
• Причина: Сервер Meta принудительно закрыл соединение
• Решение: Автоматический повтор

ETIMEDOUT — Connection Timed Out

• Описание: Таймаут соединения с серверами Meta
• Причина: Сетевые проблемы или перегрузка серверов
• Решение: Автоматический повтор через backoff. Проверьте сетевое подключение

EAI_AGAIN — DNS Lookup Failed

• Описание: Временный сбой DNS-резолвинга
• Причина: Проблемы с DNS-сервером
• Решение: Автоматический повтор через backoff. Обычно проходит быстро

HTTP 429 Too Many Requests

• Описание: Стандартный HTTP-статус превышения лимита запросов
• Причина: Превышен rate limit API
• Решение: Используйте estimated_time_to_regain_access из заголовка ответа для расчёта времени ожидания. Примените стратегию backoff

Проблемы с данными

Отсутствуют креативные поля

• Симптом: Поля thumbnail_url, body, link, video_id пустые
• Причина: Ошибка при обогащении креативами — основной запрос успешен, но запрос креативов упал
• Решение: Повторите запрос. Если проблема повторяется, проверьте доступность креативов в Ads Manager

Неполные данные за сегодня

• Симптом: Метрики за сегодня значительно ниже ожидаемых
• Причина: API обновляется с задержкой 15-60 минут
• Решение: Используйте данные за вчера для точной аналитики

Изменяющиеся исторические данные

• Симптом: Данные за период 2-7 дней назад меняются при повторном запросе
• Причина: Атрибуционная задержка — новые конверсии добавляются в пределах окна атрибуции
• Решение: Для точных отчётов используйте данные старше 7 дней

Обрезанные результаты (paging truncation)

• Симптом: Не все кампании/объявления попадают в результат
• Причина: Превышен лимит META_MAX_PAGES
• Решение: Используйте фильтры для сужения выборки или запрашивайте данные по частям

Диагностика проблем

Проверка статуса токена

Используйте Access Token Debugger для проверки:

• Срока действия токена
• Списка активных permissions
• Наличия необходимых scopes

Проверка в Graph API Explorer

Для изоляции проблемы выполните запрос напрямую через Graph API Explorer:

1. Выберите приложение LightLead
2. Получите токен с нужными permissions
3. Выполните проблемный запрос
4. Сравните результат с данными в LightLead

Логирование

При обращении в поддержку подготовьте:

1. ID рекламного аккаунта (act_XXXXXXXXXX)
2. Период, за который запрашивались данные
3. Набор запрашиваемых полей и метрик
4. Текст ошибки из интерфейса LightLead
5. Время возникновения проблемы (с часовым поясом)

Связанные страницы

• Ограничения
• Расхождения данных
• Подключение Meta Ads
• Права доступа
• Переподключение коннектора