Опис
MC: Google аналітика та інструменти просування — це модуль від команди Maxi Cart для платформи CS-Cart (всіх редакцій) та MultiVendor (всіх редакцій) 4.10.1 - 4.18.3.
Модуль включає всі необхідні Вам технічні інструменти для роботи сайту з Google сервісами аналітики, реклами, а також полегшить Вам просування сайту в пошуковій видачі
Модуль включає:
- Можливість інтегрувати в сайт Google Tag Manager (менеджер тегів Google)
- Повну інтеграцію з Google Analytic (версія аналітики GA4)
- Інтеграцію з сервісом Hotjat Tracking
- Інтеграцію з Google Indexing API (АПІ Google індексації, яке дозволить нових та/або оновленим сторінкам Вашого сайту індексуватися швидше)
- Модуль дозволить Вам відправити пакетно до двохсот (200) посилань на день на індексацію. Вам потрібно буде лише підготувати файл CSV зі списком посилань
Список подій, які відслідковуються аналітикою:
- view_item_list — Перегляд списку товарів
- select_content — Клік за назвою товару (перехід за посиланням на елементі назви) у списках
- view_item — Перехід на сторінку товару
- add_to_cart — Додавання товару до кошика
- remove_from_cart — Видалення товару з корзини
- begin_checkout — Перехід на сторінку оформлення замовлення (чекаут)
- set_checkout_option — Вибір способу доставки/методу оплати
- purchase — Замовлення оформлене (подія покупки)
- view_promotion — Перехід на сторінку промо-акції (залежить від модуля «AB: Розширені промоакції» або його аналогів)
- add_to_wishlist — Товар доданий до списку бажаних (wishlist, залежить від відповідного модуля)
- login — Користувач авторизувався на сайті
- sign_up — Користувач зареєструвався на сайті
- login — Користувач авторизувався на сайті
- search — Відвідування сторінки з результатами пошуку на сайті
- view_cart — Перехід на сторінку корзини
- select_item - Клік по картці товару у списках товарів
- generate_lead - При надсиланні форми зворотнього дзвінка
- add_shipping_info - Вибір способу доставки при оформлені замовлення
- add_payment_info - Вибір способу оплати при оформлені замовлення
Технічна підтримка
Загальні умови технічної підтримки доступні за цим посиланням (обов'язково ознайомтеся з цими умовами, всі рішення від команди розробників MaxiCart надаються з обмеженою технічною підтримкою).
Зверніть увагу, що за відповідь на запитання, яке вже описано в документації, спеціаліст підтримки має право списати з вас бали.
Використання
Встановлення
Для встановлення модуля Вам необхідно виконати такі кроки:
- Перейти на Маркетплейс та авторизуватися під обліковим записом власника замовлення
- Перейти в замовлення з модулем 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, сертифікат встановлюється автоматично – турбуватися про це не потрібно.
Робота з вбудованим функціоналом
У цьому розділі представлена інформація виключно за функціями, які додає «Google аналітика та інструменти просування».
Ми настійно рекомендуємо Вам ознайомитись з документацією з використання CS-Cart перед тим як приступати працювати з модулем.
Google Analytic
Список подій, які підтримує модуль, визначений в описі.
Ви можете відстежити всі події, що відправляються в аналітику, і дані перейшовши на сторінку вказавши в URL додатковий параметр mc__ga_dev, наприклад:
http://website.com/product.html?mc__ga_dev
або
http://website.com/product.html?some_param=true&mc__ga_dev
У такому випадку всі дані будуть відображені в консолі браузера. Натисніть Ctrl + Shift + J (або Cmd + Shift + J на MacOS) для відображення консолі.
Indexing API
Модуль надає набір інструментів, які допоможуть Вам отримати швидше індексацію Ваших сторінок Google ботами/краулерами.
Сторінка індексації
У функціонал модуля входить сторінка, яка дозволить Вам відправити відразу набір посилань на індексацію
Ця сторінка стане доступною для переходу відразу після первинного проходження OAuth авторизації на сторінці налаштувань модуля.
На цій сторінці Вам буде доступна дія «Індексувати файл». Вам потрібно лише підготувати файл CSV і «годувати» його на індексацію.
Часто задавані питання
invalid_grant. Token has been expired or revoked.
Помилка говорить про те, що токен, яким ми підписуємо запит, втратив свою актуальність. Необхідно знову пройти процедуру OAuth.
Request had invalid authentication credentials.
Помилка говорить про те, що токен, яким ми підписуємо запит, втратив свою актуальність. Необхідно знову пройти процедуру OAuth.