Menu dokumentacji
Reguły regionalne (geo-IP)
Model zgody dobierany według lokalizacji odwiedzającego: regiony EOG/GB/CH/USA/Kalifornia/Brazylia, źródło geo, cache i fallbacki.
Reguły regionalne (geo-IP)
Zamiast jednego modelu zgody dla całego świata możesz dobrać model do lokalizacji odwiedzającego: opt-in tam, gdzie wymaga tego prawo (EOG), a opt-out lub notice-only tam, gdzie jest to dopuszczalne (np. część USA). Funkcja jest domyślnie wyłączona — bez niej obowiązuje pojedynczy model ustawiony dla domeny.
Regiony i kolejność rozstrzygania
| Region | Obejmuje | Fallback gdy brak reguły |
|---|---|---|
| EOG | 27 państw UE + Norwegia, Islandia, Liechtenstein | Reszta świata → model domeny |
| Wielka Brytania | GB | reguła EOG → Reszta świata → model domeny |
| Szwajcaria | CH | reguła EOG → Reszta świata → model domeny |
| USA (poza Kalifornią) | US bez stanu CA | Reszta świata → model domeny |
| USA — Kalifornia | US, stan CA | reguła USA → Reszta świata → model domeny |
| Brazylia | BR (LGPD) | Reszta świata → model domeny |
| Reszta świata | wszystkie pozostałe kraje | model domeny |
Dla każdego regionu wybierasz opt-in, opt-out albo notice-only — lub zostawiasz „model domeny”. Wybrany model działa dokładnie tak jak globalny: steruje domyślnym stanem przełączników kategorii i zachowaniem banera.
Skąd baner zna lokalizację
Gdy reguły są włączone, SDK pyta raz na dobę endpoint /api/geo, który odczytuje kraj (i region w USA) z nagłówków sieci CDN po stronie serwera CookieHug. Adres IP odwiedzającego nie jest nigdzie zapisywany — odpowiedź to wyłącznie kod kraju i regionu, cachowana przez 24 h w przeglądarce odwiedzającego.
Zabezpieczenia:
- Twardy limit 800 ms — jeśli geo nie odpowie na czas, baner startuje bez opóźnienia.
- Gdy geo jest niedostępne, SDK używa strefy czasowej przeglądarki jako przybliżenia (EOG / Kalifornia / Brazylia).
- Gdy lokalizacji nie da się ustalić wcale — obowiązuje model domeny (bezpieczny fallback).
- Domeny z wyłączonymi regułami nie wykonują żadnego dodatkowego zapytania.
Włączenie
- Panel → domena → Zaawansowane → Polityka zgody → karta Reguły regionalne (geo-IP).
- Włącz przełącznik i przypisz modele wybranym regionom; pozostałe zostaw jako „model domeny”.
- Zapis jest automatyczny; skrypt banera odświeży się w ciągu ~5 minut.
A co z Google Consent Mode?
Reguły regionalne sterują modelem zgody banera. Sygnały Google Consent Mode startują nadal konserwatywnie jako denied i zmieniają się dopiero po decyzji odwiedzającego — regionalne defaulty GCM to osobna konfiguracja w sekcji Google (Consent Mode v2). Obiekt `CookieHug.regulations` dostaje przy włączonym geo dokładniejsze wartości (gdprApplies, ccpaApplies, region).