Как установить пиксель CDP на сайт

Версия: v2Дата: 01.01.2026

Пиксель передаёт действия посетителей сайта в CDP. После установки нужно обязательно проверить сетевой запрос и появление события в проекте.

Перед началом

Убедитесь, что проект уже создан и у вас есть доступ к его настройкам. Устанавливайте только snippet из интерфейса CDP: в нём должны быть правильные projectUuid, host и параметры окружения.

[ТУТ СКРИНШОТ: раздел проекта с кодом пикселя и кнопкой копирования]

Установка напрямую в сайт

Откройте настройки проекта и найдите блок установки пикселя.
Скопируйте snippet.
Вставьте его перед закрывающим тегом </head> или в общий layout сайта.
Опубликуйте изменения сайта.
Откройте сайт в браузере и выполните тестовое действие.

<!-- место установки в шаблоне сайта -->
<head>
  ...
  <!-- CDP pixel snippet из интерфейса проекта -->
</head>

Установка через Tag Manager

Создайте новый HTML/script tag.
Вставьте snippet CDP.
Настройте условие показа на всех нужных страницах.
Опубликуйте контейнер.
Проверьте, что tag действительно сработал.

Проверка

Откройте DevTools → Network.
Обновите страницу сайта.
Найдите запрос к CDP/gateway/pixel endpoint.
Проверьте HTTP-статус.
Откройте проект в CDP и убедитесь, что событие появилось.

[ТУТ СКРИНШОТ: DevTools Network с запросом пикселя и HTTP 200/204]

Важно. Если запроса нет вообще, проблема на стороне установки snippet или условий Tag Manager. Если запрос есть, но статус 4xx/5xx — смотрите gateway и параметры проекта.

Контрольный чек-лист

Проверьте, что вы находитесь в правильном проекте, а не в соседнем тестовом проекте.
Проверьте роль пользователя: часть кнопок видна только администратору.
Откройте DevTools → Network и найдите запрос к /v1/....
Скопируйте точный текст ошибки, HTTP-статус и время возникновения.
Если операция связана с лимитом, откройте страницу лимитов до повторного запуска.

Что приложить к задаче разработчику

Чтобы проблему можно было быстро воспроизвести, приложите URL страницы, projectUuid, время ошибки, скриншот интерфейса, скриншот Network-запроса и архив логов. Для ошибок bootstrap отдельно проверьте, были ли в gateway.log не только GET, но и POST/PUT запросы.