Перейти до основного вмісту

Події електронної торгівлі GA4

ECMS9 надсилає події електронної торгівлі Google Analytics 4 з ядра. Ви один раз вводите ідентифікатор потоку — далі магазин сам підвантажує Google-тег і звітує про перегляди товарів, зміни кошика, кроки оформлення й покупки на будь-якій темі вітрини — без правок теми, без окремого модуля, без налаштування Tag Manager.

Де ввести ідентифікатор​

Налаштування → Глобальні налаштування → Налаштування аналітики, поле «ID Google Analytics». Вставте Measurement ID формату G-XXXXXXXXXX (у GA4: Адміністратор → Потоки даних → ваш веб-потік).

Вкладка SEO з полем Google Analytics

  • Приймається лише коректний G-…; старий код Universal Analytics UA-… ігнорується, як і порожнє поле — без id немає ні тега, ні подій взагалі.
  • Прапорець «Використовувати Enhanced Ecommerce» поруч — спадок Universal Analytics і на події GA4 не впливає.
  • Якщо тема вже містить Google-тег або контейнер GTM (сторінка вже вантажить googletagmanager.com), ECMS9 не вставляє другий завантажувач, тож ніщо не рахується двічі — події просто йдуть у наявний тег.

Які події і де спрацьовують​

ПодіяСторінка / діяПараметри
view_item_listсторінка категоріїitem_list_id, item_list_name, items (з index)
view_itemкартка товаруcurrency, value, items (ціна першого варіанта)
add_to_cartдодавання товару в кошик (кнопка або посилання)items (item_id, quantity)
remove_from_cartвидалення з кошикаitems
searchвідправка форми пошуку по сайтуsearch_term
view_cart, begin_checkoutвідкриття кошика / сторінки оформленняcurrency, value, items
add_shipping_infoвибір способу доставкикошик + shipping_tier
add_payment_infoвибір способу оплатикошик + payment_type
purchaseсторінка «дякуємо», лише перший показtransaction_id, currency, value, shipping, items, shipping_tier, payment_type

Деталі, про які зазвичай питають власники:

  • Валюта передається як UAH.
  • shipping_tier — видима назва обраного способу доставки, як її бачить покупець. Для Нової Пошти дописується обрана послуга, тому відділення, поштомат і курʼєра видно окремо — наприклад Нова Пошта — Курʼєром. payment_type — видима назва способу оплати. Обидва надсилаються ще раз у purchase, тож дохід можна порівнювати за перевізником і способом оплати (у purchase tier — лише назва способу, без послуги Нової Пошти).
  • Зміна думки фіксується: інший спосіб доставки чи оплати надсилає подію знову з новою назвою; повторний вибір того самого — ні.
  • purchase надсилається рівно один раз — при першому показі сторінки підтвердження одразу після оформлення. Оновлення чи повторне відкриття цієї сторінки подію не повторює, тож транзакції не подвоюються.

Незалежно від теми​

Завантажувач Google-тега вставляється в <head>, а події — одним скриптом перед </body> конвеєром рендерингу ядра, тому їх отримує кожна тема — штатна чи власна — і вони переживають оновлення ядра. Слухач, що звітує про зміни кошика й вибір на оформленні, стежить за стандартними ендпоінтами кошика й стандартними полями deliveryMethodId / paymentMethodId форми оформлення.

Розробникам тем

Якщо тема малює способи доставки чи оплати незвичною розміткою, атрибут data-ga-label="…" на радіокнопці або селекті перебиває текст, узятий з лейбла, — і в GA4 піде саме та назва, яку ви хочете.

Як перевірити своїми руками​

  1. Відкрийте вітрину в браузері зі збереженим ідентифікатором, відкрийте консоль розробника і введіть dataLayer. Має бути виклик config з вашим G-… і далі події сторінки — view_item на картці товару, view_item_list на категорії.
  2. Додайте товар у кошик, відкрийте кошик, оберіть доставку й оплату — у dataLayer по ходу зʼявляться add_to_cart, begin_checkout, add_shipping_info (з shipping_tier) і add_payment_info (з payment_type).
  3. Оформіть тестове замовлення: сторінка підтвердження кладе purchase з номером замовлення в transaction_id. Читайте саме window.dataLayer, а не хук на gtag — завантажувач перевизначає gtag і сховає хук.
  4. У GA4 Адміністратор → DebugView показує ті самі події наживо, коли в браузері увімкнено розширення Google Analytics Debugger (або сторінку відкрито з ?debug_mode=1); стандартні звіти наздоганяють за день-два.
У dataLayer порожньо?

Перевірте по черзі: ідентифікатор збережено і він починається з G-; сторінка не віддається з кешу, зробленого до збереження (почистіть кеш сайту); блокувальник реклами не ріже googletagmanager.com у вашому браузері.