УслугиТарифыДокументацияHelpБлогГлоссарийAPI Войти

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

Справочная статья CDP I-LIM.
Версия: v2Дата: 01.01.2026

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

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

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

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

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

  1. Откройте настройки проекта и найдите блок установки пикселя.
  2. Скопируйте snippet.
  3. Вставьте его перед закрывающим тегом </head> или в общий layout сайта.
  4. Опубликуйте изменения сайта.
  5. Откройте сайт в браузере и выполните тестовое действие.
<!-- место установки в шаблоне сайта -->
<head>
  ...
  <!-- CDP pixel snippet из интерфейса проекта -->
</head>

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

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

Проверка

  1. Откройте DevTools → Network.
  2. Обновите страницу сайта.
  3. Найдите запрос к CDP/gateway/pixel endpoint.
  4. Проверьте HTTP-статус.
  5. Откройте проект в 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 запросы.

[ТУТ СКРИНШОТ: Network-запрос с route, HTTP-статусом и response body]

Что именно решает эта статья

Эта инструкция помогает выполнить действие в CDP без ошибок. После выполнения шагов пользователь должен понимать, где находится нужный экран, какую кнопку нажать, какие поля заполнить и по какому признаку проверить, что действие завершилось успешно.

[ТУТ ИЗОБРАЖЕНИЕ ПОКАЗЫВАЮЩЕЕ нужную страницу CDP с выделенной кнопкой действия, обязательными полями и итоговым статусом, при этом стрелками или рамками выделены главный раздел меню и основная кнопка действия]

Пошаговый сценарий

  1. Откройте проект. Перейдите в рабочий проект CDP, потому что большинство действий привязаны к projectUuid и правам пользователя.
  2. Найдите нужный раздел. Откройте пункт меню, который относится к теме статьи: Help.
  3. Проверьте обязательные поля. Не запускайте действие, пока не заполнены поля, без которых система не сможет сохранить настройку или выполнить проверку.
  4. Запустите действие. Нажмите основную кнопку создания, запуска, проверки или сохранения. Если кнопка неактивна, вернитесь к обязательным полям и правам доступа.
  5. Проверьте результат. Убедитесь, что появилась карточка, строка в таблице, статус успешного выполнения или понятное сообщение об ошибке.

[ТУТ ИЗОБРАЖЕНИЕ ПОКАЗЫВАЮЩЕЕ модальное окно или форма из этой статьи, заполненные примерными корректными данными; обязательные поля отмечены рамками]

Как читать результат

Смотрите не только на общий статус. В CDP важны детали: дата запуска, пользователь, проект, статус обработки, текст ошибки, связанные сущности и действия, которые можно выполнить дальше. Если результат связан с лимитами тарифа, проверяйте страницу лимитов и сообщение 402. Если результат связан с внешним сервисом, проверяйте подключение, ключи и журнал выполнения.

  • Успешный статус означает, что CDP приняла действие и сохранила результат.
  • Предупреждение означает, что действие выполнено, но есть риск неполного результата или неправильной настройки.
  • Ошибка требует исправления входных данных, прав доступа, лимита тарифа или внешнего подключения.

[ТУТ ИЗОБРАЖЕНИЕ ПОКАЗЫВАЮЩЕЕ готовый результат после выполнения действия: таблица, карточка или отчёт со статусом, датой, кнопкой открытия деталей и блоком ошибок]

Частые ошибки

  • Действие запускают не в том проекте, поэтому данные не появляются там, где их ожидают.
  • Пользователь не имеет нужной роли или доступа к проекту.
  • Не заполнено обязательное поле, но пользователь пытается сохранить форму.
  • Ожидается мгновенный результат там, где проверка или сбор данных выполняется асинхронно.
  • Ошибка 402 воспринимается как техническая поломка, хотя чаще всего это лимит тарифа или неподключённая возможность.

Контрольный список перед обращением в поддержку

  1. Сделайте скрин страницы с ошибкой и открытыми деталями.
  2. Скопируйте точный текст ошибки и время возникновения.
  3. Укажите projectUuid, если он отображается в адресе страницы.
  4. Проверьте, повторяется ли проблема после обновления страницы.
  5. Если проблема связана с файлом, отчётом или логами, скачайте файл результата и приложите его к задаче.