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

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

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

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

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

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

SDK — небольшой скрипт, который разработчик один раз добавляет на ваш сайт. Он помогает увидеть, какими действиями пользуются посетители, в каком состоянии находятся поля перед нажатием и куда люди переходят дальше. Результат доступен команде в TopoMetrika, без необходимости читать код или векторы.

Быстрый старт: подготовьте проект в своём пространстве → скопируйте готовый блок в «Установка на сайт» → подключите его на сайте. Адрес пространства и публичный ID счётчика уже заполнены; ключей и токенов в теге нет. Разрешённые данные установщик получает из актуальных настроек проекта автоматически.

Владелец сайта отвечает за правовое основание обработки, уведомление посетителя и согласие, когда оно требуется. TopoMetrika не показывает своё окно согласия и не хранит решение посетителя. После загрузки блока допустимый сбор запускается автоматически, если приём включён и GPC/DNT его не запрещают. Если требуется предварительное согласие, владелец сайта загружает блок только после него через свою панель или менеджер тегов и останавливает клиент при отзыве.

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

Создание проекта и установка скрипта не являются согласием посетителя. Документация описывает действующую веб-интеграцию на 25 октября 2026 года.