Кастомные события нужны, когда стандартного просмотра страницы недостаточно: форма отправлена, товар добавлен, кнопка нажата, пользователь дошёл до нужного шага.
Когда нужны кастомные события
Кастомное событие используется для действий, которые важны бизнесу: отправка формы, регистрация, заказ, клик по кнопке, открытие виджета, просмотр тарифа или любое другое целевое действие.
Короткий порядок действий
- Убедитесь, что Pixel уже создан и установлен на сайт.
- Определите техническое имя события: например,
lead_form_submitилиtariff_view. - Добавьте вызов события в нужном месте сайта или настройте триггер в Tag Manager.
- Передайте полезные атрибуты: форму, страницу, цену, источник или другой контекст.
- Проверьте событие в Network и в разделе событий проекта.
Endpoint и ссылка на API
Браузерный сбор событий выполняется через публичный endpoint /v1/public/pixels/collect. Описание доступных методов смотрите в разделе API документации проекта или на странице настроек API-ключей проекта.
// Концептуальный пример: точная сигнатура зависит от установленного snippet
window.cdpPixel?.track('lead_form_submit', {
form: 'main_request',
page: location.pathname
})Что проверить
- Событие имеет стабильное имя.
- В атрибутах нет паролей, токенов и лишних персональных данных.
- Событие приходит в правильный проект.
- Повторный клик не создаёт нежелательные дубли, если действие должно быть уникальным.