Веб-аналитика: Метрика и GA4

Веб-аналитика: Яндекс Метрика и Google Analytics 4 для OpenCart 4

В OpenCart 4.1.0.4 группа «Расширения → Аналитика» пуста: ядро умеет выводить код аналитики в шапке каждой страницы, но ни одного расширения этого типа в поставке нет. Пакет добавляет два расширения типа «Аналитика» — «Яндекс Метрика» и «Google Analytics 4» — с настройками для каждого магазина и событиями электронной коммерции. Для владельцев магазинов, которым нужны счётчики без правки шаблонов и вставки кода вручную.

Яндекс Метрика

• Номер счётчика (только цифры) — код счётчика из кабинета вставлять не нужно, пакет формирует официальный фрагмент tag.js с ym(номер, "init", {…}) и <noscript>-картинкой.
• Флажки: вебвизор, карта кликов, отслеживание ссылок, точный показатель отказов.
• Электронная коммерция через контейнер данных (dataLayer по умолчанию, имя настраивается): просмотр товара, добавление в корзину, покупка.

Google Analytics 4

• Идентификатор потока данных вида G-XXXXXXXXXX; подключается стандартный тег gtag.js с gtag('config', …).
• События электронной коммерции view_item, add_to_cart, purchase с товарами, суммой, налогом и доставкой.

Электронная коммерция

Цены — в валюте, выбранной посетителем на витрине, с налогом (как на странице); покупка — в валюте заказа. Покупка передаётся один раз: обновление страницы «Заказ оформлен» событие не повторяет. Шаблоны темы не меняются: товар страницы и покупка добавляются в код счётчика, а для добавления в корзину событие витрины дописывает данные товара в ответ сервера на запрос «В корзину».

Настройка

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

Установка

1. Расширения → Установщик → «Загрузить» — файл analytics_oc4.ocmod.zip (имя не менять: OpenCart 4 берёт из него код расширения) → «Установить».
2. Расширения → Расширения, тип «Аналитика» → «Установить» у «Яндекс Метрика» и/или «Google Analytics 4». При установке любого из двух создаются общие данные пакета: два события витрины и настройки обоих расширений по умолчанию (выключены).
3. «Редактировать» у строки магазина: номер счётчика (Метрика) или идентификатор потока (GA4), «Статус», сохранить.
4. В исходном коде витрины (Ctrl+U) в <head> появился код счётчика. Если в настройках магазина выбрана страница уведомления о cookie, код появляется после того, как посетитель нажмёт «Принять» — это поведение OpenCart 4, страница настроек расширения о нём предупреждает.

Ядро не изменяется, OCMOD и обновление модификаторов не требуются. Права получает группа пользователя, который нажал «Установить»; другим группам их выдают в Система → Пользователи → Группы пользователей.

Входит в состав OCM Store

Пакет входит в бесплатную русскую сборку OpenCart 4.1.0.4 OCM Store: там оба расширения уже установлены и выключены — достаточно ввести номер счётчика или идентификатор потока и включить статус. Отдельный пакет нужен для обычного OpenCart 4.1.0.4.

Обновление

Новую версию ставят поверх: Расширения → Установщик → удалить прежний пакет (кнопка «Удалить» у пакета удаляет только файлы) → загрузить новый архив → «Установить». Расширения в «Аналитике» при этом не удалять: удаление расширения стирает его настройки для всех магазинов.

Отключение и удаление

Временно убрать счётчик — выключить «Статус»: код исчезает сразу, кеш очищать не нужно. Удаление в «Расширения → Аналитика» убирает настройки расширения; события витрины остаются, пока установлено второе расширение пакета, и удаляются вместе с последним. Файлы удаляются в Установщике.

Совместимость и ограничения

• OpenCart 4.1.0.4, PHP 8.2, тема Default — проверено с тестовыми идентификаторами на витрине; работа с настоящими счётчиками проверяется в кабинетах Метрики и GA4.
• OpenCart 4.0.x, ocStore 4 и сторонние темы не проверялись; тема должна выводить {{ analytic }} в шаблоне шапки, а формы витрины — отправляться штатно через jQuery.
• Google Tag Manager, Universal Analytics (UA-…), режим согласия gtag, цели Метрики, события remove_from_cart/begin_checkout, серверная отправка (Measurement Protocol) и пункт в меню панели в этой версии не поддерживаются.

Список изменений

1.0.0 — первый выпуск: расширения «Яндекс Метрика» и «Google Analytics 4» типа «Аналитика», настройки по магазинам, официальные фрагменты tag.js и gtag.js, события электронной коммерции (просмотр товара, добавление в корзину, покупка), предупреждение об уведомлении о cookie, руководство во вкладке.