¿Necesita mostrar diferentes banners de consentimiento a visitantes de distintos países? La función de geolocalización de WPConsent le permite crear reglas basadas en la ubicación que anulan la configuración predeterminada de su banner para regiones específicas. Esta guía le explica cómo configurar las reglas de geolocalización en WPConsent.

Característica Pro: Esta característica requiere WPConsent Pro.

Tabla de contenidos

• Requisitos previos
• Comprender cómo funciona la geolocalización
• Acceder a la página de geolocalización
• Elegir un punto de partida
• Configurar un grupo de ubicaciones
• Personalizar el contenido del banner
• Guardar y administrar grupos de ubicaciones
• Ocultar el banner de forma predeterminada
• Comprender el almacenamiento en caché de geolocalización
• Casos de uso comunes
• Verificar su configuración
• Solución de problemas
• Preguntas frecuentes
• Conclusión

Requisitos previos

Antes de empezar, asegúrese de tener lo siguiente preparado:

• Una licencia activa de WPConsent Pro
• Una comprensión básica de las regulaciones de privacidad como GDPR, CCPA o LGPD
• Su banner de consentimiento configurado en WPConsent >> Diseño del banner (consulte la guía de configuración general)

Comprender cómo funciona la geolocalización

Cuando la geolocalización está activa, WPConsent sigue este proceso para cada nuevo visitante:

1. El JavaScript del frontend comprueba si existe una cookie wpconsent_geolocation en la caché.
2. Si no existe ninguna cookie, llama al punto final de la API REST en /wp-json/wpconsent/v1/geolocation.
3. El servidor busca la dirección IP del visitante a través de geo.wpconsent.com. La IP se anonimiza antes de la búsqueda.
4. El servidor compara el país y el estado/provincia del visitante con sus grupos de ubicaciones configurados.
5. Cuando se encuentra una coincidencia, el servidor devuelve la configuración de ese grupo. El frontend almacena en caché la respuesta en la cookie wpconsent_geolocation durante 30 días.
6. El frontend aplica la configuración del grupo coincidente. Estas anulan el comportamiento predeterminado del banner, incluido el modo de consentimiento, el bloqueo de scripts, la visibilidad de los botones, el texto de los botones, el orden de los botones y el mensaje del banner.

Si no coincide ningún grupo de ubicaciones, el sistema recurre a la configuración predeterminada del plugin. La misma solución alternativa se aplica cuando la búsqueda de geolocalización falla debido a un error de red o una solicitud bloqueada, por lo que su sitio siempre tiene una experiencia de consentimiento funcional.

Acceder a la página de geolocalización

Para empezar, navegue a WPConsent >> Geolocation en su menú de administración de WordPress.

La página tiene 2 secciones. La sección superior muestra plantillas de reglas predefinidas y un botón de regla personalizada. Debajo, una tabla enumera todos sus grupos de ubicaciones existentes.

Elegir un punto de partida

Tiene 2 opciones para crear reglas de ubicación.

Usar plantillas predefinidas

Haga clic en 1 de los botones de plantilla para una configuración instantánea:

• Cumplimiento de GDPR: Se dirige a todos los países europeos. Establece el modo de consentimiento en opt-in, habilita el bloqueo de scripts, muestra el banner y muestra el botón de configuración.
• CCPA: Se dirige a California (nivel estatal de EE. UU.). Establece el modo de consentimiento en opt-out, habilita el bloqueo de scripts, muestra el banner y muestra el botón de configuración.
• LGPD: Se dirige a Brasil. Establece el modo de consentimiento en opt-in, habilita el bloqueo de scripts, muestra el banner y muestra el botón de configuración.

Cada plantilla crea un grupo de ubicaciones completo con 1 clic. El botón cambia a "Añadido" después de usar una plantilla. Esto evita reglas duplicadas para la misma ubicación.

Creación de una regla personalizada

Haz clic en Añadir regla personalizada para abrir la ventana modal del grupo de ubicaciones y crear una regla desde cero. Úsala cuando necesites combinaciones de países específicas, segmentación de estados de EE. UU. más allá de California, segmentación de provincias canadienses o configuraciones de consentimiento personalizadas.

Configurar un grupo de ubicaciones

Cuando haces clic en Añadir regla personalizada, se abre una ventana modal con el formulario de configuración.

Establecer el nombre del grupo

Primero, introduce un nombre descriptivo que identifique esta regla. Los buenos nombres describen las ubicaciones y el propósito, como "Unión Europea – GDPR" o "Privacidad de California + Colorado".

Seleccionar ubicaciones

El selector de ubicaciones utiliza un árbol jerárquico organizado por continente.

1. Usa el cuadro de búsqueda para filtrar ubicaciones por nombre. Los resultados coincidentes se expanden automáticamente.
2. Marca la casilla de un continente para seleccionar todos los países dentro de él.
3. Haz clic en la flecha junto a un continente para expandirlo y seleccionar países individuales.
4. Expande Estados Unidos (EE. UU.) para seleccionar estados individuales de EE. UU. Marcar la casilla del país EE. UU. selecciona todos los estados.
5. Expande Canadá para seleccionar provincias y territorios canadienses individuales. Marcar la casilla del país Canadá selecciona todas las provincias.
6. Usa los botones Expandir todo, Contraer todo y Borrar todo para gestionar el árbol rápidamente.

Las ubicaciones seleccionadas aparecen en el resumen de Ubicaciones seleccionadas debajo del árbol. Para eliminar una ubicación, haz clic en el icono X junto a ella.

Cada ubicación solo puede pertenecer a 1 grupo. Las ubicaciones ya asignadas a otro grupo muestran la etiqueta "(Usado)" y están deshabilitadas. Debes eliminar el otro grupo primero para reasignar esa ubicación.

Ajustar la configuración de consentimiento

A continuación, configura cómo se comporta el banner para los visitantes de estas ubicaciones:

• Bloquear scripts antes del consentimiento: Cuando está habilitado, los scripts de seguimiento se bloquean hasta que el visitante da su consentimiento. Esto es necesario para el cumplimiento del GDPR y se recomienda para el LGPD.
• Mostrar banner de consentimiento: Activa o desactiva el banner para estos visitantes. Desactiva esto para regiones donde no se requiere un banner de consentimiento.
• Mostrar botón de configuración: Controla la visibilidad del botón flotante de preferencias que permite a los visitantes cambiar sus opciones de consentimiento más tarde.
• Modo de consentimiento: Elige entre:

– Opt-in (el usuario debe consentir activamente): Los scripts se bloquean por defecto. El visitante debe hacer clic en Aceptar antes de que se establezcan las cookies no esenciales. Requerido por GDPR y LGPD. – Opt-out (consentimiento asumido a menos que se rechace): Los scripts se ejecutan por defecto. El visitante puede hacer clic en Rechazar para revocar el consentimiento. Se utiliza para el cumplimiento de CCPA.

Personalizar el contenido del banner

2 secciones opcionales le permiten anular los elementos del banner para este grupo de ubicaciones. Ambas están colapsadas por defecto.

Personalizar los botones del banner

Para personalizar los botones, active el interruptor Personalizar botones del banner. Esto revela las opciones de configuración de los botones.

Para cada botón (Aceptar, Rechazar, Configuración), puede:

• Editar el texto del botón para mostrar una redacción apropiada para la ubicación
• Activar o desactivar el botón con el interruptor de estado
• Arrastrar los botones usando el control para reordenarlos

Si tiene traducciones multilingües configuradas, el texto del botón establecido aquí anula esas traducciones para los visitantes que coincidan con este grupo de ubicaciones.

Personalizar el mensaje del banner

Para usar un mensaje personalizado, active el interruptor Personalizar mensaje del banner. Luego, introduzca un mensaje personalizado para este grupo de ubicaciones. Deje el área de texto vacía para usar su mensaje de banner predeterminado.

Al igual que el texto del botón, un mensaje de banner personalizado aquí anula cualquier traducción multilingüe para los visitantes que coincidan con este grupo.

Guardar y administrar grupos de ubicaciones

Una vez que haya configurado sus ajustes, haga clic en Guardar grupo de ubicaciones. La página se recarga y su nueva regla aparece en la tabla de grupos de ubicaciones.

La tabla muestra estas columnas para cada grupo:

Columna	Descripción
Nombre	El nombre del grupo que introdujo
Ubicaciones	Lista separada por comas de las ubicaciones seleccionadas
Tipo de Consentimiento	GDPR, CCPA, LGPD o Personalizado
Ajustes de Consentimiento	Marcas de verificación que muestran el estado de Bloquear script, Mostrar banner y Mostrar botón de configuración
Modo de Consentimiento	Optin o Optout
Acción	Botones Editar y Eliminar

Para editar un grupo existente, haga clic en el icono editar para reabrir el modal con su configuración cargada. Para eliminar un grupo, haga clic en el icono eliminar y confirme la eliminación.

Añadir reglas adicionales

Repita los pasos anteriores para añadir más grupos de ubicaciones. Cada grupo debe utilizar ubicaciones únicas. El sistema le impide asignar el mismo país, estado o provincia a varios grupos.

Cuando la ubicación de un visitante coincide con un grupo, el primer grupo coincidente surte efecto. No se comprueban más grupos.

Ocultar el banner de forma predeterminada

Un patrón común es ocultar el banner de consentimiento globalmente y mostrarlo solo en regiones reguladas. Para configurar esto:

1. Ve a WPConsent >> Ajustes y desactiva el banner de consentimiento.
2. Ve a WPConsent >> Geolocalización y crea grupos de ubicaciones para regiones reguladas con Mostrar banner de consentimiento activado.

El sistema de geolocalización fuerza la carga del banner en el frontend siempre que al menos 1 grupo de ubicaciones tenga Mostrar banner de consentimiento activado, incluso si la configuración principal del banner está desactivada. El frontend utiliza entonces la búsqueda de geolocalización para decidir si mostrar el banner a cada visitante.

Este enfoque significa que los visitantes fuera de tus grupos de ubicaciones no ven ningún banner. Los visitantes dentro de tus grupos ven la experiencia de consentimiento adecuada.

Comprender el almacenamiento en caché de geolocalización

WPConsent almacena en caché los resultados de geolocalización en una cookie del navegador llamada wpconsent_geolocation. Esta cookie almacena la configuración del grupo coincidente como JSON y caduca después de 30 días.

El almacenamiento en caché reduce la carga del servidor al eliminar llamadas repetidas a la API para los visitantes recurrentes. El endpoint de la REST API en geo.wpconsent.com solo se llama una vez por visitante, cuando no existen datos en caché o la cookie ha caducado.

Si cambias la configuración de un grupo de ubicaciones, los visitantes existentes con una cookie en caché continúan viendo la configuración antigua hasta que su cookie caduque. Puedes indicar a los usuarios que borren las cookies, o recibirán la configuración actualizada automáticamente en un plazo de 30 días.

WPConsent añade automáticamente la cookie wpconsent_geolocation a tu categoría de cookies Esenciales cuando creas tu primer grupo de ubicaciones.

Casos de uso comunes

Cumplimiento solo para la UE

Utiliza la plantilla GDPR para mostrar un banner de consentimiento de exclusión voluntaria solo a los visitantes europeos. Luego, desactiva el banner en WPConsent >> Ajustes para que los visitantes de fuera de Europa no vean ningún banner.

CCPA de California

Utiliza la plantilla CCPA para los residentes de California. El modo de consentimiento de exclusión voluntaria permite las cookies por defecto hasta que los usuarios las rechazan activamente. Esto se alinea con los requisitos de la CCPA.

LGPD de Brasil

Utiliza la plantilla LGPD para requerir el consentimiento explícito de los visitantes brasileños antes de establecer cookies no esenciales. La LGPD requiere el consentimiento de exclusión voluntaria, similar a la GDPR.

Múltiples regiones con diferentes reglas

Crea grupos separados para cada marco regulatorio. Por ejemplo, añade una regla GDPR para Europa (exclusión voluntaria), una regla CCPA para California (exclusión voluntaria) y una regla personalizada para Quebec, Canadá (exclusión voluntaria) para cumplir con la Ley 25 de Quebec.

Segmentación a nivel de provincia canadiense

Expande Canadá en el selector de ubicaciones para dirigirte a provincias específicas. Esto te permite aplicar reglas más estrictas a provincias como Quebec mientras utilizas reglas más flexibles para otras provincias canadienses.

Texto del banner específico de la región

Utiliza la personalización de botones y mensajes para mostrar un lenguaje apropiado para la región. Para los visitantes de California, podrías cambiar el texto del botón de rechazo a "No Vender Mis Datos" y usar un mensaje en el banner que haga referencia a los derechos de la CCPA.

Verificar su configuración

Prueba tus reglas de geolocalización para confirmar que funcionan correctamente.

1. Visita tu sitio desde una ubicación incluida en una regla, o utiliza una VPN para simular una ubicación diferente.
2. Verifica que el banner aparece o se oculta según la configuración de tu regla.
3. Verifica que el modo de consentimiento (opt-in u opt-out) coincida con tu configuración.
4. Si personalizaste los botones, confirma que el texto y el orden son correctos.
5. Inspecciona las cookies del navegador para encontrar la cookie wpconsent_geolocation con los datos del grupo coincidente.
6. Borra la cookie wpconsent_geolocation y recarga para activar una nueva b uevoacute;squeda.

Para probar sin VPN, a tilde;ade temporalmente tu ubicación actual a una regla. Recuerda eliminarla despu uevoacute;s de probar.

Solución de problemas

El banner muestra configuraciones incorrectas para una ubicaci uevoacute;n

Comprueba si hay conflictos de reglas. Cada ubicaci uevoacute;n solo puede existir en 1 grupo, y el primer grupo coincidente tiene prioridad. Verifica que el modo de consentimiento y la configuraci uevoacute;n de tu regla coincidan con tus expectativas. Luego, edita o elimina las reglas en conflicto de la tabla de grupos de ubicaciones.

La detecci uevoacute;n de ubicaci uevoacute;n falla

El servicio de geolocalizaci uevoacute;n requiere acceso HTTP saliente a geo.wpconsent.com. Comprueba las reglas del firewall de tu servidor o ponte en contacto con tu proveedor de hosting si las solicitudes est uevoacute;n bloqueadas. Cuando la detecci uevoacute;n falla, el sistema recurre a tu configuraci uevoacute;n predeterminada.

Los cambios no son visibles despu uevoacute;s de guardar

Borra la cookie wpconsent_geolocation en tu navegador. Esta cookie almacena en cach uevoacute; datos de ubicaci uevoacute;n durante 30 d uevoacute;as. Los visitantes recurrentes contin uevoacute;an viendo la configuraci uevoacute;n anterior hasta que su cookie expire o se borre.

El bloqueo de scripts no funciona para un grupo de ubicaciones

Verifica que Bloquear scripts antes del consentimiento est uevoacute; habilitado en la configuraci uevoacute;n del grupo de ubicaciones. Confirma tambi uevoacute;n que tienes scripts o servicios configurados para el bloqueo en WPConsent >> Contenido. El grupo de ubicaciones controla si el bloqueo est uevoacute; activo, pero a uevoacute;n necesitas contenido para bloquear.

El banner se muestra para todos los visitantes en lugar de regiones espec uevoacute;ficas

Aseg uevoacute;rate de haber deshabilitado el banner de consentimiento en WPConsent >> Configuraci uevoacute;n para la configuraci uevoacute;n predeterminada. El sistema de geolocalizaci uevoacute;n anula la predeterminada, no al rev uevoacute;s. Si el banner predeterminado est uevoacute; habilitado, todos los visitantes lo ver uevoacute;n independientemente de las reglas de ubicaci uevoacute;n.

Preguntas frecuentes

uevoacute;Se puede asignar la misma ubicaci uevoacute;n a m uevoacute;ltiples grupos?

No. Cada ubicaci uevoacute;n (pa uevoacute;is, estado o provincia) solo puede pertenecer a 1 grupo a la vez. Las ubicaciones ya asignadas a un grupo muestran la etiqueta "(Usado)" y est uevoacute;n deshabilitadas en el selector de ubicaciones. Para reasignar una ubicaci uevoacute;n, primero elimina el grupo al que pertenece.

uevoacute;Qu uevoacute; sucede si la ubicaci uevoacute;n de mi visitante no coincide con ning uevoacute;n grupo?

WPConsent recurre a la configuraci uevoacute;n predeterminada del plugin. El banner, el modo de consentimiento y el bloqueo de scripts siguen lo que hayas configurado en WPConsent >> Configuraci uevoacute;n.

uevoacute;C uevoacute;mo muestro el banner solo en pa uevoacute;ises espec uevoacute;ficos?

Primero, deshabilita el banner de consentimiento en WPConsent >> Configuraci uevoacute;n. Luego, crea grupos de geolocalizaci uevoacute;n para los pa uevoacute;ises donde quieras que aparezca el banner, con Mostrar banner de consentimiento habilitado. Los visitantes fuera de esos grupos no ver uevoacute;n un banner.

uevoacute;Con qu uevoacute; frecuencia comprueba WPConsent la ubicaci uevoacute;n de un visitante?

WPConsent comprueba una vez por visitante y almacena el resultado en la cookie wpconsent_geolocation durante 30 d uevoacute;as. Despu uevoacute;s de que la cookie expire, la siguiente carga de p uevoacute;gina activar uevoacute; una nueva b uevoacute;squeda.

uevoacute;Se aplicar uevoacute;n mis cambios inmediatamente a todos los visitantes?

No. Los visitantes recurrentes que ya tienen una cookie wpconsent_geolocation almacenada en caché continúan viendo la configuración antigua hasta que su cookie expire (hasta 30 días). Los visitantes nuevos y aquellos con cookies expiradas ven su configuración actualizada de inmediato.

Conclusión

Las reglas de geolocalización le brindan un control preciso sobre cómo se comporta su banner de consentimiento para visitantes de diferentes regiones. Al combinar plantillas predefinidas con reglas personalizadas, puede cumplir con GDPR, CCPA, LGPD y otras regulaciones de privacidad desde una sola instalación de WordPress.

Para obtener más información sobre las funciones de cumplimiento específicas de CCPA, consulte la guía sobre cómo configurar No Vender. También puede revisar sus registros de consentimiento para rastrear cómo interactúan los visitantes de diferentes regiones con su banner.