Menu della documentazione
Regole regionali (geo-IP)
Modello di consenso in base alla posizione del visitatore: aree SEE/Regno Unito/Svizzera/USA/California/Brasile, fonte geo, cache e fallback.
Regole regionali (geo-IP)
Anziché un unico modello di consenso per tutto il mondo, puoi adattare il modello alla posizione del visitatore: opt-in dove la legge lo impone (il SEE) e opt-out o solo informativa dove è consentito (es. alcune parti degli USA). La funzione è disattivata per impostazione predefinita: senza di essa vale l'unico modello configurato per il dominio.
Aree e ordine di risoluzione
| Area | Comprende | Fallback senza regola |
|---|---|---|
| SEE | 27 paesi UE + Norvegia, Islanda, Liechtenstein | Resto del mondo → modello del dominio |
| Regno Unito | GB | Regola SEE → resto del mondo → modello del dominio |
| Svizzera | CH | Regola SEE → resto del mondo → modello del dominio |
| USA (fuori dalla California) | US tranne CA | Resto del mondo → modello del dominio |
| USA — California | US, stato CA | Regola USA → resto del mondo → modello del dominio |
| Brasile | BR (LGPD) | Resto del mondo → modello del dominio |
| Resto del mondo | tutti gli altri paesi | modello del dominio |
Per ogni area scegli opt-in, opt-out o solo informativa, oppure lasci «modello del dominio». Il modello scelto si comporta esattamente come quello globale: determina lo stato iniziale degli interruttori di categoria e il comportamento del banner.
Come fa il banner a conoscere la posizione
Con le regole attive, l'SDK interroga l'endpoint /api/geo una volta al giorno; l'endpoint legge il paese (e lo stato USA) dagli header di rete del CDN, lato server CookieHug. L'indirizzo IP del visitatore non viene mai memorizzato: la risposta contiene solo un codice paese e un codice area, in cache per 24 ore nel browser del visitatore.
Tutele:
- Un timeout rigido di 800 ms: se la geolocalizzazione non risponde in tempo, il banner parte senza ritardi.
- Quando la geolocalizzazione non è disponibile, l'SDK ripiega sul fuso orario del browser come approssimazione (SEE / California / Brasile).
- Quando la posizione non è determinabile affatto, vale il modello del dominio (fallback sicuro).
- I domini con la funzione disattivata non effettuano alcuna richiesta aggiuntiva.
Attivazione
- Dashboard → dominio → Avanzate → Politica di consenso → scheda Regole regionali (geo-IP).
- Sposta l'interruttore e assegna i modelli alle aree che ti servono; lascia il resto su «modello del dominio».
- Il salvataggio è automatico; lo script del banner si aggiorna entro circa 5 minuti.
E Google Consent Mode?
Le regole regionali governano il modello di consenso del banner. I segnali di Google Consent Mode continuano a partire in modo prudente da denied e cambiano solo dopo la decisione del visitatore: i valori predefiniti regionali di GCM sono una configurazione separata, nella sezione Google (Consent Mode v2). Con la geolocalizzazione attiva, l'oggetto `CookieHug.regulations` contiene valori più precisi (gdprApplies, ccpaApplies, region).