Menú de documentación
Reglas regionales (geo-IP)
Modelo de consentimiento según la ubicación del visitante: regiones EEE/Reino Unido/Suiza/EE. UU./California/Brasil, fuente de geolocalización, caché y alternativas.
Reglas regionales (geo-IP)
En lugar de un único modelo de consentimiento para todo el mundo, puedes ajustar el modelo a la ubicación del visitante: opt-in donde la ley lo exige (el EEE) y opt-out o solo aviso donde está permitido (p. ej. partes de EE. UU.). La función está desactivada por defecto: sin ella se aplica el único modelo configurado para el dominio.
Regiones y orden de resolución
| Región | Incluye | Alternativa si no hay regla |
|---|---|---|
| EEE | 27 países de la UE + Noruega, Islandia, Liechtenstein | Resto del mundo → modelo del dominio |
| Reino Unido | GB | Regla del EEE → resto del mundo → modelo del dominio |
| Suiza | CH | Regla del EEE → resto del mundo → modelo del dominio |
| EE. UU. (fuera de California) | US excepto CA | Resto del mundo → modelo del dominio |
| EE. UU. — California | US, estado CA | Regla de EE. UU. → resto del mundo → modelo del dominio |
| Brasil | BR (LGPD) | Resto del mundo → modelo del dominio |
| Resto del mundo | todos los demás países | modelo del dominio |
Para cada región eliges opt-in, opt-out o solo aviso, o dejas «modelo del dominio». El modelo elegido se comporta exactamente igual que el global: determina el estado inicial de los interruptores de categoría y el comportamiento del banner.
Cómo conoce el banner la ubicación
Con las reglas activadas, el SDK consulta el endpoint /api/geo una vez al día; ese endpoint lee el país (y el estado de EE. UU.) de las cabeceras de red del CDN en el servidor de CookieHug. La dirección IP del visitante nunca se almacena: la respuesta solo contiene un código de país y de región, y se guarda 24 h en el navegador del visitante.
Salvaguardas:
- Un tiempo de espera estricto de 800 ms: si la geolocalización no responde a tiempo, el banner arranca sin retraso.
- Cuando la geolocalización no está disponible, el SDK recurre a la zona horaria del navegador como aproximación (EEE / California / Brasil).
- Cuando la ubicación no se puede determinar en absoluto, se aplica el modelo del dominio (alternativa segura).
- Los dominios con la función desactivada no realizan ninguna petición adicional.
Activación
- Panel → dominio → Avanzado → Política de consentimiento → tarjeta Reglas regionales (geo-IP).
- Activa el interruptor y asigna modelos a las regiones que necesites; deja el resto en «modelo del dominio».
- El guardado es automático; el script del banner se actualiza en unos 5 minutos.
¿Y qué pasa con Google Consent Mode?
Las reglas regionales controlan el modelo de consentimiento del banner. Las señales de Google Consent Mode siguen arrancando de forma conservadora en denied y solo cambian tras la decisión del visitante: los valores regionales de GCM son una configuración aparte en la sección de Google (Consent Mode v2). Con la geolocalización activada, el objeto `CookieHug.regulations` contiene valores más precisos (gdprApplies, ccpaApplies, region).