Как подключить Яндекс Метрику и проверить работу счётчика
Как выбрать способ установки, избежать дублей, проверить номер и передачу просмотров, разобраться с SPA, блокировщиком и конфиденциальными данными.
Подключение Яндекс Метрики состоит из двух задач: установить счётчик нужного владельца и подтвердить передачу данных именно на его номер. Значок «код установлен» в настройках сайта не заменяет проверку опубликованной страницы.
Эта инструкция доводит до работающего базового счётчика. Цели и передача покупок настраиваются отдельно: они не появляются автоматически от установки кода.
Найдите существующий счётчик и ответственного
Проверьте настройки платформы, плагины, менеджер тегов и общий шаблон сайта. Узнайте, кому принадлежит уже установленный счётчик и есть ли доступ у бизнеса. Не создавайте новый только потому, что сотрудник не видит старый в своём аккаунте: сначала восстановите доступ или согласуйте замену.
Отдельно определите рабочий и тестовый сайты. Тестовые просмотры не должны незаметно смешиваться с данными клиентов. Запишите владельца, номер, домены, часовой пояс и способ установки.
Создайте или выберите счётчик
В Метрике под нужным Яндекс ID выберите существующий счётчик либо создайте новый для согласованного сайта. Сверьте адреса и настройки, получите актуальный код или номер для штатной интеграции платформы. Точные названия элементов интерфейса могут меняться; источник кода — настройки вашего счётчика, а не случайный фрагмент из статьи.
Решите, какие дополнительные возможности действительно нужны. Вебвизор и другие инструменты не следует включать автоматически без проверки собираемых данных и сценария сайта.
| Способ установки | Что сделать | Основной риск |
|---|---|---|
| Штатная интеграция CMS/конструктора | Внести номер по актуальной инструкции платформы | Тот же счётчик уже вставлен другим способом |
| Управляемый менеджер тегов | Добавить один согласованный тег и правила запуска | Несколько контейнеров или условий дают повторы |
| Общий шаблон сайта | Разместить предоставленный код в общей части страниц по документации | Код есть на главной, но отсутствует в каталоге |
| SPA-приложение | Настроить загрузку и регистрацию переходов с разработчиком | Маршруты меняются без корректных просмотров |
Выберите один контролируемый способ. Не вставляйте полный код вручную в каждую карточку товара и поверх работающего плагина.
Опубликуйте и проверьте реальный запрос
- Откройте актуальную публичную страницу после публикации. Убедитесь, что проверяется нужный домен и версия сайта.
- В инструментах разработчика откройте Network и перезагрузите страницу. Найдите загрузку Метрики и запрос просмотра; сопоставьте номер счётчика с ожидаемым. Наличие только загруженного скрипта не доказывает отправку просмотра.
- Посмотрите ошибки JavaScript и блокировки. Проверьте, не установлен ли тот же номер через второй плагин или шаблон.
- Откройте другую страницу каталога и корзину. Проверьте передачу просмотров там, где код должен работать.
- Воспользуйтесь официальной проверкой счётчика и убедитесь, что данные принимаются Метрикой. Появление данных в интерфейсе не обязано быть мгновенным; результат сети и приём отчётом фиксируйте раздельно.
Присутствие нескольких сетевых запросов само по себе не доказывает дубль: библиотека может выполнять разные операции. Сопоставляйте именно просмотры, номера и повторную инициализацию, а не любое обращение к сервису.
Разберите причины отсутствия данных
| Наблюдение | Проверка | Действие |
|---|---|---|
| Код есть, запрос заблокирован расширением | Повторить в контролируемом чистом профиле | Не считать локальную блокировку поломкой всего сайта |
| Ошибка CSP | Посмотреть запрещённый ресурс и текущую политику | Разработчик разрешает необходимые обращения, не отключает всю защиту |
| Данные уходят на другой номер | Сверить плагин, шаблон и теги | Удалить устаревшую установку по согласованному плану |
| Главная работает, каталог нет | Проверить разные шаблоны и публикацию | Исправить общий способ подключения |
| Просмотр SPA-перехода отсутствует | Проверить обработчик смены маршрута | Настроить передачу hit по схеме приложения |
Для SPA официальная схема может использовать defer: true, отключающий автоматический просмотр, и явные вызовы hit. Это отдельная ветвь реализации: не добавляйте её поверх уже работающего механизма переходов, иначе получите дубли. Переход с URL-фрагментом тоже проверяют фактически, а не предполагают, что любое изменение адреса посчитано.
Проверьте конфиденциальные данные до отправки
Не помещайте email, телефон, адрес и другие идентифицирующие данные в URL, UTM, названия событий и произвольные параметры. Например, путь вида /order?email=... нужно изменить так, чтобы личные сведения не попадали в аналитический просмотр. Очищать только видимый заголовок страницы недостаточно.
Предусмотренные сервисом специальные функции передачи данных имеют отдельные условия; они не разрешают отправлять любые контакты в обычном событии. Сценарий уведомления и согласия определяют для своего процесса. Технически возможен отложенный запуск счётчика после выбора посетителя, но эта инструкция не устанавливает универсальную юридическую модель для всех сайтов.
Заполните протокол установки
Учебный пример: на сайте уже работает плагин с условным номером 12345678. Не добавляем второй код через HTML. Проверка даёт следующий результат:
Счётчик: 12345678 — учебный номер, заменить своим
Способ: штатная интеграция платформы
Карточка: просмотр нужного номера отправлен
Корзина: просмотр нужного номера отправлен
SPA-переход: просмотр отсутствует
Решение: базовые страницы работают; SPA требует исправления
Повторная проверка: после настройки переходов, без второй инициализации
Дата / домен / версия / исполнитель: заполнить фактическими данными
Приём в интерфейсе Метрики: проверить и записать отдельно
Если в альтернативном проходе запрос пропадает только с блокировщиком, сначала повторите контролируемую проверку без него; не переустанавливайте счётчик вслепую. Если после исправления SPA каждый переход отправляет два просмотра, выясните пересечение автоматического и ручного механизма.
Пример показывает диагностику, а не реальную установку в аккаунте читателя. После подтверждения базового счётчика можно перейти к целям Метрики и электронной коммерции.
Счётчик установлен — покупки уже учитываются?
Нет. Базовый просмотр страницы и событие покупки — разные данные. Для заказов нужна отдельная настройка и проверка электронной коммерции, включая уникальность заказа и корректные суммы.