Власні тригери
Власні тригери - це опціональний модуль, який дозволяє надсилати власні події до шару даних window.dataLayer (того самого, який використовує модуль GA4 DataLayer), коли виконується проста умова на фронті магазину. Завдяки цьому ви можете моделювати події, специфічні для вашого магазину, наприклад відвідини конкретної сторінки або клік певної кнопки, без написання власного коду JavaScript.
Кожен тригер надсилає іменовану подію (з опціональними додатковими параметрами), яка потрапляє до того самого шару даних, що й події GA4. Подальша обробка (наприклад, передача до Google Tag Manager, Meta Pixel, TikTok чи Matomo) залежить від вашої конфігурації тегів. Це інструменти, які допомагають моделювати власні події, а не гарантія конкретного правового чи аналітичного ефекту.
Увімкнення модуля
Section titled “Увімкнення модуля”Модуль за замовчуванням вимкнений. Увімкніть його в WooCommerce > Polski > Модулі (ключ модуля custom_triggers). Після увімкнення і визначення щонайменше одного коректного тригера модуль завантажує легкий контролер на фронті магазину. Якщо список тригерів порожній, жоден скрипт не додається. Контролер не працює в адмін-панелі.
Як працюють тригери
Section titled “Як працюють тригери”Тригер оцінюється у браузері відвідувача. Доступні два типи умов:
| Умова | Що запускає подію |
|---|---|
page_url | Поточний шлях або параметри URL містять вказаний фрагмент тексту. |
click | Клік елемента, що відповідає вказаному CSS-селектору. |
Кожен тригер мусить мати встановлену назву події, інакше він пропускається. Якщо тип умови не встановлений на click, модуль трактує його як page_url.
Налаштування тригера
Section titled “Налаштування тригера”Кожен рядок у списку тригерів описують такі поля:
| Поле | Опис |
|---|---|
| Подія | Назва події, що надсилається до dataLayer. Поле обов’язкове, порожні тригери пропускаються. |
| Умова | page_url або click. За замовчуванням page_url. |
| Значення | Фрагмент тексту, що порівнюється зі шляхом/параметрами URL (для умови page_url). |
| Селектор | CSS-селектор елемента, клік якого запускає подію (для умови click). |
| Категорія | Категорія згоди, що обумовлює надсилання події. За замовчуванням necessary (необхідні). |
| Параметри | Опціональні додаткові параметри події (пари ключ-значення, лише скалярні значення). |
Список тригерів зберігається як закодовані в JSON дані в опції polski_custom_triggers (ключ triggers). Лише скалярні значення зберігаються як параметри, решта відкидаються.
Обумовлення згодою
Section titled “Обумовлення згодою”Надсилання даних до шару dataLayer є first-party дією, проте кожному тригеру можна призначити категорію згоди. Контролер на фронті надсилає тригер із призначеною категорією лише тоді, коли відвідувач надав згоду на цю категорію (збережену у файлі cookie згоди). Тригери в категорії necessary (необхідні) надсилаються завжди.
Контролер повторно перевіряє стан згоди після події polskiConsentChange, тож зміна рішення відвідувача (наприклад, прийняття маркетингу в банері) враховується без перезавантаження сторінки. Завдяки цьому ви можете, наприклад, пов’язати маркетингову подію конверсії з маркетинговою згодою.
Якщо призначена категорія не є коректною категорією згоди, модуль відкочує її до necessary. Назви cookie, події та необхідної категорії контролер бере з модуля Менеджера згод, тож обумовлення згодою працює узгоджено з банером згоди.
Модуль надає інструменти для обумовлення подій згодою, проте не є юридичною консультацією і не гарантує відповідності законодавству. За правильну класифікацію подій відносно категорій згоди відповідає власник магазину.
Інтеграція з шаром даних
Section titled “Інтеграція з шаром даних”Тригери користуються тим самим шаром window.dataLayer, що й модуль GA4 DataLayer. Щоб події приймалися і далі оброблялися, цей шар даних мусить існувати на сторінці. Сам модуль лише надсилає події до шару, а про їхню подальшу долю вирішує ваша конфігурація тегів та аналітичних інструментів.
Усунення проблем
Section titled “Усунення проблем”Події не з’являються в dataLayer - переконайтеся, що модуль увімкнений, визначено щонайменше один тригер із назвою події і що на сторінці існує шар window.dataLayer (модуль GA4 DataLayer).
Тригер click не реагує - перевірте CSS-селектор. Він мусить відповідати наявному елементу на сторінці.
Тригер із категорією, відмінною від необхідної, не працює - подія буде надіслана лише після надання згоди на призначену категорію. Перевірте конфігурацію Менеджера згод і рішення відвідувача.
Повідомлення про проблеми: github.com/wppoland/polski/issues