События Snapchat Conversions API: поля, типы и правила хеширования
События Snapchat Conversions API проходят один замок до чтения всего остального: минимум один match-параметр обязан присутствовать, иначе Snap отклоняет запрос. За замком - хорошо документированная карта полей: идентификаторы в user_data, фиксированный enum типов, клик-идентификатор из URL лендинга и поля дедупликации, - всё в справочнике параметров Snap с примерами нормализации.
Набор match keys
| Параметр | Требование | Примечания |
|---|---|---|
em / ph (хешированные email / телефон) | Обязательный набор (любой один) | Нормализация, затем SHA-256 |
| client_ip_address + user_agent | Обязательный набор (пара = один ключ) | IP от устройства, не сервера; оба без хеша; IPv4 и IPv6 |
| madid (мобильный рекламный ID) | Обязательный набор (app-рекламодатели) | Нормализуется в lowercase; не хешируется |
| external_id | Хеширование рекомендовано | ID программ лояльности, first-party куки |
| sc_click_id | Рекомендован | Значение из параметра &ScCid= URL лендинга, без хеша |
| sc_cookie1 | Настоятельно рекомендован | Значение first-party куки _scid из Pixel SDK |
Справочник Snap документирует пайплайн нормализации по каждому полю с примерами: email в lowercase с тримом, телефон только из цифр с кодом страны, имена lowercase без пунктуации - затем SHA-256 как 64-символьная lowercase hex строка. Значение, захешированное без нормализации, не даёт ошибку: оно не матчится ни с кем. Кроссплатформенная карта канонизации - в хешировании и нормализации user data для CAPI.
Типы событий и custom_data
Типы событий - фиксированный enum: purchase, start_checkout, add_cart, sign_up, subscribe, page_view, search и документированный набор, плюс CUSTOM_EVENT_1-CUSTOM_EVENT_5 для всего вне него. Объект custom_data несёт коммерческие поля: content_category, content_ids, content_name, content_type и contents для item-level отчётности, питающей и Dynamic Ads. Параметр event_tag добавляет свободную метку для кастомных наборов событий.
Часы и ключ дедупа
Snap принимает epoch в секундах или миллисекундах, приветствуя миллисекунды, с таймстампами событий до 37 дней назад - самое терпимое окно среди крупных платформ. Дедупликация едет на client_dedup_id, идентичном на пикселе, App Ads Kit и API и действующем 48 часов от первого появления; transaction_id закрывает идентичность заказа. Шаблон пейлоада, покрывающий эти поля целиком, - ровно то, что для Pinterest набросано в полном руководстве, а для Snap проходит настройка Snapchat Conversions API - включая то, как клик-ID доезжает до sc_click_id из трекерной воронки.
Frequently asked questions
Sources
Sources
- Ручное тестирование и валидация: Pixel Activator отправляет бесплатные тестовые события, пока вы настраиваете параметры.
- Автоматическая доставка: Most маршрутизирует конверсии из трекера или CRM непрерывно, с дедупликацией и ретраями.