Коды ошибок CAPI: кросс-сетевой справочник
Коды ошибок CAPI выглядят по-разному в каждой сети, но слои отказов повторяются: payload, который сервер не смог разобрать, креденшел, который не прошёл, отсутствующее право, слишком быстрый темп или авария платформы. Этот справочник раскладывает слои по Meta, TikTok, Reddit, Pinterest и Snapchat, цитируя фирменные ошибки каждой сети и со ссылками на подробный гайд с полной таблицей для каждой сети.
Общие слои отказов
| Слой | Что означает | Типичный ответ сети |
|---|---|---|
| Payload | Тело события нарушает схему или лимиты | Ошибки 400-семейства |
| Креденшелы | Токен отсутствует, невалиден или истёк | Ошибки 401-семейства |
| Права | Токен работает, но не хватает прав или скоупа | Ошибки 403-семейства |
| Темп | Исчерпаны rate limits или квота | Ошибки 429-семейства |
| Платформа | Авария сервиса | Ошибки 500-семейства |
Читать ошибку как диагноз слоя быстрее отладки вслепую: 400 - значения события, 401 - сам токен, 403 - аккаунт или скоуп, 429 - темп отправки, 500 - ждать.
Фирменные ошибки по сетям
| Сеть | Фирменная ошибка | Что значит | Глубокий гайд |
|---|---|---|---|
| Meta | 2804003 | Событие старше 7 дней - падает весь запрос | Ошибка Meta CAPI 2804003 |
| Meta | Проседает Event Match Quality | Не ошибка - матчинг деградирует молча | Коды ошибок Meta CAPI |
| TikTok | Несовпадение event_id | Обе копии - пиксел и Events API - засчитываются | Коды ошибок TikTok Events API |
| "None were processed" (400) | Одно невалидное событие валит весь батч | Ошибки Reddit Conversions API | |
| 429 с дефолтным user agent | Троттлинг за generic-строку UA | Ошибки Reddit Conversions API | |
| 400 "unexpected data" | Пейлоад v5 не удалось разобрать | Ошибки Pinterest Conversions API | |
| Низкий EQS | Не ошибка - полнота payload деградирует | Ошибки Pinterest Conversions API | |
| Snapchat | Событие без match key | Жёсткое отклонение по дизайну | Ошибки Snapchat Conversions API |
| Snapchat | Кросс-организационный токен | Токен покрывает пикселы только своей организации | Ошибки Snapchat Conversions API |
Два пункта заслуживают второго прочтения. Meta 2804003 валит весь запрос из-за одного протухшего события - таймстампы старше семи дней отклоняются, и ничего из батча не обрабатывается. Замок match key у Snap столь же абсолютен: событие без хотя бы одного хешированного идентификатора отклоняется по дизайну, поэтому шаблон пейлоада начинается с него.
OpenAI: самая младшая из API
Conversions API OpenAI - новейшая сеть в этом справочнике, и её документированная дедупликация - общий id плюс совпадающий event_name под тем же Pixel ID - отказывает мягко: несовпавшие идентификаторы дают двойной счёт, а не ошибку. Правила пейлоада - в стандартных событиях ChatGPT Ads, шаблон доставки - в ChatGPT Ads через server-side GTM.
Привычка, которая бьёт любую таблицу ошибок
Каждая сеть документирует поверхность валидации - Test Events у Meta, Event Testing с test ID у Reddit, тестовые события и EQS у Pinterest, Test Event-зеркало у Snap, - а дисциплина conversion ID и match key определяет, возникнут ли эти ошибки вообще. Для пайплайнов, обязанных выживать на пяти сетях сразу, MOST применяет правила каждой сети автоматически, а Pixel Activator валидирует одиночное событие руками. Маршрутный слой, кормящий эти API, разобран в гайде по server-side tracking для перфоманса.
Frequently asked questions
Sources
Sources
- Ручное тестирование и валидация: Pixel Activator отправляет бесплатные тестовые события, пока вы настраиваете параметры.
- Автоматическая доставка: Most маршрутизирует конверсии из трекера или CRM непрерывно, с дедупликацией и ретраями.