Google Analytics Enhanced Ecommerce GA4

Модуль совместим с CS-Cart версии 4.3.1 и новее, с такими редакциями как CS-Cart, CS-Cart Ultimate, Multivendor, Multivendor Plus, Multivendor Ultimate. Модуль не вносит изменений в шаблоны темы оформления, поэтому работает с любой темой. В случае конфликта модуля с вашей темой обращайтесь в наш центр поддержки.

Начиная с версии 1.5.0 модуль совместим с PHP 8.3.

После оформления и оплаты, ваш заказ будет автоматически переведен в статус Оплачен в течение считанных минут. Статус заказа Оплачен означает активацию лицензии и вам на e-mail отправляется письмо с подтверждением о получении оплаты и письмо со ссылкой на скачивание модуля. Так же модуль всегда можно скачать в нашем разделе Управление лицензиями. Для установки модуля на ваш сайт, пожалуйста, выполните следующие шаги:

1. Скачайте последнюю версию модуля на нашем сайте в разделе "Управление лицензиями" или по ссылке, отправленной по e-mail.
2. Пройдите в раздел Модули → Управление модулями и в меню шестерёнки выберите Ручная установка.
3. Выберите ранее скачанный файл и завершите установку модуля.

На этом установка модуля завершена. Для перехода на страницу настроек модуля выберите установленный модуль в разделе Модули → Модули CS-Commerce

Все настройки модуля собраны на одной вкладке и находятся в разделе Модули → Модули CS-Commerce → Google Analytics Enhanced Ecommerce GA4.

Настройка сводится к трём шагам:

1. выбрать способ подключения к Google Analytics 4 и указать идентификатор;
2. отметить, какие события нужно отправлять;
3. убедиться, что события доходят до GA4.

Каждый шаг разобран в подразделах.

Способ подключения

Определяет, как модуль передаёт события в Google Analytics 4:

• Google-тег (gtag.js) — рекомендуемый вариант. Модуль сам вставляет код счётчика и отправляет события напрямую в GA4. Достаточно указать идентификатор потока данных;
• Google Tag Manager — модуль кладёт события в dataLayer, а теги внутри контейнера вы настраиваете самостоятельно. Выбирайте этот вариант, если сайт уже использует GTM для других тегов или тегами занимается маркетолог. Порядок настройки описан в разделе «Подключение через Google Tag Manager».

Код GA4/GTM уже установлен на сайте

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

Если код счётчика будет вставлен дважды, GA4 начнёт считать просмотры и события по два раза. Проверьте исходный код страницы магазина перед тем, как включать эту настройку.

Идентификатор потока данных

Идентификатор вида G-XXXXXXX из кабинета Google Analytics: Администратор → Потоки данных → ваш веб-поток. Поле показывается, когда выбран способ подключения «Google-тег» и выключена настройка «Код GA4/GTM уже установлен на сайте».

ID контейнера Google Tag Manager

Идентификатор вида GTM-XXXXXXX из кабинета Google Tag Manager. Поле показывается, когда выбран способ подключения «Google Tag Manager» и выключена настройка «Код GA4/GTM уже установлен на сайте».

Характеристика бренда

Необязательная настройка. В CS-Cart нет отдельного поля «бренд», поэтому бренд обычно заводят характеристикой товара. Укажите здесь эту характеристику — и её значение будет уходить в GA4 в поле item_brand, а отчёты по брендам заработают без дополнительной настройки. Значение берётся на языке админ-панели по умолчанию.

Каждое событие включается отдельным флажком. Имена событий соответствуют стандартной схеме электронной торговли Google Analytics 4, поэтому встроенные отчёты GA4 работают без дополнительной настройки. По умолчанию включены все события.

События каталога

• Просмотр товара (view_item) — открыта страница товара;
• Просмотр каталога товаров (view_item_list) — покупателю показан список товаров: категория, результаты поиска, подборка. Событие отправляется только тогда, когда список действительно отображён.

События корзины

• Добавление/удаление в корзину (add_to_cart, remove_from_cart) — товар добавлен в корзину или удалён из неё, а также изменено его количество;
• Просмотр корзины (view_cart) — открыта страница корзины;
• Добавление в избранное (add_to_wishlist);
• Начало оформления заказа (begin_checkout);
• Пользователь выбрал доставку (add_shipping_info) — отправляется в момент выбора способа доставки на странице оформления;
• Пользователь выбрал способ оплаты (add_payment_info) — отправляется в момент выбора способа оплаты;
• Размещение заказа (purchase) — заказ оформлен.

События покупателей

• Авторизация (login);
• Регистрация (sign_up).

Как считаются суммы

В событии purchase модуль передаёт сумму заказа без стоимости доставки, а доставку и налог — отдельными полями shipping и tax. Так рекомендует Google Analytics: иначе доставка попадает в выручку и отчёты завышают оборот.

Такой расчёт действует начиная с версии 1.5.0. Если вы обновляетесь с более ранней версии, сравнивать выручку до и после обновления следует с поправкой на это изменение.

При способе подключения Google Tag Manager модуль только кладёт события в dataLayer. Отправку этих событий в GA4 нужно настроить внутри контейнера — сам по себе GTM этого не делает.

Это самая частая причина обращения «модуль включён, а событий в GA4 нет»: контейнер подключён, но теги внутри него не настроены. Если вам не нужны другие теги в GTM, проще выбрать способ подключения «Google-тег» — тогда настраивать ничего не придётся.

Что нужно сделать в контейнере

1. Создайте тег конфигурации Google с вашим идентификатором потока данных (G-XXXXXXX) и триггером Initialization — All Pages;
2. Для каждого события создайте пользовательский триггер типа «Специальное событие», указав имя события из раздела «Какие события отправляет модуль» — например view_item или purchase;
3. Создайте тег события GA4 на каждый такой триггер, передав нужные параметры из dataLayer;
4. Проверьте работу в режиме предварительного просмотра GTM и опубликуйте контейнер.

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

После настройки убедитесь, что события действительно доходят до Google Analytics 4.

1. Откройте витрину магазина в браузере и пройдите путь покупателя: страница товара → добавление в корзину → оформление заказа;
2. В кабинете Google Analytics откройте Администратор → DebugView или отчёт Отчёты → В реальном времени;
3. Убедитесь, что события приходят с ожидаемыми именами: view_item, add_to_cart, begin_checkout, purchase.

Если событий нет

• проверьте, что модуль включён, а нужные события отмечены флажками в настройках;
• убедитесь, что указан идентификатор потока данных (или ID контейнера) и он относится к нужному ресурсу;
• если выбран способ подключения через Google Tag Manager — проверьте, что теги внутри контейнера настроены и контейнер опубликован;
• если включена настройка «Код GA4/GTM уже установлен на сайте», проверьте, что код действительно присутствует в исходном коде страницы;
• очистите кэш CS-Cart и кэш браузера, затем повторите проверку;
• блокировщики рекламы в браузере блокируют отправку событий — проверяйте в режиме инкогнито с отключёнными расширениями.

Если после этого события не появились, обратитесь в наш центр поддержки.

Для того, чтобы иметь доступ к обновлениям модуля, у вас должен быть активный период подписки на обновления. При истекшем периоде подписки, вам будут доступны только обновления, выпущенные до даты истечения вашей подписки. Продлить подписку на обновления можно в разделе "Управление лицензиями" на нашем сайте. 

Модуль поддерживает поставку обновлений через Центр обновлений CS-Cart. О выходе новых версий модуля вас оповестит встроенный Центр уведомлений Cart (колокольчик). Обновление модуля с помощью Центра обновлений позволит без потерь настроек данных модуля произвести переход на более новую версию модуля.

Непосредственно перед обновлением, крайне рекомендуется делать полный бэкап сайта (базы данных и файлов) вашего магазина средствами сервера или хостинга.

Обновление модуля через Центр обновлений:

1. В верхнем меню пройдите в раздел Администрирование → Центр обновлений;
2. В меню шестеренки нажмите "Проверить доступные обновления"
3. Cреди списка доступных обновлений найдите нужное и нажмите кнопку Обновить;
4. Следуйте всем инструкциям, которые будут показаны при процедуре обновления;
5. Рекомендуется произвести очистку кэша CS-Cart после завершения устанвоки обновлений удалением папки var/cache на вашем сервере или добавлением в адресную строку параметра ctpl (прмиер: https://domain.com/admin.php?ctpl).

Переустановка модуля удалением:

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

Для полной переустановки модуля без сохранения данных выполните следующие шаги:

1. Пройдите в раздел Модули → Управление модулями и найдите старый установленный модуль.
2. Нажмите в меню шестеренки модуля кнопку удалить.
3. Скачайте последнюю версию модуля на нашем сайте в разделе "Управление лицензиями".
4. Пройдите в раздел Модули → Управление модулями и в меню шестеренки выберите Ручная установка.
5. Выберите ранее скачанный файл и завершите установку модуля.

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

Для того, чтобы воспользоваться нашей технической поддержкой, выполните следующие шаги:

1. На нашем сайте центра поддержки https://helpdesk.cs-commerce.com/ авторизуйтесь под своей учетной записью;
2. Нажмите на кнопку "Новая заявка";
3. Заполните все необходимые поля и создайте заявку (Вы получите на e-mail письмо с подтверждением);
4. Ожидайте ответ специалиста (на ваш e-mail придет уведомление об ответе на вашу заявку) в соответствии с регламентами работы службы техподдержки.

Если Вы не получили ответ в течении сроков, обозначенных в регламентах, напишите нам на e-mail [email protected] сообщение с темой заявки и мы постараемся решить вас вопрос в ближайшее время.

Техническая поддержка по диалогу в чате на сайте, прямым телефонным обращениям или e-mail письмам не осуществляется. Вся помощь проходит через центр поддержки. Внимательно изучайте документацию к модулю и условия технической поддержки перед созданием обращения.

Рекомендуем ознакомиться с общими ограничениями:

1. Фрагменты кода  или некоторые файлы модуля могут иметь закрытую (закодированную) часть. Закодированная часть не создает проблемы в доработке модуля;
2. Модуль будет работать только на тех доменах, которые указаны в лицензии пользователя. При попытке использования решения на установках CS-Cart, домены которых не включены в лицензию, модуль будет автоматически выключен;
3. Установка локально не допускается системой лицензирования. Чтобы модуль работал на дополнительном домене (псевдониме) укажите этот псевдоним на странице управления лицензиями. На один домен допускается указать до трех псевдонимов для нужд тестирования и разработки.
4. Главный домен лицензии вы можете менять самостоятельно на странице управления лицензиями. 

Для доступа к изменению/добавлению доменов и псевдонимов лицензии, подписка на обновления должна быть активной. Для изменения домена лицензии с истекшим периодом подписки, сначала необходимо продлить подписку на обновления. 

Версия 1.5.0 от 10 сентября 2026 года

• [+] Добавлен выбор способа подключения к Google Analytics 4: напрямую через Google-тег (gtag.js) или через Google Tag Manager, с подробными пояснениями в настройках модуля;
• [+] Добавлена совместимость с PHP 8.3;
• [!] Исправлена отправка событий при подключении через Google-тег (gtag.js): события могли не доходить до Google Analytics;
• [!] Исправлена точность событий корзины: при входе/выходе покупателя и служебных операциях могли отправляться лишние события удаления, а изменение количества товара учитывалось неверно;
• [!] Исправлена совместимость с кэшированием страниц: при включённом кэше события могли теряться или дублироваться;
• [*] События выбора доставки и оплаты теперь отправляются в момент выбора на оформлении заказа и не дублируются; просмотр списка товаров отправляется только когда список действительно показан посетителю; AJAX-обновления страниц больше не создают повторных событий;
• [*] Уточнён расчёт сумм в событиях: сумма заказа передаётся без доставки, доставка и налог — отдельными полями, как рекомендует Google Analytics;
• [*] Обновлено оформление служебных блоков модуля; базовые обновления безопасности модуля.

Версия 1.4.0 от 16 апреля 2026 года

• [+] Добавлены события выбранного способа оплаты и доставки;
• [*] Оптимизирован скрипт: предотвращено склеивание данных в dataLayer;
• [*] Базовые обновления безопасности модуля;
• [*] Добавлена совместимость с PHP 8.3;
• [!] Исправлено PHP предупреждение.

Версия 1.3.1 от 10 декабря 2025 года

• [!] Исправлена проблема передачи значения в формате числовых данных.

Версия 1.3.0 от 8 декабря 2025 года

• [*] Оптимизация кода для лучшего взаимодействия.

Версия 1.2.0 от 2 декабря 2025 года

• [!] Исправлена проблема настроек модуля на редакциях Ultimate;
• [*] Базовые обновления безопасности модуля.

Версия 1.1.1 от 14 февраля 2025 года

• [+] Добавлена возможность отправки e-mail и номера телефона пользователя.

Версия 1.1.0 от 9 сентября 2024 года

• [+] Добавлена возможность выбора типа интеграции кода.

Версия 1.0 от 5 сентября 2024 года

Это первый релиз модуля