Snapchat Conversions API

Это руководство объясняет, как настроить события Conversions API, которые AdTarget отправляет в Snapchat, когда пользователи присоединяются к вашему Telegram-каналу.

Когда отправляются события?

AdTarget отправляет событие в Snapchat только для атрибутированных вступлений — то есть вступлений, при которых AdTarget может связать вступление в Telegram с конкретным кликом по рекламе на вашем лендинге. Для этого требуется наличие invite_link в вебхуке Telegram.

События отправляются, когда пользователь нажимает на вашу отслеживаемую ссылку-приглашение и Telegram сообщает об этом в вебхуке (надёжно для приватных каналов).

События НЕ отправляются для органических вступлений — пользователей, которые находят ваш канал через поиск, прямые ссылки или пересланные сообщения. Эти вступления всё равно отображаются в вашем дашборде AdTarget, но помечаются как «органические».

Ограничение публичных каналов: Из-за ограничения API Telegram даже пользователи, которые нажали на вашу отслеживаемую ссылку, могут быть обработаны как органические вступления в публичных каналах. Приложение Telegram (особенно Android) часто преобразует вступления по ссылке-приглашению в «прямые вступления» для публичных каналов, удаляя данные атрибуции. Подробнее →

Доступные типы событий

AdTarget сопоставляет свои типы событий со стандартными событиями Snapchat:

Событие AdTarget	Событие Snapchat	Подходит для	Оптимизация Snapchat
Lead	SIGN_UP	Кампании по генерации лидов	Оптимизирует для регистраций
Purchase	PURCHASE	Кампании на покупки	Оптимизирует для покупок
CompleteRegistration	SIGN_UP	Кампании на регистрацию	Оптимизирует для регистраций
Subscribe	SUBSCRIBE	Кампании на подписку	Оптимизирует для намерения подписки
Custom	CUSTOM_EVENT_1	Специализированное отслеживание	Пользовательская оптимизация

Выбор правильного события

Запускаете рекламу для генерации лидов? Используйте Lead (сопоставляется с SIGN_UP Snapchat) — Это говорит Snapchat: «этот человек зарегистрировался / стал лидом».

Продаёте продукт или услугу? Используйте Purchase (сопоставляется с PURCHASE) — Лучший вариант, когда вы хотите, чтобы Snapchat оптимизировал для покупателей. Сочетайте с value и currency в конфигурации конверсий вашего канала для оптимизации на основе ценности.

Запускаете кампании на регистрацию? Используйте CompleteRegistration (сопоставляется с SIGN_UP) — Сигнализирует о завершённой регистрации.

Продвигаете подписку на канал? Используйте Subscribe (сопоставляется с SUBSCRIBE) — Соответствует действию пользователя (вступление = подписка).

Нужно нестандартное событие? Используйте Custom (сопоставляется с CUSTOM_EVENT_1) — Для специализированных сценариев отслеживания, которые не вписываются в стандартные типы.

Совет: Сопоставляйте тип события с целью вашей кампании в Snapchat Ads Manager для лучших результатов.

Настройка событий

Типы событий настраиваются для каждого канала. Каждый канал по умолчанию использует CompleteRegistration при первом обнаружении.

Чтобы изменить тип события канала:

Перейдите в Settings вашего сайта → вкладка Channels
Нажмите Setup (или Edit) в строке канала
Выберите тип события в диалоге
Нажмите Save

Параметры событий

Каждое событие, которое AdTarget отправляет в Snapchat, включает эти параметры:

Обязательные параметры

Параметр	Описание
`event_type`	Название события Snapchat (SIGN_UP, PURCHASE и т.д.)
`timestamp`	Временная метка ISO 8601 момента вступления (миллисекунды)
`event_tag`	Тег для категоризации событий

Параметры атрибуции

Параметр	Описание
`sc_click_id`	Snapchat Click ID (`ScCid`) от клика по рекламе

Данные пользователя

Параметр	Источник	Хешировано?
`hashed_external_id`	ID пользователя Telegram	Да (SHA-256)
`hashed_ip_address`	IP с посещения лендинга	Нет (отправляется как есть)
`user_agent`	Браузер с посещения лендинга	Нет (отправляется как есть)

external_id (ID пользователя Telegram) хешируется SHA-256 перед отправкой, как требует Snapchat. IP-адрес и user agent отправляются как есть в соответствии со спецификациями Conversions API Snapchat.

Пользовательские поля

Параметр	Описание
`price`	Ценность события (если настроено для канала)
`currency`	Код валюты (по умолчанию `"USD"`)
`description`	Название канала или пользовательское имя из конфигурации канала

Дедупликация событий

AdTarget включает уникальный event_id с каждым событием для предотвращения дублей:


event_id: "adtarget_{conversion_id}"

Это гарантирует, что одна и та же конверсия не будет учтена дважды, даже при повторной отправке.

Тестирование событий

Тест в продакшене

Самый надёжный способ тестирования от начала до конца:

Нажмите на свою рекламу Snapchat (или используйте тестовую рекламу)
Посетите ваш лендинг
Вступите в ваш Telegram-канал по отслеживаемой ссылке-приглашению
Проверьте Snapchat Events Manager в течение 5-10 минут

Проверка в Snapchat Ads Manager

Перейдите в Events Manager
Выберите ваш пиксель
Найдите ваш тип события с недавними временными метками
Убедитесь, что событие показывает статус «Received»

Сопоставление событий

Snapchat сопоставляет ваши события с пользователями для атрибуции. Более высокое качество сопоставления означает лучшую оптимизацию.

Факторы качества сопоставления

Фактор	Влияние
ScCid присутствует	Высокое - Прямая атрибуция по клику
User agent + IP	Среднее - Вероятностное сопоставление
External ID	Среднее - Кросс-девайс сопоставление

Улучшение качества сопоставления

Захватывайте ScCid: Убедитесь, что URL вашего лендинга сохраняет параметр ScCid
Отправляйте события быстро: Меньшее время между кликом и конверсией улучшает сопоставление
Последовательный путь пользователя: Удерживайте пользователей на вашем домене перед перенаправлением в Telegram

Типичные конфигурации событий

Генерация лидов


AdTarget Event: Lead → Snapchat Event: SIGN_UP
When: User joins channel
Use Case: "Get subscribers" campaigns

Отслеживание покупок


AdTarget Event: Purchase → Snapchat Event: PURCHASE
When: User joins channel
Use Case: "Buy now" campaigns with value-based optimization

Подписка на контент


AdTarget Event: Subscribe → Snapchat Event: SUBSCRIBE
When: User joins channel
Use Case: "Subscribe to channel" campaigns

Устранение неполадок

События не сопоставляются?

Проверьте, что ScCid есть в URL лендинга
Убедитесь, что Snapchat Pixel также установлен на лендинге
Убедитесь, что cookies не заблокированы

Низкий показатель сопоставления событий?

Сократите время между кликом и конверсией
Убедитесь, что ScCid захватывается из URL
Убедитесь, что IP и user agent доступны

Дублирующиеся события?

AdTarget обрабатывает дедупликацию автоматически через event_id
Если видите дубли, свяжитесь с поддержкой

Лучшие практики

Сопоставляйте тип события с целью кампании для лучшей оптимизации
Используйте один тип события последовательно в рамках кампании
Мониторьте доставку событий в Snapchat Events Manager регулярно
Тестируйте перед масштабированием рекламного бюджета

Следующие шаги

Ваша интеграция со Snapchat завершена! Начинайте запускать рекламу и наблюдайте, как ваши конверсии поступают в Snapchat.

Нужна помощь с оптимизацией? Свяжитесь с нашей командой поддержки.