TopoMetrika · документация SDK

Настройки проекта: домены, подписи и действия

Как указать точные домены, разрешённые подписи и действия, срок хранения и получить готовый код с публичным ID.

Обновлено 25.10.2026

Автонастройка SDK

Создайте проект с названием и доменом и установите короткий код. В настройках нажмите «Начать автонастройку», пройдите сценарии в открывшемся окне продукта и нажмите «Завершить проход». Выберите нужные действия и нажмите «Продолжить: собрать фичи». Объедините шаги одного сценария в группы, дайте фичам понятные названия или выберите существующие карточки. После подтверждения черновики появятся в каталоге сразу: ждать 20 событий и вручную задавать тикеры не нужно. Повторная проверка использует сохранённые связи без дубликатов. Новые предложения изначально не выбраны. Поля для ручного ввода находятся в «Расширенные настройки».

Неподтверждённые тексты остаются в памяти браузера; сервер получает только выбранные строки, у остальных — непрозрачные идентификаторы. Значения полей, query, тела запросов и секреты не отправляются. Во время записи обычная телеметрия счётчика приостановлена. Найденные подписи и маршруты требуют проверки владельцем продукта.

После подтверждения открытое окно продукта получает обновлённые разрешения без ручной перезагрузки; при следующем открытии тот же установленный тег также загрузит актуальные настройки. Обучающий проход не считается использованием фич: счётчики наполняются реальными событиями посетителей. Статистические намерения формируются отдельно по мере накопления достаточно похожих событий. После релиза нажмите «Проверить после релиза» и повторите сценарии. Интерфейс покажет новые и знакомые действия, а также не встреченные в этом проходе. Отсутствие наблюдения не удаляет разрешения.

Один проход: до 128 действий и 15 минут. История: 20 подтверждённых проверок. Для связи окон нужны установленный SDK, разрешение на открытие окна и совместимые CSP/Cross-Origin-Opener-Policy. GPC и DNT продолжают действовать.

Когда это нужно: вы создаёте проект или меняете сайт и действия, с которых собираются наблюдения. Результат: продукт подключён к правильному пространству, а SDK знает, какие данные допустимы.

Четыре понятия без путаницы

Проект: Подключаемый продукт внутри TopoMetrika: его название, домены и разрешённые действия.
Origin: Адрес анализируемого сайта: протокол + домен, при необходимости порт. Например, https://shop.example.ru.
Endpoint: Адрес пространства, куда SDK отправляет наблюдения. Например, https://your-workspace.fichers.ru. Он уже указан в готовом коде.
ID счётчика: Публичный идентификатор проекта в коротком теге. Это не секрет, не токен и не разрешение читать аналитику или входить в пространство.

Кто заполняет настройки

Продакт определяет название, цель и первый сценарий, согласует допустимые подписи и срок хранения. Разработчик подтверждает точные origin и реальные методы/пути действий: эти значения нельзя угадать по тексту кнопки. Администратор сохраняет настройки и выдаёт код установки. Один человек может совмещать эти роли.

Настройки находятся в TopoMetrika → «Настройки». Создание проекта, изменение настроек и получение кода счётчика доступны администраторам пространства и платформы; роль Product Owner позволяет работать с намерениями и фичами, но не настраивать сбор.

Название и разрешённые origin

Дайте проекту понятное имя, например «Магазин · web». В поле origin укажите адреса сайта, на котором будет работать SDK, по одному в строке:

https://shop.example.ru
https://www.shop.example.ru

Нужен точный origin: протокол, домен и при необходимости порт. Путь, завершающий слеш, query, fragment и wildcard не допускаются. www, другой протокол или порт означают другой origin. Для обычного сайта нужен HTTPS; HTTP допускается для localhost, 127.0.0.1 и [::1] при локальной проверке.

Не указывайте адрес пространства вместо адреса продукта. Пространство https://your-workspace.fichers.ru становится endpoint в коде установки; origin https://shop.example.ru разрешает присылать данные из браузера магазина.

Расширенные настройки: статичные подписи

Укажите точные постоянные строки интерфейса, например «Купить» или «Добавить в корзину». Проверяется точное совпадение текста либо aria-label. Не вносите имена, email, номера заказов и строки, в которые подставляются персональные данные.

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

Расширенные настройки: шаблоны действий

Укажите метод заглавными буквами и шаблон пути, по одному в строке:

POST /api/checkout/:id
POST /api/cart/add
NAV /orders/{id}

Поддерживаются GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS и NAV. Для динамического сегмента используйте :id или {id}, а не реальный идентификатор. Полный URL, query, fragment и секреты в шаблоне недопустимы.

Что спросить у разработчика: «Какой запрос или переход реально запускает эта кнопка? Можно ли безопасно описать его постоянным шаблоном без ID, параметров и личных данных?»

Шаблон должен соответствовать действующему поведению продукта, а не названию желаемой бизнес-метрики. Например, если кнопка вызывает другой путь или внешний API, пример POST /api/checkout/:id сам по себе не начнёт собирать её. Особенности same-origin и ручного capture описаны в событиях SDK.

В основной форме достаточно названия и origin. Новый проект использует базовый UI_TRIGGER_ACTION; точные действия добавляются после автонастройки. На уровне API пустые списки возможны у выключенного проекта; включить приём без origin и действия нельзя. UI_TRIGGER_ACTION — отдельный явно разрешаемый запасной сигнал, а не способ получить полноценную кластеризацию неизвестных действий.

Срок хранения и приём событий

Укажите 2–90 дней; форма предлагает 30 дней. Доступная история дополнительно ограничивается условиями пространства. При уменьшении срока сокращается срок жизни уже собранных наблюдений; увеличение не продлевает ранее обещанный срок. Подробности и количественные ограничения — в лимитах.

В новой форме флаг «Принимать новые события» отмечен. Это серверное разрешение на приём: после загрузки готового блока клиент запускается автоматически, если браузер не ограничивает сбор. Правовое основание, уведомление и согласие, когда оно требуется, обеспечивает владелец сайта; при необходимости он откладывает загрузку всего блока. Выключение флага останавливает приём новых событий; сохранённые наблюдения остаются до окончания срока хранения.

Публичный счётчик и изменение политики

В «Установка на сайт» всегда доступен один короткий тег с публичным ID счётчика. Скопировать его повторно можно в любой момент — без одноразового показа и перевыпуска ключа. Адрес пространства и счётчик уже указаны; сохранённые списки установщик получает при загрузке страницы.

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

События принимаются по публичному ID без постоянного браузерного ключа и без пятиминутного токена. Сам публичный ID не даёт читать аналитику, данные пространства или административные API. Применяются проверки точного origin, структуры, допустимых действий, размеров, повторов и лимиты; это не доказательство личности посетителя или подлинности покупки. Серверные секреты не выдаются в коде установки и ответах кабинета. Перейти к установке →