Ошибки Pinterest Conversions API: коды ответов и фиксы
Ошибки Pinterest Conversions API необычно опрятны: эндпоинт событий v5 документирует три семейства ответов, и каждое указывает на свой слой пайплайна. 400 - проблема payload, 401 - проблема креденшелов, а 200 - единственный код успеха - подтверждает прохождение запроса. Между ними сидят предупреждения качества, которые ничего не отклоняют, но предсказывают, сколько от payload Pinterest реально сможет использовать.
Таблица ответов
| Ответ | Формулировка Pinterest | Слой | Фикс |
|---|---|---|---|
| 200 | "The request has succeeded." | Нет - событие обработано | Всё равно провалидируйте его в Events Manager |
| 400 | "The request could not be understood by the server due to unexpected data." | Payload: битые поля, неверные типы, сломанный JSON | Сверьте значения и типы полей со схемой v5 |
| 401 | Отказ аутентификации | Токен доступа: отсутствует, невалиден или от другого аккаунта | Перегенерируйте токен в Ads Manager и сверьте ID аккаунта |
Формулировка 400 сама по себе диагностична: unexpected data значит, что Pinterest получил запрос, но не смог его разобрать или провалидировать - проверьте структуру JSON, event_name против документированного набора и хеширование user_data. Семейство 401 уже: токен в заголовке Authorization не аутентифицировался - обычно он был перегенерирован в Ads Manager, пока пайплайн держал старую копию, либо ID рекламного аккаунта в пути эндпоинта принадлежит другому аккаунту, чем токен.
Предупреждения качества до жёстких отказов
Модель валидации Pinterest ставит Event Quality Score и тестовые события впереди жёстких отказов: слабости payload всплывают в EQS и во вью тестовых событий задолго до любого жёсткого отказа - именно поэтому они работают слоем раннего предупреждения. Вью тестовых событий показывает коды ответа на каждый запрос по мере срабатывания конверсий - это место, где 400 ловятся до продакшн-трафика. Механика оценки - в метрике Event Quality Score, процесс валидации - тестовые события, отчёт по дедупликации, EQS - в полном руководстве.
Жизненный цикл токена
Токен доступа генерируется в Ads Manager, показывается один раз и копируется вместе с ID рекламного аккаунта - значит, у пайплайна, правильно сохранившего значение, остаётся ровно один сценарий 401: токен перегенерировали (восстановление потерянного, ротация команды), а старая копия продолжает отказывать. Рекомендация Pinterest не делиться токенами без безопасного канала существует по той же причине. Проход по креденшелам - в настройке Pinterest Conversions API, правила пейлоада, предотвращающие 400, - в событиях Pinterest. Для команд, отлаживающих одно событие руками, Pixel Activator отправляет валидные тестовые события без пайплайна; Most берёт на себя ретраи и гигиену токенов при регулярной доставке. Карта кластера - в полном руководстве.
Frequently asked questions
Sources
Sources
- Ручное тестирование и валидация: Pixel Activator отправляет бесплатные тестовые события, пока вы настраиваете параметры.
- Автоматическая доставка: Most маршрутизирует конверсии из трекера или CRM непрерывно, с дедупликацией и ретраями.