Pinterest Conversions API: полное руководство

Pinterest Conversions API - серверный канал Pinterest для данных о конверсиях: ваш сервер, трекер или CRM отправляет конверсии напрямую в Pinterest, не полагаясь на браузерный тег. Эта страница - парадная дверь нашего кластера Pinterest CAPI: что покрывает API, что нужно рабочему событию, как сходятся дедупликация и Event Quality Score, и где у каждой конкретной проблемы - отклонённое событие, двойной счёт, просевший скор - свой глубокий гайд.

Что покрывает Pinterest Conversions API

Pinterest сознательно облегчает вход: любой бизнес-аккаунт может использовать API, и в отличие от остальных Pinterest API-продуктов он не требует создания приложения или валидного app ID. Токен генерируется на странице Conversions в Ads Manager - Conversions, Set Up API, Generate new token - и ездит вместе с ID рекламного аккаунта, адресующим каждый вызов. Поддерживаются все три типа конверсий: web, in-app и in-store/offline, что делает API единым каналом доставки для смешанных воронок. Pinterest также заявляет, что серверные события ведут себя как события тега или мобильного измерительного партнёра - полноценные сигналы для атрибуции и оптимизации.

Пошаговый проход настройки - в отдельном гайде: настройка Pinterest Conversions API.

Как выглядит рабочее событие

API v5 Pinterest постит конверсии на POST /v5/ad_accounts/{ad_account_id}/events. Каждое событие несёт event_name из документированного набора (checkout, add_to_cart, page_visit, signup и остальные), action_source, сообщающий, где оно случилось (web, app_ios, app_android, offline), event_time и event_id - поле, на котором держится дедупликация. Опционально, но ценно: user_data с хешированными идентификаторами, event_source_url и custom_data для деталей, которые Pinterest выносит в отчёты. Запросы несут и privacy-переключатели Pinterest - opt_out и advertiser_tracking_enabled - и partner_name, идентифицирующий отправляющую интеграцию.

Тайминг доставки - заявленное требование: Pinterest просит доставлять события как можно ближе к real-time, до одного часа, чтобы оптимизация и биддинг работали со свежими данными. Разбор по полям - в событиях и параметрах Pinterest CAPI.

Дедупликация: сначала event_id

Связка Pinterest-тега и Conversions API - собственная рекомендация Pinterest, потому что комбинация максимизирует видимость конверсий, - но та же конверсия тогда приезжает дважды, и фикс - параметр event_id: одинаковый на обеих сторонах для одного события. event_id, который умеет считать только одна сторона, молча отключает дедуп, и расхождение всплывает позже как завышенные цифры Ads Manager. Механика общего ключа - в дедупликации по event ID, кроссплатформенная карта полей - в матрице параметров.

Event Quality Score и хешированные идентификаторы за ним

Валидация Pinterest называет три чекпоинта в Events Manager: тестовые события с кодами ответа, страница дедупликации и Event Quality Score - оценка, показывающая, сколько от payload Pinterest реально может использовать. Рекомендация онбординга - передавать данные так, чтобы выйти на «Good» EQS. Рычаги обычные: хешированный email и другие идентификаторы (Enhanced Match отправляет хешированные email с браузерной стороны, когда куки Pinterest нет), корректная канонизация по хешированию user data и клик-ID, переживший воронку. Скор и его рычаги - в event quality score, Pinterest-версия браузерного хешированного матчинга - в настройке Enhanced Match.

Офлайн-конверсии и окна атрибуции

Pinterest принимает in-store/offline конверсии через API как один из трёх типов - и предлагает фолбэк без кода: файл офлайн-конверсий, загружаемый в Ads Manager, с атрибуцией конверсий из файла. Атрибуция работает в настраиваемом конверсионном окне; если окно не выбрано, Pinterest по умолчанию репортит 1-день view и 30-день click, настройки меняются на уровне рекламного аккаунта. У обеих тем свои гайды: офлайн и in-store конверсии Pinterest и окно атрибуции Pinterest.

Автоматизация доставки: Keitaro, Pixel Activator и Most

Если воронка живёт в Keitaro, трекер хранит идентичность клика, а слой доставки собирает пейлоад Pinterest - проводка в интеграции Keitaro и Pinterest, паттерн объясняет Meta-близнец. Для одиночных ручных тестов Pixel Activator - точка входа без настройки. Когда доставка должна случаться всегда - ретраи, дедуп, хеширование, круглосуточная маршрутизация - это Most. Команды, доставляющие через серверный Google Tag Manager, найдут, что правила пейлоада переносятся напрямую: Pinterest Conversions API через server-side GTM показывает паттерн, а гайд по кодам ошибок - что делать, когда Pinterest отвечает 400.

Pinterest Conversions API: частые вопросы

Sources