Глава 8: Конверсии и атрибуция¶
Аудитория: медиабайеры, менеджеры рекламных кампаний
Отслеживание конверсий позволяет Cat-Scan измерять, что происходит после показа: совершил ли пользователь целевое действие? Эти данные поступают в скоринговую модель оптимизатора и помогают оценить реальную эффективность кампании.
Источники конверсий¶
Cat-Scan поддерживает два метода интеграции:
Пиксель¶
Отслеживающий пиксель срабатывает на вашей странице конверсии (например, подтверждение заказа).
- Эндпоинт:
/api/conversions/pixel - Параметры:
buyer_id,source_type=pixel,event_name,event_value,currency,event_ts - Не требует серверной настройки — достаточно разместить пиксель на странице.
Вебхук¶
Ваш сервер отправляет события конверсий на вебхук-эндпоинт Cat-Scan.
- Надёжнее пикселей (нет блокировщиков рекламы, нет зависимости от клиентской стороны).
- Требует серверной интеграции.
- Поддерживает проверку HMAC-подписи для обеспечения безопасности.
Безопасность вебхуков¶
Cat-Scan обеспечивает многоуровневую защиту вебхуков:
| Функция | Назначение |
|---|---|
| Проверка HMAC | Каждый запрос вебхука подписывается общим секретом. Cat-Scan отклоняет неподписанные или некорректно подписанные запросы. |
| Ограничение частоты | Предотвращает злоупотребления, ограничивая количество запросов за временное окно. |
| Мониторинг свежести | Оповещает, если события вебхука перестают поступать (обнаружение устаревания). |
Настройте безопасность вебхуков в /settings/system > Conversion Health.
Проверка готовности¶
Прежде чем полагаться на данные о конверсиях, убедитесь в готовности:
- Перейдите в
/settings/systemили к контрольному списку настройки. - Проверьте Conversion Readiness: показывает, подключён ли источник и доставляет ли события в пределах ожидаемого окна свежести.
- Проверьте Ingestion Stats: количество событий по типу источника и временному периоду.
Состояние конверсий¶
Панель Conversion Health отображает:
- Статус приёма данных (поступают события или нет)
- Статус агрегации (обрабатываются ли события в метрики)
- Метку времени последнего события
- Количество ошибок, если таковые имеются
Связанные разделы¶
- Оптимизатор: данные о конверсиях повышают точность скоринга
- Импорт данных: ещё один способ ввода данных
- Для DevOps: настройка и диагностика вебхук-эндпоинтов — см. Интеграции.