События CAPI
Это руководство объясняет, как настроить события Conversions API, которые AdTarget отправляет в Meta, когда пользователи вступают в ваш Telegram-канал.
Когда отправляются события CAPI?
AdTarget отправляет событие CAPI в Meta только для атрибутированных вступлений — то есть вступлений, где AdTarget может сопоставить вступление в Telegram с конкретным кликом по рекламе на вашей посадочной странице. Для этого необходимо наличие invite_link в webhook Telegram.
События CAPI отправляются, когда пользователь переходит по вашей отслеживаемой инвайт-ссылке и Telegram сообщает об этом в webhook (надёжно для закрытых каналов).
События CAPI НЕ отправляются для органических вступлений — пользователей, которые нашли ваш канал через поиск, прямые ссылки или пересланные сообщения. Эти вступления всё равно отображаются в панели управления AdTarget, но помечаются как “organic”.
Ограничение открытых каналов: Из-за ограничения Telegram API даже пользователи, которые нажали на вашу отслеживаемую ссылку, могут быть засчитаны как органические вступления в открытых каналах. Приложение Telegram (особенно на Android) часто преобразует вступления по инвайт-ссылке в “прямые вступления” для открытых каналов, удаляя данные атрибуции. Подробнее ->
Доступные типы событий
AdTarget может отправлять следующие стандартные события Meta:
| Событие | Для чего подходит | Оптимизация Meta |
|---|---|---|
| Lead | Кампании по генерации лидов | Оптимизация по намерению стать лидом |
| Purchase | Кампании с фокусом на покупки | Оптимизация по действиям покупки |
| CompleteRegistration | Кампании на регистрацию | Оптимизация по действиям регистрации |
| Subscribe | Кампании на подписки | Оптимизация по намерению подписки |
| Custom | Пользовательское название события | Для специализированных задач отслеживания |
Выбор правильного события
Запускаете лидогенерацию? Используйте Lead — Это сообщает Meta “этот человек стал лидом.”
Продаёте продукт или услугу? Используйте Purchase — Лучший выбор, когда вы хотите, чтобы Meta оптимизировалась под покупателей. Добавьте value и currency в конфигурации конверсий канала для оптимизации на основе ценности.
Запускаете кампанию на регистрацию? Используйте CompleteRegistration — Сигнализирует о завершённом действии регистрации.
Продвигаете подписку на канал? Используйте Subscribe — Соответствует действию пользователя (вступление = подписка).
Нужно нестандартное событие? Используйте Custom — Позволяет задать собственное customEventName для специализированных сценариев отслеживания, которые не подходят под стандартные типы.
Совет: Сопоставляйте тип события с целью кампании в Ads Manager для лучших результатов.
Настройка событий
Типы событий настраиваются для каждого канала. По умолчанию каждый канал использует Lead при первом обнаружении.
Чтобы изменить тип события канала:
- Перейдите в Settings вашего сайта -> вкладка Channels
- Нажмите Setup (или Edit) в строке канала
- Выберите тип события в диалоге
- Нажмите Save
Параметры события
Каждое событие, которое AdTarget отправляет, включает следующие параметры:
Обязательные параметры
| Параметр | Описание |
|---|---|
event_name | Тип события (Lead и т.д.) |
event_time | Unix-временная метка вступления |
action_source | Всегда “website” |
Параметры атрибуции
| Параметр | Описание |
|---|---|
fbc | Cookie отслеживания кликов (содержит fbclid из клика по рекламе, форматируется как fb.1.{timestamp}.{fbclid}) |
fbp | Значение cookie отслеживания браузера (Meta browser ID) |
Данные пользователя
Если доступны, AdTarget отправляет данные пользователя для сопоставления:
| Параметр | Источник | Хешируется? |
|---|---|---|
external_id | Идентификатор пользователя Telegram | Да (SHA-256) |
client_ip_address | IP с посещения посадочной страницы | Нет (отправляется как есть) |
client_user_agent | Браузер с посещения посадочной страницы | Нет (отправляется как есть) |
external_id (идентификатор пользователя Telegram) хешируется SHA-256 перед отправкой, как рекомендует Meta. Остальные параметры, такие как IP-адрес и user agent, отправляются как есть, что соответствует спецификациям Meta CAPI для этих полей.
Пользовательские данные
AdTarget также отправляет следующие поля внутри объекта custom_data каждого события CAPI:
| Параметр | Описание |
|---|---|
event_source_url | URL посадочной страницы (формируется из домена сайта + пути посещения) |
value | Ценность события (если настроена для канала) |
currency | Код валюты (по умолчанию "USD") |
content_name | Название канала или пользовательское название из конфигурации канала |
Дедупликация событий
AdTarget включает уникальный event_id в каждое событие для предотвращения дублирования:
event_id: "adtarget_{conversion_id}"Это гарантирует, что одна и та же конверсия не будет засчитана дважды, даже при повторной отправке.
Тестирование событий
Тестовое событие валидации
При сохранении пикселя во время настройки AdTarget автоматически отправляет тестовое событие PageView с кодом ADTARGET_TEST. Вы можете увидеть его в Meta Events Manager во вкладке Test Events — это подтверждает, что ваш Pixel ID и токен доступа работают.
Тестирование в продакшене
Самый надёжный способ сквозного тестирования:
- Нажмите на свою рекламу (или используйте тестовую рекламу)
- Посетите вашу посадочную страницу
- Вступите в Telegram-канал по отслеживаемой инвайт-ссылке
- Проверьте Events Manager в течение 5 минут
Сопоставление событий
Meta сопоставляет ваши события с пользователями для атрибуции. Более высокое качество сопоставления = лучшая оптимизация.
Факторы качества сопоставления
| Фактор | Влияние |
|---|---|
| fbc присутствует (содержит fbclid) | Высокое — Прямая атрибуция по клику |
| User agent + IP | Среднее — Вероятностное сопоставление |
| External ID | Среднее — Кросс-устройственное сопоставление |
Улучшение качества сопоставления
- Фиксируйте fbclid: Убедитесь, что URL вашей посадочной страницы сохраняет параметр fbclid
- Отправляйте события быстро: Меньшее время между кликом и конверсией улучшает сопоставление
- Единый путь пользователя: Удерживайте пользователей на вашем домене перед перенаправлением в Telegram
Типичные конфигурации событий
Генерация лидов
Event Type: Lead
When: User joins channel
Use Case: "Get subscribers" campaignsОтслеживание покупок
Event Type: Purchase
When: User joins channel
Use Case: "Buy now" campaigns with value-based optimizationПодписка на контент
Event Type: Subscribe
When: User joins channel
Use Case: "Subscribe to channel" campaignsНастройка нескольких каналов
Channel A (free content): Lead
Channel B (premium): Purchase
Channel C (subscription): SubscribeУстранение неполадок
События не сопоставляются?
- Проверьте наличие fbclid в URL посадочной страницы
- Убедитесь, что Meta Pixel также установлен на посадочной странице
- Проверьте, что cookies не заблокированы
Оценка качества событий низкая?
- Увеличьте объём отправляемых данных (IP, user agent)
- Сократите время между кликом и конверсией
- Проверьте, что fbclid фиксируется
Дублирующиеся события?
- AdTarget автоматически обрабатывает дедупликацию
- Если видите дубликаты, обратитесь в поддержку
Лучшие практики
- Сопоставляйте тип события с целью кампании для лучшей оптимизации
- Используйте один и тот же тип события последовательно в рамках кампании
- Следите за качеством событий в Events Manager еженедельно
- Тестируйте перед масштабированием рекламных расходов
Следующие шаги
Интеграция с Meta завершена! Запускайте рекламу и наблюдайте, как конверсии поступают в Meta.
Нужна помощь с оптимизацией? Свяжитесь с нашей поддержкой.