Меню документації
Google Tag Manager
Шаблон CookieHug для Google Tag Manager: встановлення, тригер Consent Initialization, параметри, поведінка та дозволи шаблону.
Шаблон для Google Tag Manager
CookieHug пропонує офіційний власний шаблон для Google Tag Manager, за допомогою якого банер згоди та Google Consent Mode v2 можна впровадити повністю з GTM — без фрагмента в <head>. Його опубліковано в галереї шаблонів спільноти GTM (шукайте *CookieHug Consent Banner*), а вихідний код лежить в окремому публічному репозиторії: github.com/cookiehug-com/gtm-cookiehug.
Шаблон — це легкий універсальний завантажувач: кожен сайт вставляє власний ліцензійний ключ, тож той самий шаблон працює для будь-якого домену CookieHug. Він робить рівно дві речі — встановлює всі сигнали GCM v2 у denied *до* спрацювання будь-якого тега, а потім вставляє SDK CookieHug, який застосовує ваші регіональні типові значення й викликає updateConsentState, коли відвідувач робить вибір. Уся конфігурація банера (категорії, тексти, кольори, блокування) залишається в панелі CookieHug; шаблон — це конектор, а не місце налаштувань.
Коли його використовувати
Обирайте шаблон GTM замість фрагмента в <head>, якщо ви вже керуєте своїми аналітичними та рекламними тегами через Google Tag Manager і хочете мати єдине місце — Consent Initialization у GTM — де типові значення встановлюються ще до того, як будь-який тег перевірить свою згоду. Якщо ви не користуєтеся GTM, залиште стандартний фрагмент <script> або плагін для WordPress; не встановлюйте обидва варіанти, інакше типові значення буде задано двічі.
Встановлення
- З галереї (рекомендовано): GTM → Шаблони → Шаблони тегів → Пошук у галереї → знайдіть *CookieHug Consent Banner* → Додати до робочої області.
- Ручний імпорт (доки запис у галереї не опубліковано): завантажте `template.tpl`, потім у GTM відкрийте Шаблони → Шаблони тегів → Новий → ⋮ → Імпортувати і виберіть файл.
- Створіть тег: Теги → Новий → CookieHug Consent Banner.
- Прив'яжіть його до тригера Consent Initialization — All Pages. Це найраніший вбудований тригер GTM, який гарантує, що типові значення
deniedвстановлено до запуску будь-якого аналітичного чи рекламного тега. Не використовуйте Page View / All Pages / DOM Ready.
Параметри
| Параметр | Тип | Типове значення | Примітки |
|---|---|---|---|
licenseKey | TEXT | *обов'язковий* | Ключ вашого сайту з розділу Панель → Домен → Налаштування. |
region | SELECT | auto | Примусово задає регіон для типового стану згоди (EEA/GB/CH/US/US-CA/ROW). На продакшені залишайте auto. |
loadPosition | SELECT | async | async (швидко, без блокування) або defer (після розбору HTML). Обидва встановлюють типові значення раніше за інші теги. |
debugMode | CHECKBOX | false | Показує діагностичний значок CookieHug. Лише для контейнерів попереднього перегляду чи тестування — ніколи на продакшені. |
Що виконує шаблон
1. setDefaultConsentState({ ad_storage: 'denied', ad_user_data: 'denied', ad_personalization: 'denied', analytics_storage: 'denied', functionality_storage: 'denied', personalization_storage: 'denied', security_storage: 'granted', wait_for_update: 500 }) — не дає маркетинговим і аналітичним тегам спрацювати, доки згоду не оновлено.
2. injectScript('https://cookiehug.com/api/script/<licenseKey>.js') — завантажує SDK CookieHug, який замінює типові значення на відповідні регіону, показує банер за потреби й викликає updateConsentState, коли користувач натискає кнопку.
Якщо ви відхилите дозвіл inject_script у суворо обмеженому контейнері, тег акуратно викличе gtmOnFailure(): банер не завантажиться, але подальші теги залишаться заблокованими, бо типові значення й далі denied.
Запитувані дозволи
access_consent— читання і запис для кожного сигналу GCM v2 (ad_storage,ad_user_data,ad_personalization,analytics_storage,functionality_storage,personalization_storage,security_storage).inject_script— обмежено виключно адресоюhttps://cookiehug.com/api/script/*.logging— лише в середовищах налагодження.
Не поєднуйте його з фрагментом
І шаблон GTM, і фрагмент у <head> встановлюють типові значення Consent Mode. Використовуйте рівно одну інтеграцію на сайт. Якщо ви переносите сайт із фрагмента на шаблон GTM, спершу приберіть тег <script id="cookiehug"> з <head> — інакше другий виклик default із GTM може перезаписати регіональні значення CookieHug і зламати контроль для ЄЕЗ.