Как создать проект

Когда создавать новый проект

Создавайте отдельный проект для каждого сайта, бренда, клиента или независимого направления аналитики. Не объединяйте разные сайты в один проект ради экономии: позже будет сложно разделить события, ссылки, SEO-карту и отчёты.

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

Порядок действий

1. Откройте раздел Проекты.
2. Нажмите кнопку создания проекта.
3. Введите понятное название: например, название сайта или клиента.
4. Укажите основной домен без лишних путей и query-параметров.
5. Добавьте описание, чтобы другие пользователи понимали назначение проекта.
6. Сохраните проект и откройте его карточку.

Что проверить после создания

• проект отображается в списке;
• страница проекта открывается без редиректа на login;
• в боковом меню видны доступные разделы;
• если используется тарифная модель, лимиты проекта доступны в профиле или настройках;
• администратор может открыть настройки проекта.

Типовые ошибки

• Домен указан вместе с путём: используйте example.com, а не https://example.com/catalog.
• Проект создан под неправильным пользователем: проверьте аккаунт и роль.
• После Ctrl+F5 выбрасывает на login: проверьте запрос /v1/auth/me и доступность gateway.

Хорошее название проекта:
  example.com — основной сайт
  ClientName — интернет-магазин

Плохое название:
  test
  site
  Новый проект 1

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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