Keitaro Pinterest: постбеки трекера в Conversions API
Обвязка Keitaro и Pinterest - мост, превращающий постбеки трекера в события Pinterest Conversions API: Keitaro фиксирует конверсию и хранит идентичность клика, а слой доставки собирает принимаемый Pinterest пейлоад v5 - CAPI. Дедупликация и оценка качества Pinterest делают дисциплину идентичности всей игрой - событие без стабильного event_id или пригодного user_data деградирует молча.
Зарегистрируйте Pinterest как траффик-сорс
Механизм траффик-сорсов Keitaro парсит объявленные URL-параметры из URL лендинга и привязывает их к клику. Pinterest, в отличие от платформ с собственными клик-идентификаторами, не дописывает специализированный клик-ID параметр, поэтому идентичность, важная для Pinterest, - та, что контролирует ваша воронка: сабы и транзакционные идентификаторы, назначаемые Keitaro, плюс лендинг-параметры, которые используют ваши воронки. Объявив их в кастомном источнике Pinterest, вы делаете сохранённую запись клика полной - флоу регистрации источника задокументирован в гайде Keitaro по добавлению траффик-сорса.
S2S постбек: идентичность из трекера
Конверсии покидают Keitaro через механизм S2S постбека: URL-шаблон, стреляющий по каждой конверсии, с подстановкой макросов в момент отправки - sub_id, ID транзакции, payout, статус. Для Pinterest-пайплайна работа постбека - передать слою доставки стабильную идентичность конверсии: транзакционный идентификатор трекера становится event_id, по которому Pinterest дедуплицирует, а payout маппится в value-поля события. Оба значения обязаны совпадать с тем, что посчитал Pinterest-тег на браузерной стороне, - эта симметрия и есть весь механизм дедупликации.
Доставка пейлоада v5
| Поле Pinterest v5 | Источник из пайплайна Keitaro |
|---|---|
event_name | Маппится из статуса постбека: sale в checkout, lead в lead |
event_id | Транзакционный идентификатор трекера - стабилен на конверсию |
user_data.em | Хешированный email, если воронка его поймала, SHA-256 после нормализации |
event_time | Время отправки, в пределах цели Pinterest «менее часа» |
| Авторизация эндпоинта | ID рекламного аккаунта в пути, токен из Ads Manager в заголовке |
Эндпоинт - POST /v5/ad_accounts/{ad_account_id}/events; правила пейлоада и ответы задокументированы в событиях Pinterest и кодах ошибок Pinterest Conversions API. То же разделение труда для стороны Meta разобрано в интеграции Keitaro и Facebook CAPI; передать пейлоад по всем сетям автоматике - это то, что делает MOST, а одиночные ручные тесты идут через Pixel Activator. Обзор кластера - полное руководство.
Frequently asked questions
Sources
Sources
- Ручное тестирование и валидация: Pixel Activator отправляет бесплатные тестовые события, пока вы настраиваете параметры.
- Автоматическая доставка: Most маршрутизирует конверсии из трекера или CRM непрерывно, с дедупликацией и ретраями.