Snapchat Conversions API GTM: серверная доставка через sGTM
Snapchat Conversions API GTM - работа для кастомного серверного шаблона: sGTM не поставляет нативной Snap-интеграции, а API шаблонов даёт sendHttpRequest - документированный способ POST-ить Snap-payload из своего контейнера. Snap добавляет два требования, формирующих дизайн шаблона до всякого маппинга, - замок match key и кросс-канальная дедупликация.
Сначала пройдите замок match key
Snap отклоняет события без хотя бы одного match-параметра сразу, поэтому первая ответственность шаблона - собрать user_data: хешированный email или телефон, пойманные на клиенте, IP-адрес устройства с user agent, если контейнер их сохраняет. Нормализация перед хешированием - по примерам Snap для каждого поля. Только после гарантии match key имеет значение остальной payload - и Snap рекомендует передавать все доступные параметры, а не один.
Маппинг событийной модели в Snap-пейлоад
| Поле Snap | Источник в событийной модели sGTM |
|---|---|
| тип события | Маппится из входящего события в документированный enum или CUSTOM_EVENT_1-5 |
| хешированные идентификаторы | Поля user_data, SHA-256 после нормализации |
sc_click_id | Извлекается из параметра &ScCid= URL лендинга, пойманного в момент клика |
client_dedup_id | Значение, идентичное на пикселе, SDK и API для одного события |
transaction_id | Идентификатор заказа для purchase-событий |
page_url | Полный URL лендинга, рекомендован рядом с клик-ID |
Два идентификатора решают судьбу настройки. sc_click_id приезжает, только если клиент поймал параметр &ScCid= - та же дисциплина ловли на лендинге, что у клик-ID каждой сети. client_dedup_id обязан совпадать с тем, что выдал Snap-пиксел для того же события; шаблон, придумывающий свежие значения на каждую отправку, превращает избыточную связку пиксел-плюс-API в двойной счёт. Таксономия идентификаторов - в match keys и матрице параметров.
Окно 37 дней меняет дисциплину очередей
Щедрое окно таймстампов делает sGTM-очереди менее хрупкими, чем на семидневных часах Meta: контейнер, пролежавший в дауне неделю, всё ещё легитимно выгружается. Дедупликация, однако, остаётся в 48-часовом скоупе client_dedup_id, поэтому отложенные отправки сохраняют исходные дедуп-значения. Поведение ошибок - прежде всего замок match key - разобрано в ошибках Snapchat Conversions API; карта кластера - в полном руководстве, а команды, желающие оставить себе только постбек, отдают пейлоад MOST, с Pixel Activator для одиночных ручных тестов.
Frequently asked questions
Sources
Sources
- Ручное тестирование и валидация: Pixel Activator отправляет бесплатные тестовые события, пока вы настраиваете параметры.
- Автоматическая доставка: Most маршрутизирует конверсии из трекера или CRM непрерывно, с дедупликацией и ретраями.