Saltar al contenido

Idioma

Menú de la documentación

Reglas de geolocalización

Muestra a cada visitante el consentimiento que exige su ley: cómo detecta Cookiesh la región sin guardar IP, las reglas por defecto y cómo adaptarlas.

Última actualización: 29 de octubre de 2026

Las leyes de privacidad cambian de una jurisdicción a otra. Los visitantes de la UE necesitan un banner opt-in antes de que empiece cualquier seguimiento, los de California necesitan una forma de excluirse de la venta y el intercambio de sus datos, y muchos otros solo necesitan un aviso. Las reglas de geolocalización permiten hacer todo esto con una sola instalación. La geolocalización está incluida en los planes Pro y Enterprise.

Cómo se detecta la región

Cuando se carga el script de Cookiesh, nuestra red en el edge obtiene a partir de la conexión el país del visitante y, en el caso de Estados Unidos, Canadá y Brasil, también su estado o provincia. Al script solo le llega el código de región resultante, como FR o US-CA. La dirección IP nunca se guarda ni se escribe en un registro de consentimiento.

La región se guarda con cada registro de consentimiento, para que puedas demostrar qué regla se aplicó cuando el visitante tomó su decisión.

Reglas por defecto

Los sitios nuevos empiezan con estas reglas. Se evalúan de arriba abajo y se aplica la primera que coincide:

Región Códigos Modo Valor por defecto de Consent Mode v2
UE y EEE EU, EEA Opt-in Todas las señales denied
Reino Unido GB Opt-in Todas las señales denied
Suiza CH Opt-in Todas las señales denied
Brasil BR Opt-in Todas las señales denied
California US-CA Opt-out, respeta GPC granted; señales publicitarias denied con GPC
Resto del mundo * Aviso Todas las señales granted

Los tres modos funcionan así:

  • Opt-in. Las categorías no esenciales siguen bloqueadas hasta que el visitante las acepta. La primera capa muestra Aceptar todas, Rechazar todas y Personalizar.
  • Opt-out. Las categorías están permitidas por defecto. Los visitantes pueden excluirse de marketing (venta e intercambio) con un clic, y una señal de Global Privacy Control los excluye automáticamente.
  • Aviso. Las categorías están permitidas. Un aviso breve enlaza a tu política de cookies y al centro de preferencias.

Reglas personalizadas

En Banners → Geo-targeting, haz clic en Add rule y elige:

  1. Regiones. Países (ISO 3166-1, como DE), estados y provincias (ISO 3166-2, como US-CO) o grupos (EU, EEA).
  2. Modo. Opt-in, opt-out o aviso.
  3. Estado por defecto de cada categoría en los modos opt-out y aviso.
  4. Textos del banner, si esa región necesita otra redacción, como un título “Do Not Sell or Share”.

Arrastra las reglas para cambiar su orden. Como se aplica la primera que coincide, coloca las reglas específicas, como la de un solo estado de EE. UU., por encima de las generales.

Si tienes dudas, usa opt-in. Un banner opt-in cumple los requisitos más estrictos, así que es una opción segura para cualquier región que no hayas revisado.

Global Privacy Control

Global Privacy Control es una señal del navegador que indica a los sitios que no vendan ni compartan los datos del visitante. En las regiones opt-out, Cookiesh la trata como una exclusión válida de marketing, registra el consentimiento con el método gpc y, en lugar del banner, muestra una nota breve: “Se ha respetado tu señal de preferencia de exclusión”. Puedes activar el mismo comportamiento en cualquier otra regla.

Prueba tus reglas

Añade ?cookiesh_region= con un código de región a cualquier URL de tu sitio para simular un visitante de esa región. Esta anulación solo funciona con el modo de depuración activado, que puedes activar en Settings → Debug mode:

https://example.com/?cookiesh_region=US-CA
https://example.com/?cookiesh_region=DE

Después, ejecuta Cookiesh.debug() en la consola del navegador. Muestra la región detectada, la regla que ha coincidido, el banner mostrado y el estado actual de cada categoría. Cuando termines, vuelve a desactivar el modo de depuración.