Меню документації

Налаштування сервісів Google

Налаштування на боці Google для Consent Mode v2: GA4, Google Ads, GTM і наскрізна перевірка разом із CookieHug.

Партнер Google CMP — вимоги до банера (Sprint 5)

CookieHug створено так, щоб відповідати вимогам до банера у партнерській програмі Google CMP. Цей розділ зіставляє кожну вимогу Google з функцією, яка її виконує, щоб клієнти, які подаються на сертифікацію, могли вказати конкретну реалізацію. Джерело: розширений посібник Google щодо Consent Mode v2 — developers.google.com/tag-platform/security/guides/consent?consentmode=advanced.

Вимога 1 — банер повністю налаштовується з інтерфейсу

Увесь банер налаштовується без жодного рядка коду. Панель адміністратора (деталі домену) відкриває кожну властивість банера через елементи інтерфейсу — жодне поле не потребує коду, файлів конфігурації чи звернень до API.

Вкладка / розділ інтерфейсуНалаштування
Тексти банераЗаголовок, опис, дрібний текст, підписи кнопок «прийняти»/«відхилити»/«прийняти вибране», текст посилання на категорії
МакетРозташування (ліворуч/праворуч/внизу по центру/по центру), радіус кутів, вирівнювання тексту, Google Font, необов'язкова іконка cookie (емодзі/SVG), розміщення кнопки категорій
КольориТло банера, заголовок, опис, посилання, дрібний текст, кнопки «прийняти»/«відхилити»/«категорії» (тло/текст/наведення/рамка)
КатегоріїУвімкнення/вимкнення 4 категорій, підписи та описи для кожної, перелік cookie
Google Consent ModeПеремикачі Ads/GA4/поза CMP, типові значення 4 сигналів GCM v2, регіональні значення (ЄЕЗ/US-CA/ROW/власні), відповідність категорія→сигнал, перемикач шаблону, сумісного з CMP
Політика згодиМодель згоди (opt-in / opt-out / лише повідомлення), обробка GPC / DNT, адаптер USP (US Privacy), вигляд після згоди
ДіагностикаУвімкнення Debug Mode, приймання діагностичних звітів від клієнта

Вимога 2 — шаблон банера, що відповідає вимогам Google

CookieHug постачає шаблон, сумісний із Google CMP, який клієнт вмикає одним перемикачем: Деталі домену → Google Consent Mode → Сертифікація Google CMP → перемикач увімкнено. Коли він активний, банер виконує всі три підвимоги:

(a) Мета збору даних. Типовий опис пояснює, що cookie використовуються для персоналізації вмісту й аналізу трафіку. Клієнт може розширити текст з інтерфейсу — поле вільне, тож можна додати цілі, специфічні для продукту (напр. «вимірювання ефективності реклами через Google»). Розгортні картки категорій, доступні за посиланням Налаштувати параметри cookie, перелічують докладні цілі кожної категорії.

(b) Посилання на https://business.safety.google/privacy. Виводиться в банері як <a> одразу під абзацом з описом. Воно видиме вже в першому вигляді банера — користувачеві не потрібно кудись переходити чи відкривати іншу сторінку. Використовує target="_blank" rel="noopener noreferrer".

(c) Варіант ствердної згоди. Банер завжди показує окрему кнопку Прийняти все як явну згоду, не позначену заздалегідь. Усі сигнали GCM v2 стартують зі стану "denied" і переходять у "granted" лише після натискання «прийняти» — жодних попередньо поставлених позначок, жодної згоди «за замовчуванням» через прокручування, а кнопка відмови має ту саму візуальну вагу в кожному пресеті.

Вимога 3 — рекомендація шаблону в інтерфейсі

Коли клієнт вмикає Google Consent Mode (перемикачами Google Ads підключено або Google Analytics 4 підключено), але ще не активував шаблон CMP, інтерфейс показує рекомендацію вгорі розділу Google Consent Mode:

> Рекомендовано: увімкніть шаблон Google CMP > Consent Mode v2 активний, але у вашому банері немає обов'язкового посилання на політику приватності Google. Увімкніть шаблон CMP, щоб банер відповідав вимогам партнерської програми Google CMP. > [Увімкнути шаблон] • [Документація Google Consent Mode]

Рекомендація містить кнопку ввімкнення одним кліком і посилання на розширений посібник Google. Вона зникає автоматично, щойно шаблон активовано. CookieHug не підтримує IAB TCF — тож ця рекомендація стосується всіх упроваджень Consent Mode через платформу.

Налаштування на боці Google — огляд

gtag('consent','default', …) і gtag('consent','update', …) CookieHug бере на себе автоматично — фрагмент, який ви вставляєте в <head>, надсилає обидва. Проте три речі все одно потрібно налаштувати на боці Google, щоб Consent Mode v2 advanced працював від початку до кінця. Повна довідка: developers.google.com/tag-platform/security/guides/consent?consentmode=advanced.

Google, крок 1 — ресурс GA4

  • Відкрийте ресурс GA4 → Адміністратор → Збір і зміна даних → Збір даних.
  • У картці Consent Mode переконайтеся, що Consent Mode увімкнено. Окремого перемикача «advanced» для ресурсу немає — режим *advanced* визначається на рівні тега тим, чи ad_storage і analytics_storage встановлені в denied до спрацювання тега (саме це робить CookieHug).
  • Залиште Сигнали Google і сигнали персоналізації реклами налаштованими відповідно до вашої політики згоди — вони враховуватимуть сигнали ad_user_data і ad_personalization, які CookieHug виводить із категорії «Маркетинг».
  • Зачекайте 24–48 годин після перших погоджень, а потім відкрийте Адміністратор → Налаштування ресурсу → Діагностика Consent Mode (внутрішня панель Google). Там має бути видно, що режим advanced розпізнано, і здорове співвідношення consent_update до consent_default.

Google, крок 2 — Google Ads

  • У Google Ads → Інструменти → Менеджер даних → Налаштування згоди (або Адміністратор → Згода в новому інтерфейсі): увімкніть Consent Mode для облікового запису.
  • Для кожної дії-конверсії Google почне застосовувати поведінкове моделювання, коли обліковий запис матиме достатньо трафіку зі згодою (зазвичай понад 1000 кліків по рекламі за 7 днів на країну). До досягнення порогу діагностичні повідомлення можуть показувати «Consent Mode не повністю активний» — це поріг даних на боці Google, а не помилка налаштування CookieHug.
  • Перевірте в Інструменти → Конверсії → Діагностика. Лічильники redacted_data та пінгів consent_default/consent_update мають бути більші за 0.

Google, крок 3 — Google Tag Manager

Важливо: не додавайте тег «Consent Initialization — All Pages», який теж викликає gtag('consent','default', …). Фрагмент CookieHug виконується *до* завантаження GTM (завдяки пріоритету в <head>), тож типові значення вже встановлено. Другий виклик default із GTM перезаписує регіональні значення CookieHug і ламає контроль для ЄЕЗ.

  • У GTM завантажуйте свої теги (GA4, Ads, Floodlight тощо) як завжди — вони прочитають стан згоди, який CookieHug уже надіслав.
  • Для кожного тега, що має враховувати Consent Mode, відкрийте Додаткові налаштування → Налаштування згоди і додайте потрібні типи згоди (напр. ad_storage, analytics_storage). Тоді GTM блокуватиме запис cookie чи пікселів, коли сигнал має значення denied, і виконуватиме тег у скороченому вигляді в режимі advanced.
  • Якщо ви використовуєте тег Google (gtag.js) напряму (без GTM), нічого додаткового не потрібно — фрагмент CookieHug виконується перед завантажувачем gtag.

Google, крок 4 — наскрізна перевірка

  • Установіть Google Tag Assistant (розширення для Chrome) → увімкніть його → перезавантажте свій домен у новому профілі. На вкладці Summary мають бути дві події consent: одна default (до прийняття банера) з analytics_storage=denied / ad_storage=denied і одна update (після прийняття) з відповідними сигналами granted.
  • Відкрийте GA4 → Адміністратор → DebugView. Якщо Debug Mode CookieHug вимкнено на продакшені, скористайтеся адресою з ?gtm_debug=1 або увімкніть режим налагодження в попередньому перегляді GTM, щоб бачити стан згоди в кожній події.
  • На вкладці Діагностика в Google Ads зачекайте до 24 годин і переконайтеся, що позначка статус Consent Mode стала зеленою.

Як перевірити впроваджений банер

  • Увімкніть шаблон в інтерфейсі адміністратора.
  • Згенеруйте скрипт домену заново у вікні Отримати скрипт — новий HTML банера почне діяти з наступним завантаженням сторінки.
  • Відкрийте потрібний домен і банер. Ви маєте побачити заголовок, опис, вбудоване посилання *Дізнайтеся, як Google захищає ваші дані*, що веде на https://business.safety.google/privacy, і кнопки *Прийняти все / Відхилити все* однакової помітності.
  • Відкрийте DevTools → Network → фільтр google. До прийняття теги GA/Ads мають спрацьовувати зі згодою denied; після натискання «прийняти» ви маєте побачити, як gtag('consent','update') переводить чотири сигнали в granted згідно з вашою відповідністю категорій.