# AI Метрика — модуль веб-аналитики для 1С-Битрикс

> AI Метрика — модуль статистики для сайтов на 1С-Битрикс. Показывает посещаемость,
> источники трафика, UTM-метки, страницы и ошибки 404, цели, клики, воронку магазина
> и заказы, а также журнал визитов. Данные хранятся в базе сайта и не передаются
> во внешние сервисы. Разработчик: Abricos Web. Модуль распространяется через
> Маркетплейс 1С-Битрикс. Версия 1.1.0. Требования: главный модуль main 20.0.0+,
> PHP 7.4+, MySQL или совместимая база.

## Что это такое

AI Метрика — модуль для 1С-Битрикс, который собирает статистику посещений сайта
средствами самой платформы. Код счётчика на страницы вставлять не нужно: трекер
подключается автоматически через обработчики событий Битрикс. Отчёты открываются
в административной панели в разделе «Сервисы → AI Метрика».

Модуль используют как замену или дополнение к внешним системам веб-аналитики, когда
важно, чтобы данные о посетителях не покидали сервер компании, а отчёты были связаны
с заказами интернет-магазина.

## Отчёты

1. Обзор — посетители, визиты, просмотры, глубина просмотра, отказы, средняя длительность, динамика по дням.
2. Источники — поисковые системы, реклама, соцсети, рассылки, прямые заходы.
3. UTM-метки — разбор utm_source, utm_medium, utm_campaign, utm_term, utm_content и меток рекламных систем (gclid, yclid, fbclid).
4. Страницы — популярные страницы, страницы входа и выхода, время на странице, глубина прокрутки, страницы с ошибкой 404.
5. Пути по сайту — связи между страницами и цепочки страниц внутри визита.
6. Цели и клики — отправка форм, клики по телефону и почте, переходы в мессенджеры, скачивание файлов, клик по элементу.
7. Воронка магазина — путь покупателя от просмотра товара до оплаты.
8. Заказы — количество заказов, выручка и средний чек в разрезе источника первого и последнего визита и кампании.
9. Аудитория — устройства, браузеры, операционные системы, языки, страны и города, активность по часам.

Дополнительно: журнал визитов с полным путём каждого посетителя, выгрузка любого
отчёта в CSV, фильтр ботов и поисковых роботов, поддержка нескольких сайтов
на одной установке Битрикс.

## Приватность

- Статистика хранится в базе сайта и не передаётся внешним сервисам.
- Скрипты сторонних систем аналитики на страницах не подключаются.
- Учёт можно включать только после согласия на cookie — по имени вашей cookie согласия.
- Есть уважение к заголовку Do Not Track.
- Геоопределение выключено по умолчанию.
- Срок хранения статистики задаёт администратор, старые данные удаляются автоматически.
- Свои заходы исключаются по IP-адресам, группам пользователей и разделам сайта.

## Требования

- 1С-Битрикс, главный модуль main версии 20.0.0 и выше.
- PHP 7.4 и выше.
- MySQL или совместимая база данных, как в вашей установке Битрикс.
- Дополнительные расширения PHP и внешние библиотеки не нужны.

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

- [Главная: что умеет модуль](https://metrikaai.ru/): обзор, девять отчётов, сравнение с внешними счётчиками, частые вопросы.
- [Промокод на скидку](https://metrikaai.ru/discount.php): получить скидку на покупку модуля по e-mail.
- [Установка модуля](https://metrikaai.ru/install.php): требования, установка из Маркетплейса, права доступа, проверка работы, обновление и удаление.
- [Настройка модуля](https://metrikaai.ru/setup.php): базовые параметры, исключение своих заходов, срок хранения, цели, UTM-метки, приватность, отключение трекера.
- [Не работает метрика — что делать](https://metrikaai.ru/troubleshoot.php): пошаговая диагностика, если статистика не собирается или пуста.
- [Кейсы использования](https://metrikaai.ru/cases.php): оценка рекламных кампаний, причины отказов, страницы 404, заявки, несколько сайтов.
- [Скриншоты админки](https://metrikaai.ru/screenshots.php): как выглядят отчёты внутри Битрикс.
- [Политика конфиденциальности](https://metrikaai.ru/privacy.php).

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

**Нужно ли вставлять код счётчика на страницы?**
Нет. Трекер подключается автоматически через обработчики событий Битрикс, разметка
шаблонов не требуется.

**Куда уходит статистика?**
Никуда. Данные пишутся в базу вашего сайта, отчёты открываются в админке Битрикс.

**Чем это лучше Яндекс Метрики и Google Analytics?**
Внешние счётчики блокируются расширениями браузеров и хранят данные посетителей
на чужом сервере. Здесь данные остаются в вашем контуре, а отчёты связаны с заказами
магазина.

**Метрика установлена, но данных нет. Что проверять?**
По порядку: включён ли модуль и сбор статистики; есть ли в исходном коде страницы
`abricosMetrikaConfig`; очищен ли кэш; не исключены ли ваши визиты; какой код ответа
возвращает запрос к `/bitrix/tools/abricos.metrika/collect.php` (ожидается 200 или 204).

**Как считать цели?**
Цель описывается в настройках модуля: клик по CSS-селектору, переход по ссылке,
скачивание файла, отправка формы, глубина прокрутки, время на странице, посещение
страницы или событие из своего JavaScript через
`window.abricosMetrika.goal(name, label, amount)`.

**Как исключить свои заходы?**
По группе пользователей, по IP-адресу или по разделу сайта. Для одного браузера
достаточно открыть сайт с параметром `?abricos_metrika_off=1`.

**Работает ли модуль на нескольких сайтах одной установки?**
Да, отчёты можно смотреть отдельно по каждому сайту.

## Ключевые понятия

- 1С-Битрикс — система управления сайтами и интернет-магазинами.
- Маркетплейс 1С-Битрикс — каталог модулей и решений для платформы.
- Веб-аналитика — сбор и анализ данных о поведении посетителей сайта.
- Визит — серия действий посетителя на сайте; завершается после периода бездействия.
- Цель — действие посетителя, которое считается результатом: заявка, заказ, звонок.
- UTM-метки — параметры ссылки, по которым определяется источник и кампания.
- Воронка — последовательность шагов покупки с видимыми потерями на каждом шаге.
- Журнал визитов — список отдельных визитов с полным путём посетителя по сайту.

## Контакты

- Разработчик: Abricos Web — https://abricosweb.ru
- Сайт продукта: https://metrikaai.ru
- Поддержка: поддержка@metrikaai.ru
- Карта сайта: https://metrikaai.ru/sitemap.xml