Використання
Встановлення
Для встановлення модуля Вам необхідно виконати такі кроки:
- Перейти на Маркетплейс та авторизуватися під обліковим записом власника замовлення
- Перейти в замовлення з модулем Google аналітика та інструменти просування, там Ви зможете побачити посилання для скачування архіву модуля
- Зробити установку завантаженого архіву у своєму магазині (стандартна для CS-Cart установка: Модулі → Управління модулями, в меню шестерні виберіть Ручна установка, завантажте архів у вікні і натисніть кнопку Встановити).
Налаштування
Надсилати події
To dataLayer — використовується для надсилання подій та даних до Google Tag Manager, для цього використовується GTM, зазначений у полі «Ідентифікатор контейнера Google Tag Manager».
Directly to Google Analytics — використовується для надсилання подій безпосередньо до сервісів Google (наприклад, GA4 або Google Ads), використовуючи ідентифікатор з поля «Ідентифікатор вимірювання Google Analytics».
1. Ідентифікатор контейнера менеджера тегів
Вкажіть у цьому полі Ідентифікатор контейнера менеджера тегів. Надалі це значення використовуватиметься для ініціалізації GTM.
Ви можете отримати тег у Менеджері тегів. Якщо у Вас виникли питання, як це зробити, то Ви можете скористатися даною статтею.
2. Ідентифікатор відстеження Google Аналітики
Вкажіть у цьому полі Ідентифікатор відстеження Google Аналітики. Надалі це значення використовуватиметься для ініціалізації Global site tag.
Ви можете отримати ID у кабінеті Analytics. Якщо у Вас виникли питання, як це зробити, Ви можете скористатися даною статтею.
3. Використовувати як ідентифікатор товару
Налаштування визначає, яке поле товару буде використано для передачі в аналітику як ідентифікатор товару. Поле зобов'язано бути унікальним.
Ви також можете додати нові поля для використання як ID товару скориставшись PHP-хуком:
/**
* Add custom field as product ID
*
* @param array $offer_id_fields
*/
fn_set_hook('mc__google_analytics_product_id_field_post', $offer_id_fields);
4. Надсилати в аналітику перегляди сторінок (page_view)
За замовчуванням скрипт надсилає перегляди сторінок до аналітики. Якщо цей параметр вимкнено, параметр send_page_view буде виставлений у значення false
5. Hotjar Tracking код
Код використовується для Hotjar Tracking. Вставте весь код без тега <script>
6. ID клієнта (Client ID)
Дане налаштування зберігає ID OAuth клієнта. Зазвичай ID має вигляд: XXXXXXXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXX.apps.googleusercontent.com
7. Секрет клієнта (Client secret)
Це налаштування зберігає Secret (секрет) OAuth клієнта. Зазвичай Secret має вигляд: XXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXX
У графі
Authorized redirect URIs Вам так само необхідно вказати дозволений редирект на http(s)://your-storefront.domain/index .php?dispatch=mc__google_analytics.oauth_response. Зверніть увагу, що для кожної вітрини Вам необхідно буде додати окремий Redirect URI8. Кнопка «Запустить авторизацию»
Ця кнопка буде доступна лише після того, як Ви заповните значення в полях «ID клієнта» та «Секрет клієнта».
Вам необхідно хоча б раз пройти авторизацію через OAuth. Надалі токен оновлюватиметься автоматично. Будь ласка, авторизуйтесь через обліковий запис власника веб-ресурсу (сайту).
9. Налаштування API індексації
У даній секції налаштувань Ви можете вказати чи потрібно відправляти сторінку на індексацію при певних діях (створення та/або оновлення) з сутностями сайту (товари/категорії/сторінки).
Так само слід зазначити, що при видалення товару буде надіслано запит на видалення сторінки з індексу.
Режим debug
Увімкнути debug параметри та логування в консоль – додати debug_mode = true до даних подій measurement protocol (для перегляду подій під час налагодження через Tag Assistant) та логувати події в консолі браузера.
Серверний GTM
Використовувати Серверний Контейнер GTM - Так або Ні
Адреса серверного контейнера GTM - Для коректної роботи self-hosted контейнера GTM на вашому домені необхідний SSL-сертифікат. Якщо ви використовуєте сервер від GCP, сертифікат встановлюється автоматично – турбуватися про це не потрібно.