К статье
Практический материал

Администрирование · 9 мин

Как установить Метрику в 1С-Битрикс

Способы установки счётчика Яндекс.Метрики на сайт под управлением 1С-Битрикс: через шаблон, модуль и внешние решения. Проверка работы и типичные ошибки.

Счётчик Яндекс.Метрики на сайте под управлением 1С-Битрикс можно установить тремя рабочими способами: вставкой кода в шаблон сайта, через встроенный модуль «Веб-аналитика» (при наличии соответствующей редакции) или через готовые решения из Маркетплейса. Выбор зависит от редакции продукта, доступа к файлам шаблона и того, кто будет обслуживать сайт дальше — разработчик или контент-менеджер.

Самый надёжный и универсальный вариант — вставить код счётчика в шаблон сайта перед закрывающим тегом </body>. Этот способ работает в любой редакции, не зависит от обновлений модулей и позволяет видеть код прямо в файлах проекта. Минус — нужен доступ к файлам шаблона и базовое понимание структуры Битрикса.

Перед началом работы получите код счётчика в интерфейсе Яндекс.Метрики: создайте счётчик, укажите домен сайта и скопируйте сгенерированный фрагмент JavaScript. Все дальнейшие действия выполняются уже внутри Битрикса.

Какой способ установки выбрать

Способ установки определяется тремя факторами: редакцией Битрикса, правами доступа и количеством шаблонов на сайте. Если сайт использует один шаблон и у вас есть доступ к файлам, вставка в шаблон — оптимальный вариант. Если шаблонов несколько (например, отдельный для мобильной версии или лендингов), код придётся добавлять в каждый либо использовать модуль.

Модуль «Веб-аналитика» входит не во все редакции: в младших («Старт», «Стандарт») его может не быть. Проверить наличие можно в административном разделе: Настройки → Настройки продукта → Модули. Если модуль установлен, счётчик подключается через интерфейс без правки файлов.

Сравнение способов установки

Вставка кода в шаблон

Работает в любой редакции, код виден в файлах проекта. Ограничение: нужен доступ к файлам и осторожность при обновлении шаблона.

Модуль «Веб-аналитика»

Настраивается через админку без правки кода. Ограничение: доступен не во всех редакциях.

Решения из Маркетплейса

Быстрая установка, часто есть дополнительные функции вроде целей и ecommerce. Ограничение: зависимость от стороннего решения и его обновлений.

Подготовка: создание счётчика и резервная копия

В интерфейсе Яндекс.Метрики нажмите «Добавить счётчик», укажите имя и домен сайта. При необходимости включите опции: Вебвизор, карту кликов, отслеживание хеша в адресной строке (актуально для одностраничных приложений). После сохранения Метрика покажет код — скопируйте его целиком, включая обёртку <script> и блок <noscript>.

Перед правкой файлов шаблона сделайте резервную копию как минимум изменяемых файлов. В Битриксе это можно сделать через Настройки → Инструменты → Резервное копирование, либо просто скопировав файл шаблона по FTP или через файловый менеджер панели хостинга. Правка шаблона — низкорискованная операция, но случайное удаление фрагмента вёрстки сломает отображение сайта.

Установка кода в шаблон сайта

Откройте административный раздел и перейдите в Настройки → Настройки продукта → Сайты → Шаблоны сайта, найдите активный шаблон и откройте его для редактирования. Альтернативный путь — прямое редактирование файлов через структуру сайта: Контент → Структура сайта → Файлы и папки, затем перейти в /bitrix/templates/ваш_шаблон/.

Код счётчика нужно разместить так, чтобы он загружался на всех страницах. Для этого подходят два файла: header.php (код попадёт в начало страницы) или footer.php (код окажется перед закрывающим </body>). Яндекс рекомендует размещать счётчик как можно ближе к началу страницы для точного учёта, но на практике вставка в footer снижает влияние на скорость отрисовки и тоже корректно работает.

Вставьте скопированный код целиком, не разрывая его и не меняя порядок строк. Если в шаблоне используется композитный режим, убедитесь, что код не попал внутрь динамически кешируемой области с условиями, которые могут его отсечь. Сохраните файл и сбросьте кеш: Настройки → Настройки продукта → Автокеширование → очистка кеша, либо кнопка «Сбросить кеш» на панели производительности.

Порядок установки через шаблон
  1. 1
    Создайте счётчик в Яндекс.Метрике и скопируйте код
  2. 2
    Откройте файл footer.php активного шаблона в /bitrix/templates/
  3. 3
    Вставьте код перед закрывающим тегом
  4. 4
    Сохраните файл и сбросьте кеш Битрикса
  5. 5
    Откройте сайт в браузере и проверьте наличие кода в исходнике страницы
  6. 6
    Убедитесь в интерфейсе Метрики, что счётчик начал передавать данные

Установка через модуль «Веб-аналитика» и Маркетплейс

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

Третий вариант — бесплатные и платные решения из Маркетплейса Битрикса, которые добавляют счётчик Метрики через настройки в админке. Такие модули часто умеют передавать данные электронной коммерции (ecommerce): просмотры товаров, добавления в корзину, заказы. Если вам нужна сквозная аналитика продаж, готовое решение сэкономит время по сравнению с ручной настройкой передачи событий.

При выборе решения из Маркетплейса смотрите на дату последнего обновления и совместимость с вашей версией Битрикса. Заброшенный модуль может конфликтовать с новыми версиями ядра или перестать работать после обновления.

Проверка работы счётчика

Первичная проверка — визуальная. Откройте любую страницу сайта, нажмите «Просмотр исходного кода» (Ctrl+U в большинстве браузеров) и найдите поиском фрагмент кода Метрики, например по строке mc.yandex или номеру счётчика. Если код присутствует на всех типах страниц (главная, раздел каталога, карточка товара), установка на уровне вёрстки выполнена.

Вторая проверка — в интерфейсе Метрики. На странице списка счётчиков статус должен смениться на «Счётчик установлен» (зелёный индикатор). Данные в отчётах начинают появляться с задержкой: первые визиты видны обычно в течение нескольких минут, но полноценные отчёты формируются с отставанием. Откройте сайт сами, желательно из другого браузера или в режиме инкогнито, чтобы визит гарантированно зафиксировался.

Для диагностики передачи данных удобно использовать консоль разработчика браузера: вкладка Network, фильтр по mc.yandex или watch. При загрузке страницы должен уходить запрос к серверам Метрики со статусом 200. Если запроса нет — код не выполняется, ищите причину в шаблоне или в блокировщиках.

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

Как проверить результат

Код в исходнике страницы
Норма

Фрагмент счётчика найден на всех типах страниц

Тревожный признак

Код есть на главной, но отсутствует в каталоге — значит, добавлен не в общий шаблон

Статус в Метрике
Норма

Зелёный индикатор «Счётчик установлен»

Тревожный признак

Красный статус спустя сутки после установки

Запросы в консоли браузера
Норма

Запрос к mc.yandex со статусом 200

Тревожный признак

Запрос заблокирован или отсутствует — проверьте блокировщики рекламы и Content Security Policy

Типичные ошибки и ограничения

Самая частая ошибка — вставка кода в один шаблон при нескольких активных. Симптом: в Метрике трафик заметно ниже реального, часть страниц не учитывается. Лечится добавлением кода во все используемые шаблоны.

Вторая распространённая проблема — кеширование. Код вставлен правильно, но на сайте его не видно, потому что страницы отдаются из кеша. После любой правки шаблона сбрасывайте кеш Битрикса, а при включённом композитном режиме проверяйте страницу в режиме инкогнито.

Третья группа ошибок — конфликты с блокировщиками рекламы и политиками безопасности. AdBlock и аналоги режут скрипты Метрики у части посетителей — это нормально, доля таких пользователей закладывается в погрешность статистики. А вот строгий Content Security Policy на сервере может заблокировать счётчик для всех: тогда в CSP нужно добавить домены Яндекса в разрешённые источники скриптов.

Типичные ошибки
01
Вставка кода только в один шаблон при нескольких активных — часть трафика теряется
02
Отсутствие сброса кеша после правки — код не виден на сайте, кажется, что установка не сработала
03
Разрыв кода счётчика при вставке — скрипт не выполняется, данных нет вовсе
04
Дублирование счётчика через модуль и шаблон одновременно — визиты могут учитываться некорректно, проверьте, что код встречается на странице один раз

Частые вопросы

Можно ли установить Метрику без доступа к файлам шаблона?

Да, если в вашей редакции есть модуль «Веб-аналитика» с поддержкой внешних счётчиков или если установить готовое решение из Маркетплейса. Оба варианта настраиваются через административный интерфейс без правки кода.

Слетит ли счётчик при обновлении Битрикса?

Код, вставленный в файлы шаблона в папке /bitrix/templates/ваш_шаблон/, при обновлении ядра не затирается — обновляются только системные файлы. Риск есть только при обновлении самого шаблона, если он поставлялся как готовое решение: тогда свои правки нужно переносить повторно.

Почему в Метрике нет данных, хотя код на странице есть?

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

Нужно ли добавлять счётчик в шаблон печати или служебные страницы?

Нет. Шаблоны печати, страницы ошибок и служебные области обычно не требуют учёта в аналитике. Достаточно, чтобы счётчик был в основных шаблонах, которые видят посетители.

Как передать в Метрику данные о заказах интернет-магазина?

Для этого используется ecommerce-расширение Метрики: на страницах оформления и подтверждения заказа через JavaScript передаются данные о товарах и сумме. Проще всего это реализовать готовым модулем из Маркетплейса; ручная настройка требует доработки шаблонов компонентов оформления заказа.

Итог

Что важно запомнить

Базовый способ установки Метрики в Битрикс — вставка кода в footer.php активного шаблона с последующим сбросом кеша. Модуль «Веб-аналитика» и решения из Маркетплейса подходят, когда нет доступа к файлам или нужна передача ecommerce-данных. Обязательно проверяйте наличие кода на всех типах страниц и статус счётчика в интерфейсе Метрики.