Snapchat Conversions API: полное руководство
Snapchat Conversions API - серверный канал Snap для данных о конверсиях: ваш сервер, трекер или CRM отправляет события напрямую в Snap, не полагаясь на браузерный пиксел или app SDK. Эта страница - парадная дверь нашего кластера Snapchat CAPI: что покрывает API, обязательный match key, как сходятся дедупликация и валидация, и где у каждой конкретной проблемы свой глубокий гайд.
CAPIЧто покрывает API - и одно жёсткое требование
Snap ставит Conversions API в один ряд со Snap pixel и App Ads Kit SDK как равноправные способы питания измерения; доставленные события открывают post-view и post-swipe отчётность, кастомные аудитории, оптимизацию и Dynamic Ads. Жёсткий замок сидит в payload: каждое событие требует минимум один match-параметр - хешированный email, хешированный телефон, IP-адрес устройства с user agent или мобильный рекламный ID, - и запрос без них завершается ошибкой. Это единственное требование отделяет рабочие интеграции от молча сломанных.
Путь настройки - генерация токена в Business Manager, первое событие, ошибки с креденшелами - в настройке Snapchat Conversions API, а правила скоупа токена - в гайде по токену.
Пейлоад: поля, хеширование, типы событий
Справочник параметров Snap явен в порядке операций: сначала нормализация, потом хеширование. Email приводится к lowercase и тримится, телефон теряет все нецифровые символы, сохраняя код страны, имена и города - lowercase без пунктуации, - и каждый хеш становится 64-символьным lowercase hex дайджестом SHA-256. Поля, которые хешировать нельзя (client_ip_address, client_user_agent, клик- и куки-идентификаторы), документированы так же явно, как обязательные. Клик-идентификатор едет в sc_click_id, берущий значение из параметра &ScCid= URL лендинга, рядом с полным URL в page_url. Типы событий - фиксированный enum: purchase, start_checkout, add_cart, sign_up, subscribe, page_view, search и остальные, плюс пять слотов CUSTOM_EVENT_1-CUSTOM_EVENT_5. Карта полей - в событиях Snapchat, а проводка со стороны трекера - в интеграции Keitaro и Snapchat.
Дедупликация: client_dedup_id и часы
Snap ожидает несколько интеграций одновременно, и дедупликация координируется client_dedup_id: идентичным на пикселе, App Ads Kit и API для одного события, действующим в 48-часовом окне от первого появления. Для покупок transaction_id несёт идентичность уровня заказа. Часы доставки щедрые по меркам платформ - таймстампы событий могут быть до 37 дней назад, - что делает Snap самой терпимой сетью для бэклога трекера, хотя требование match key остаётся жёстче. Механика - в дедупликации по event ID и матрице параметров.
Для разовой ручной проверки бесплатный Pixel Activator отправляет валидные тестовые события в Snap без серверной настройки. Для регулярной доставки из трекера или CRM с дедупликацией подключайте Most.
Валидация, app-события и атрибуция
Механизм Test Event в Snap зеркалит payload точно - тест, упавший бы в продакшене, падает в тесте, валидные поля молчат, а не-фатальные предупреждения всплывают по качеству данных. App-конверсии приезжают через мобильных измерительных партнёров с app-идентификаторами, которые документирует пейлоад (madid, idfv, anon_id); MMP-путь - в app-конверсиях Snapchat через MMP. Атрибуция по умолчанию - 28 дней клик и 1 день просмотр, комбинация, которую рекомендует Snap, - а чеклист сверки с трекером в окне атрибуции и расхождениях Snapchat. Ошибки с фиксами - в ошибках Snapchat Conversions API, паттерн доставки через sGTM - в Snapchat Conversions API через server-side GTM.
Snapchat Conversions API: частые вопросы
Frequently asked questions
Sources
Sources
- Ручное тестирование и валидация: Pixel Activator отправляет бесплатные тестовые события, пока вы настраиваете параметры.
- Автоматическая доставка: Most маршрутизирует конверсии из трекера или CRM непрерывно, с дедупликацией и ретраями.