Меню документації
Регіональні правила (geo-IP)
Модель згоди за місцеперебуванням відвідувача: регіони ЄЕЗ/Велика Британія/Швейцарія/США/Каліфорнія/Бразилія, джерело geo, кеш і запасні варіанти.
Регіональні правила (geo-IP)
Замість однієї моделі згоди для всього світу можна підібрати модель під місцеперебування відвідувача: opt-in там, де цього вимагає закон (ЄЕЗ), і opt-out чи лише повідомлення там, де це дозволено (напр. частина США). Функцію типово вимкнено — без неї діє одна модель, налаштована для домену.
Регіони й порядок визначення
| Регіон | Охоплює | Запасний варіант без правила |
|---|---|---|
| ЄЕЗ | 27 країн ЄС + Норвегія, Ісландія, Ліхтенштейн | Решта світу → модель домену |
| Велика Британія | GB | Правило ЄЕЗ → решта світу → модель домену |
| Швейцарія | CH | Правило ЄЕЗ → решта світу → модель домену |
| США (поза Каліфорнією) | US, крім CA | Решта світу → модель домену |
| США — Каліфорнія | US, штат CA | Правило США → решта світу → модель домену |
| Бразилія | BR (LGPD) | Решта світу → модель домену |
| Решта світу | усі інші країни | модель домену |
Для кожного регіону ви обираєте opt-in, opt-out або лише повідомлення — чи залишаєте «модель домену». Обрана модель поводиться так само, як глобальна: визначає початковий стан перемикачів категорій і поведінку банера.
Звідки банер знає місцеперебування
З увімкненими правилами SDK раз на добу звертається до ендпойнта /api/geo; той на боці сервера CookieHug зчитує країну (і штат США) з мережевих заголовків CDN. IP-адреса відвідувача ніколи не зберігається — відповідь містить лише код країни та регіону й кешується на 24 години в браузері відвідувача.
Запобіжники:
- Жорсткий тайм-аут 800 мс — якщо геозапит не відповідає вчасно, банер стартує без затримки.
- Коли геозапит недоступний, SDK використовує часовий пояс браузера як наближення (ЄЕЗ / Каліфорнія / Бразилія).
- Коли місцеперебування визначити неможливо взагалі — діє модель домену (безпечний запасний варіант).
- Домени з вимкненою функцією не надсилають жодного додаткового запиту.
Увімкнення
- Панель → домен → Розширені → Політика згоди → картка Регіональні правила (geo-IP).
- Увімкніть перемикач і призначте моделі потрібним регіонам; решту залиште як «модель домену».
- Збереження автоматичне; скрипт банера оновиться протягом приблизно 5 хвилин.
А як щодо Google Consent Mode?
Регіональні правила керують моделлю згоди в банері. Сигнали Google Consent Mode так само стартують обережно зі стану denied і змінюються лише після рішення відвідувача — регіональні типові значення GCM налаштовуються окремо, у розділі Google (Consent Mode v2). З увімкненим geo об'єкт `CookieHug.regulations` містить точніші значення (gdprApplies, ccpaApplies, region).