События Pinterest Conversions API отправляются POST-запросом на один эндпоинт: POST /v5/ad_accounts/{ad_account_id}/events. Каждое событие - компактный объект с именем, action source, временной меткой, идентификатором и обязательным объектом user_data: укажите в нём em, hashed_maids либо пару client_ip_address и client_user_agent для сопоставления пользователя. Официальная документация 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) в виде массива. Перед SHA-256-хешированием email приводят к нижнему регистру и удаляют пробелы по краям. Неверно нормализованное значение не вызывает ошибку: его просто не удаётся сопоставить. Правила для разных платформ собраны в материале о хешировании и нормализации user data для CAPI, а браузерный вариант описан в статье об Enhanced Match: тег отправляет хешированный email, если cookie Pinterest отсутствует. Чтобы вручную отправить одно событие, пока вы настраиваете основной процесс, бесплатный Pixel Activator соберёт этот payload без кода.
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. Обзор кластера - полное руководство.