Настройка Pinterest Conversions API - токен, дедупликация и качество событий
Что покрывает Conversions API Pinterest
Pinterest Conversions API - серверный приёмник платформы: конверсии отправляются с вашего сервера напрямую в Pinterest, и Pinterest заявляет, что такие серверные события ведут себя как события от Pinterest Tag или мобильного MMP. Для арбитражных воронок это важно конкретно: конверсия обычно случается на оффер-странице, которую вы не контролируете, и серверное событие - единственная её копия, которую Pinterest видит. Поддержаны все три типа конверсий: web, in-app и in-store/offline - API закрывает смешанные воронки одним каналом. Общая механика таких каналов - в conversions API.
Входные требования Pinterest держит лёгкими. Conversions API доступен любому бизнес-аккаунту Pinterest, и - в отличие от остальных продуктов Pinterest API - не требует создания приложения или валидного app ID. Нужны бизнес-аккаунт и токен, сгенерированный через Conversions-страницу в Ads Manager, - и POST-эндпоинт отправки конверсий доступен.
Сгенерируйте access token в Ads Manager
Getting-started Pinterest даёт точный путь: залогиньтесь в бизнес-аккаунт, откройте меню-гамбургер слева сверху, выберите Conversions в колонке Manage business, затем страницу Set Up API в левой навигации и нажмите Generate new token. Скопируйте новый access token вместе с account ID - оба значения едут в конфигурацию доставки: токен для аутентификации, account ID для адресации нужного рекламного аккаунта.
Две операционные заметки из того же гайда. Если нужен доступ к чужому аккаунту, сначала настраивается Business Access, либо владелец генерирует и передаёт токен - и Pinterest прямо не рекомендует передавать токены без защищённого канала. Конверсионный токен, вставленный в общий чат, - это утечка доступа к вашему рекламному бюджету; храните его на сервере так же, как access token любого другого CAPI.
Выберите путь интеграции: direct или partner
Прямая интеграция - рекомендованный Pinterest путь для максимального контроля, и Pinterest прямо говорит, что она требует разработчика: форматирование payload, полнота параметров и обработка ошибок - ваша зона. Полный список обязательных и рекомендуемых параметров на событие лежит в developer-документации Pinterest, там же - технические детали протокола.
Партнёрский путь делегирует эту работу сторонней платформе. Для воронки с трекером есть третья форма, которая не то и не другое: инструмент доставки, принимающий постбек трекера и форматирующий payload платформы за вас - MOST доставляет в Pinterest вместе с Meta, TikTok, Reddit, Snapchat и OpenAI, а бесплатный Pixel Activator закрывает доставку в Pinterest для одного лендинга с ручным потоком. В любом случае чек-лист Pinterest одинаков: корректные параметры, доставка близко к real-time, дедупликация и валидация.
Дедупликация событий тега и API через event_id
Двойная интеграция - собственная рекомендация Pinterest: отправляйте через Conversions API те же события, что уже шлёте через Pinterest Tag или мобильный MMP, потому что связка максимизирует видимость конверсий. Цена работы обоих без подготовки - двойной счёт, и лекарство - параметр event_id: help-центр Pinterest предписывает передавать event_id, дедуплицируя события тега/MMP и API - та же дисциплина общего ключа, что в дедупликации пикселя и CAPI в экосистеме Meta. Механика общего ключа - в event ID deduplication.
В воронке с трекером event_id нуждается в детерминированном источнике: идентификатор транзакции или клика, который обе стороны - браузерная и серверная - могут вычислить для одной конверсии. event_id, который умеет генерировать только одна сторона, молча выключает дедупликацию: обе копии засчитываются, и расхождение позже всплывает как завышенные цифры в Ads Manager.
Для офлайн-конверсий без ресурсов на разработку у Pinterest есть фолбэк, не требующий API вообще: загрузите файл офлайн-конверсий в Ads Manager, и Pinterest атрибутирует эти конверсии кампаниям из файла.
Требования к доставке, приватность и качество событий
Тайминг - заявленное требование, а не пожелание: Pinterest просит доставку событий максимально близко к real-time - менее часа, - чтобы оптимизация, атрибуция и биддинг реагировали на свежие данные. Пайплайн с пакетной отправкой раз в день кормит Pinterest протухшими сигналами, и видимый симптом - кампании, оптимизирующиеся по вчерашним конверсиям.
Для комплаенса у Pinterest есть Limited Data Processing flag под privacy-законы штатов США - тот же класс управления, что консент-параметры в CAPI других сетей, а правила payload за такими флагами следуют кроссплатформенной дисциплине из хэширования user data для CAPI.
Валидация замыкает цикл, и Pinterest называет три чекпоинта в Events Manager. Test events позволяют разработчику видеть коды ответа на каждый запрос по мере срабатывания конверсий. Страница дедупликации на Events Overview показывает пост-дедуплицированные конверсии - место, где подтверждают, что копии тега и API сворачиваются в одну, а не удваиваются. И Event Quality Score оценивает payload: рекомендация Pinterest - передавать данные так, чтобы интеграция выходила на Good EQS, - это платформенная версия match-quality сигналов из оценки event match quality. Привычка валидации та же, что во всех сетях, - тестовые события до масштабирования.