События Pinterest Conversions API: пейлоад v5 по полям
События Pinterest Conversions API уходят POST-запросом на один эндпоинт - POST /v5/ad_accounts/{ad_account_id}/events - и каждое событие это компактный объект: имя, action source, таймстамп, идентификатор и объект user_data, делающий матчинг возможным. Официальный референс v5 показывает точную форму, и поля, выглядящие опциональными, значат больше, чем кажется: event_id несёт дедупликацию, user_data несёт матчинг, а privacy-флаги решают, может ли Pinterest использовать событие вообще.
Основные поля
| Поле | Что несёт | Примечания референса v5 |
|---|---|---|
event_name | Тип конверсии: checkout, add_to_cart, page_visit, signup и документированный набор | Кастомные события едут через тот же эндпоинт |
action_source | Где случилось событие: web, app_ios, app_android, offline | Определяет отчётность на уровне источников |
event_time | Unix-таймстамп конверсии | Доставка как можно ближе к real-time - Pinterest называет менее часа |
event_id | Уникальный идентификатор события | Ключ дедупликации для рекомендованной двойной доставки - см. дедупликацию по event ID |
event_source_url | URL страницы для web-событий | Контекст отчётности |
Референс показывает комбинацию в одном объекте: event_name checkout, action_source app_ios, Unix event_time и event_id eventId0001 - минимальная идентичность одной конверсии.
user_data: материал для матчинга
Объект user_data несёт идентификаторы, которые Pinterest матчит с реальными аккаунтами; первым референс показывает хешированный email (em) в виде массива. Хеширование следует дисциплине канонизации - lowercase, удаление пробелов, SHA-256, - и неверно нормализованное значение не вызывает ошибку: оно просто не матчится ни с кем. Как правила различаются по платформам, собрано в хешировании и нормализации user data для CAPI, а браузерное дополнение - Enhanced Match, отправляющий хешированные email из тега, когда куки Pinterest нет. Чтобы отправить одно событие руками, пока пайплайн строится, бесплатный Pixel Activator собирает этот пейлоад без кода.
Privacy-переключатели и идентификация партнёра
Пейлоад v5 включает opt_out и advertiser_tracking_enabled - переключатели, сообщающие Pinterest, может ли событие использоваться для данного пользователя, - и Conversions API Pinterest дополнительно документирует Limited Data Processing flag для privacy-законов штатов. partner_name подписывает отправляющую интеграцию (референс показывает S2S-строку партнёра) - так Pinterest отличает трафик тега от серверного в отчётах. Для трекерного пайплайна эти поля - статическая конфигурация: слой доставки выставляет их один раз под consent-позицию кампании.
Ответы: что отвечает Pinterest
Референс v5 документирует ответы чисто: 200 - «The request has succeeded»; 400 - «The request could not be understood by the server due to unexpected data» - проблема payload (битые поля, неверные типы); 401 - проблема аутентификации токена. Полная таблица кодов с фиксами - в кодах ошибок Pinterest Conversions API, креденшелы за 401 - в настройке Pinterest Conversions API. Обзор кластера - полное руководство.