Pinterest Conversions API GTM: серверная доставка через sGTM
Pinterest Conversions API GTM работает через кастомный серверный шаблон: в server-side Google Tag Manager нет нативной Pinterest-интеграции, а кастомный API шаблонов даёт sendHttpRequest - документированный способ исходящего POST из серверного контейнера. Сторона Pinterest - простой JSON-эндпоинт, POST /v5/ad_accounts/{ad_account_id}/events, с авторизацией токеном Conversions API. Работа - маппинг.
Маппинг событийной модели sGTM в пейлоад Pinterest
| Поле Pinterest v5 | Источник в событийной модели sGTM |
|---|---|
event_name | Маппится из входящего события (purchase в checkout, generate_lead в lead и так далее) |
action_source | Фиксированный web для событий браузерного происхождения |
event_time | Исходный таймстамп конверсии, а не момент отправки |
event_id | Значение, которое умеют посчитать и тег, и шаблон для одной конверсии |
user_data.em | Хешированный email, пойманный в клике или форме, SHA-256 после нормализации |
event_source_url | URL страницы, переданный клиентом |
Два поля решают, переживёт ли настройку реальный трафик. event_id - ключ дедупликации Pinterest: в рекомендованной двойной доставке тег и API передают одну конверсию, и только идентичный event_id с обеих сторон сворачивает копии. Хешированный email в user_data - то, что потребляет матчинг Pinterest; те же идентификаторы, что отправляет браузерная фича Enhanced Match, применённые серверно.
Окна доставки и дисциплина очередей
Pinterest заявляет: доставка должна быть как можно ближе к real-time - менее одного часа, - чтобы оптимизация, атрибуция и биддинг реагировали на текущие данные. Серверный контейнер, копящий события во время простоя, выгружается внутри этого окна, а не после: кампании, оптимизирующиеся на вчерашних конверсиях, - видимый симптом батчевого шаблона. Ответы с фиксами - в кодах ошибок Pinterest Conversions API.
Живой sGTM-деплой - настоящая эксплуатационная работа: версионирование шаблонов, гигиена токенов, мониторинг возраста очереди. Команды, желающие оставить себе только постбек, отдают маппинг автоматике: MOST применяет эти правила пейлоада по каждой сети, а Pixel Activator отправляет одиночные тестовые события без настройки. Карта кластера - в полном руководстве.
Frequently asked questions
Sources
Sources
- Ручное тестирование и валидация: Pixel Activator отправляет бесплатные тестовые события, пока вы настраиваете параметры.
- Автоматическая доставка: Most маршрутизирует конверсии из трекера или CRM непрерывно, с дедупликацией и ретраями.