---
metadata:
- name: generator
content: Diplodoc Platform v5.50.6
alternate:
- https://yandex.com.tr/support/metrica/en/ecommerce/bitrix.md
- https://yandex.com.tr/support/metrica/es/ecommerce/bitrix.md
- https://yandex.com.tr/support/metrica/pt/ecommerce/bitrix.md
- https://yandex.com.tr/support/metrica/ru/ecommerce/bitrix.md
- https://yandex.com.tr/support/metrica/tr/ecommerce/bitrix.md
title: Подключение модуля для 1С-Битрикс
description: Подключение модуля для 1С-Битрикс.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/support/metrica/ru/llms.txt
# Подключение модуля для 1С-Битрикс
Команда Яндекс Метрики разработала официальный бесплатный модуль для установки на сайт счетчика веб-аналитики. Модуль работает на версии 1С-Битрикс 18.0 и выше, поддерживает все редакции «1С-Битрикс: Управление сайтом».
Возможности модуля «Яндекс Метрика»:
- Добавление новых счетчиков Метрики с включенными по умолчанию опциями:
- [Электронная коммерция](https://yandex.com.tr/support/metrica/ru/ecommerce/about.md);
- [Вебвизор](https://yandex.com.tr/support/metrica/ru/webvisor/info.md);
- [Карта кликов](https://yandex.com.tr/support/metrica/ru/behavior/click-map.md).
- Передача [событий электронной коммерции](https://yandex.com.tr/support/metrica/ru/ecommerce/data.md):
- просмотр карточки товара;
- добавление товара в корзину;
- удаление товара из корзины;
- покупка.
- Детализация [передаваемых данных о товаре](https://yandex.com.tr/support/metrica/ru/ecommerce/data.md#product_data).
{% cut "Безопасность модуля" %}
В результате анализа совместно с компанией «1С-Битрикс» обнаружены и устранены потенциальные уязвимости в модуле **yandex.metrika**.
Специалисты выявили несколько проблем безопасности. Существовал риск компрометации данных, подмены запросов или внедрения вредоносного кода злоумышленниками. Все найденные уязвимости оперативно устранены.
Внесенные изменения:
- Усилена аутентификация при вызове AJAX-действий — доступ к критическим операциям защищает проверка CSRF-токена и метода запроса.
- Исключена возможность подмены идентификатора пользователя через Cookie — идентификация теперь привязана к серверной сессии.
- Устранены риски, которые связаны с небезопасной десериализацией данных и использованием потенциально опасных функций (например, extract).
- Проведена тщательная валидация и экранирование всех пользовательских данных, выводимых в JavaScript-контекст, что предотвращает межсайтовый скриптинг (XSS).
- Добавлена строгая проверка CSRF-токена при сохранении настроек модуля в административной панели.
- Исправлен метод определения IP-адреса посетителя — теперь используется штатный механизм платформы, исключающий подмену IP через HTTP-заголовки.
Все изменения повышают уровень безопасности сайтов и не влияют на стандартную функциональность Яндекс.Метрики. Обновление не требует дополнительных действий со стороны администраторов — достаточно установить актуальную версию модуля.
Рекомендуем пользователям модуля **yandex.metrika** выполнить обновление для максимальной защиты проектов.
{% endcut %}
## Установка и настройка модуля {#general}
### Начало работы {#start}
1. Если у вас еще нет счетчика Метрики, [создайте его](https://yandex.com.tr/support/metrica/ru/quick-start.md). Убедитесь, что адрес сайта указан правильно в настройках счетчика. Для этого перейдите в Метрику на страницу **Настройки**. Обратите внимание на поле **Адрес** — здесь должен быть указан адрес сайта, на который вы хотите установить модуль.
1.
В настройках счетчика включите опцию **Электронная коммерция**. В код счетчика добавится контейнер для сбора данных `dataLayer`.
1. Убедитесь, что в 1С-Битрикс не активирован другой аналогичный модуль, устанавливающий счетчик Метрики. Для этого в панели администратора откройте **Marketplace** → **Установленные решения** и поищите модуль по названию «Метрика», «Metrica» или «Metrika». Если такой модуль установлен, удалите его.
### Шаг 1 — Установка модуля {#upload}
Перейдите в панель администратора 1С-Битрикс, авторизуйтесь и добавьте модуль одним из способов:
{% cut "Через панель администратора" %}
1. Откройте **Marketplace** → **Установленные решения**, найдите модуль с названием «Яндекс Метрика».
1. Нажмите значок и выберите **Установить**.
{.border-yes}
{% endcut %}
{% cut "Через 1C-Битрикс: Маркетплейс" %}
1. Перейдите в [1С-Битрикс: Маркетплейс](http://marketplace.1c-bitrix.ru/solutions), найдите модуль с названием «Яндекс Метрика».
1. Откройте модуль и нажмите кнопку **Установить**.
{% endcut %}
{% cut "С помощью ZIP-архива" %} {#zip}
1. Скачайте установочный ZIP-архив с кодировкой [UTF8](https://metrika-cms-plugins.s3.yandex.net/1c-bitrix/yandex.metrika.utf8.zip) или [CP1251](https://metrika-cms-plugins.s3.yandex.net/1c-bitrix/yandex.metrika.cp1251.zip).
1. Перейдите в административную панель 1С-Битрикс на страницу **Контент**.
1. Выберите раздел **Файлы и папки** → **bitrix** → **modules** и откройте последнюю страницу списка модулей.
1. Нажмите кнопку **Загрузить** → **Добавить файл** и выберите ZIP-архив с модулем Яндекс Метрики.
1. Нажмите кнопку **Сохранить**. Архив загрузится в каталог `modules` на вашем сервере.
1. Распакуйте архив: найдите его в списке модулей, нажмите значок  и выберите **Распаковать**. Убедитесь, что каталог `yandex.metrika` появился в списке.
1. Откройте **Marketplace** → **Установленные решения**, найдите модуль с названием «Яндекс Метрика». Нажмите значок  и выберите **Установить**.
{% endcut %}
### Шаг 2 — Настройка модуля {#set}
1. Перейдите на страницу **Настройки** → **Настройки продукта** → **Настройки модулей** → **Яндекс Метрика**.
1. Выберите сайт.
1. Укажите номер счетчика, который установлен на вашем сайте. Если модуль обнаружил на сайте счетчик Метрики, то поля будут уже заполнены. Проверьте их. [Как найти номер счетчика](https://yandex.com.tr/support/metrica/ru/general/tag-id.md)
1. По умолчанию опция **Вебвизор** включена. Она позволяет [записывать визиты посетителей](https://yandex.com.tr/support/metrica/ru/webvisor/info.md), чтобы вы могли более полно анализировать статистику. При необходимости вы можете отключить Вебвизор в любой момент.
1. Сохраните изменения.
{.border-yes}
{% note tip %}
Поле **Свойство Бренда** заполнять необязательно. [Заполните его](#brand), если хотите отслеживать в Метрике статистку по бренду товаров. Например, какой бренд наиболее популярен у покупателей.
Кроме этого, чтобы получать более подробную статистику о товарах (например, какие товары чаще просматривают посетители), [настройте событие detail](#detail).
{% endnote %}
### Шаг 3 — Проверка отправки данных {#check}
Проверьте, отправляются ли в Метрику данные:
- [электронной коммерции](https://yandex.com.tr/support/metrica/ru/ecommerce/check.md)
- [о посещениях на сайте](https://yandex.com.tr/support/metrica/ru/general/check-counter.md)
Данные электронной коммерции появятся в Метрике спустя несколько часов после их первой отправки. Чтобы посмотреть отчеты электронной коммерции, в Метрике откройте **Отчеты** → **Электронная коммерция**.
[Отчеты по электронной коммерции](https://yandex.com.tr/support/metrica/ru/data/e-commerce-reports.md)
Данные о визитах и просмотрах появятся в Метрике при первых посещениях сайта после установки модуля. Чтобы посмотреть статистику, в Метрике откройте **Отчеты**. Посмотрите, как работать с отчетами в разделе [Настройка и просмотр отчета](https://yandex.com.tr/support/metrica/ru/reports/report-general.md).
## Дополнительные настройки {#func}
### Как заполнить поле «Свойство Бренд» в настройках модуля {#brand}
В Метрику можно передавать информацию о брендах вашего интернет-магазина. На основе этих данных в Метрике [формируется отчет](https://yandex.com.tr/support/metrica/ru/reports/popular-brands.md), который помогает, например, определить наиболее популярный бренд у покупателей или узнать, какой бренд приносит наибольшую прибыль.
{% note info %}
В шаблонах 1С-Битрикс может быть несколько каталогов товаров. В настройках модуля Метрики отображаются свойства бренда только активных каталогов. Рекомендуем заполнить все доступные поля **Свойство Бренд** для корректной передачи данных в Метрику.
{% endnote %}
Чтобы найти значение свойства:
1. Перейдите в административную панель 1С-Битрикс.
1. Перейдите в раздел **Контент** → **Типы инфоблоков** → **Каталоги** и выберите каталог.
1. Справа откройте вкладку **Свойства**.
1. В списке найдите поле, которое отвечает за бренд.
1. Укажите название поля в настройках модуля «Яндекс Метрика».
{.border-yes}
### Как передавать информацию о просмотрах товаров (свойство detail) {#detail}
В Метрику можно передавать данные о просмотре товаров, чтобы отчеты по электронной коммерции содержали более подробную информацию. Например, таким образом формируется [Отчет «Популярные товары»](https://yandex.com.tr/support/metrica/ru/reports/popular-goods.md).
Чтобы настроить события, отвечающие за просмотр товара, нужно внести изменения в код файла `element.php` шаблона компонента `bitrix:catalog` на вашем сайте.
{% note alert %}
Путь до файла `element.php` может различаться в шаблонах разных сайтов.
{% endnote %}
1. Авторизуйтесь на сайте как администратор.
1. На вкладке **Сайт** включите **Режим правки**.
{% note info %}
Если раньше вы редактировали шаблон, переходите к п. 6 инструкции.
{% endnote %}
1. На сайте откройте карточку товара и наведите курсор на область компонента каталога — появится меню.
1. Нажмите значок , выберите каталог, а затем — **Копировать шаблон компонента**.
1. В поле **Копировать в шаблон сайта** выберите **текущий** и сохраните изменения.
1. [Найдите](#found-element) и откройте файл `element.php`. В коде найдите строку вида:
```php
$elementId = $APPLICATION->IncludeComponent('bitrix:catalog.element', 'bootstrap_v4', $componentElementParams,
$component
);
```
Если до компонента `bitrix:catalog.element` нет `"$elementId = "`, добавьте в код переменную самостоятельно.
1. После нее добавьте `$APPLICATION->IncludeComponent("yandex.metrika:detail", "", array("PRODUCT_ID" => $elementId), $component);`.
Убедитесь, что регистр переменных и названий функций кода `detail` совпадает с регистром переменных файла `element.php`.
{% cut "Пример кода" %}
```php
...
$elementId = $APPLICATION->IncludeComponent('bitrix:catalog.element', 'bootstrap_v4', $componentElementParams,
$component
);
$APPLICATION->IncludeComponent("yandex.metrika:detail", "", array("PRODUCT_ID" => $elementId), $component);
...
```
{% endcut %}
1. Нажмите кнопку **Сохранить**.
{% cut "Как найти файл element.php" %} {#found-element}
1. На вкладке **Сайт** включите **Режим правки**.
1. На сайте откройте карточку товара и наведите курсор на область компонента каталога — появится меню.
1. Нажмите значок , выберите каталог, а затем — **Редактировать шаблон компонента**.
1. Убедитесь, что в открывшемся окне отображается файл `element.php`. Путь до файла указан в названии окна.
{% endcut %}
После установки и настройки модуля посмотрите лог ошибок. Для этого откройте модуль в административной панели 1С-Битрикс. Вы можете задать вопросы через [форму ниже](#form) или на сайте 1С-Битрикс (в правом нижнем углу нажмите кнопку **Техподдержка**).
{% cut "Посмотреть частые ошибки" %}
- Устаревшая версия 1С-Битрикс. Проверьте, готова ли к установке новая версия и установите ее. Для этого в панели администратора перейдите на страницу **Marketplace** → **Обновление платформы**.
- Указанное вами свойство бренда отсутствует на сайте.
- Номер счетчика содержит символы, отличные от цифр.
{% endcut %}
## Лицензионное соглашение {#licens}
Прочтите [Лицензионное соглашение](https://metrika-cms-plugins.s3.yandex.net/1c-bitrix/LICENSE.txt) на использование модуля «Яндекс Метрика» для 1С-Битрикс.
## Обновление модуля {#update}
Когда у модуля появится новая версия, сообщение об этом отобразится в панели администратора 1С-Битрикс. Установить обновление можно одним из способов:
- Перейдите по ссылке из уведомления.
- Выберите модуль на странице **Marketplace** → **Установленные решения**.
- На странице [1С-Битрикс: Маркетплейс](https://marketplace.1c-bitrix.ru/).
- Скачайте обновленный ZIP-архив с кодировкой [UTF8](https://metrika-cms-plugins.s3.yandex.net/1c-bitrix/yandex.metrika.utf8.zip) или [CP1251](https://metrika-cms-plugins.s3.yandex.net/1c-bitrix/yandex.metrika.cp1251.zip) и [следуйте инструкции по установке файла](#zip).
[Написать в чат](https://yandex.com.tr/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}
- - -
#|
||
Полезные ссылки
- [Демосчетчик](https://metrica.yandex.com.tr/r/dashboard?)
- [Добавить счетчик](https://metrica.yandex.com.tr/add/)
- [Бесплатная настройка счетчика](https://yandex.com.tr/promo/freeservice/metrica?utm_source=help_metrica_tr&utm_medium=cpc&utm_campaign=1)
- [API Яндекс Метрики](https://tech.yandex.com.tr/metrika/)
- [Предложить идею](https://yandex.com.tr/support/metrica/troubleshooting/idea.html)
- [Обсудить в Telegram](https://t.me/yandexmetrika)
|
Онлайн-обучение
- [Получить сертификат по Яндекс Метрике](https://yandex.ru/adv/expert/exam/metrika/?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)
- [Пройти обучающий курс](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)
||
|#