Для Pinterest Conversions API GTM в server-side Google Tag Manager нет нативной интеграции, поэтому Conversions API подключают через кастомный серверный шаблон. API шаблонов sGTM предоставляет 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 непрерывно, с дедупликацией и ретраями.