Documentación de WPConsent

Documentación, materiales de referencia y tutoriales para WPConsent

Configuración de reglas de geolocalización

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

Función Pro: Esta función requiere WPConsent Pro.

Índice

Requisitos previos

Antes de comenzar, asegúrese de tener lo siguiente:

  • Una licencia activa de WPConsent Pro
  • Conocimientos básicos sobre normativas de privacidad como el RGPD, la CCPA o la LGPD.
  • Tu banner de consentimiento configurado en WPConsent >> Diseño del banner (consulta 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 hay un caché wpconsent_geolocation cookie.
  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.comLa IP se anonimiza antes de la búsqueda.
  4. El servidor compara el país y el estado/provincia del visitante con los grupos de ubicaciones que has configurado.
  5. Cuando se encuentra una coincidencia, el servidor devuelve la configuración de ese grupo. El frontend almacena en caché la respuesta en el wpconsent_geolocation cookie durante 30 días.
  6. La interfaz aplica la configuración del grupo coincidente. Esta configuración anula el comportamiento predeterminado del banner, incluyendo 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 hay ningún grupo de ubicaciones que coincida, el sistema recurre a la configuración predeterminada del complemento. Lo mismo ocurre cuando la búsqueda de geolocalización falla debido a un error de red o una solicitud bloqueada, por lo que su sitio siempre tendrá una experiencia de consentimiento que funcione.

Acceder a la página de geolocalización

Para empezar, ve a WPConsent >> Geolocalización en el menú de administración de WordPress.

Página de configuración de geolocalización

La página tiene dos secciones. La sección superior muestra plantillas de reglas predefinidas y un botón de reglas personalizadas. Debajo, una tabla muestra todos los grupos de ubicaciones existentes.

Elegir un punto de partida

Tienes dos opciones para crear reglas de ubicación.

Uso de plantillas predefinidas

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

  • Cumplimiento del RGPD: dirigido 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 aplica a California (a nivel estatal en 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: Dirigido 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 un solo clic. El botón cambia a «Añadido» después de usar una plantilla. Esto evita que se dupliquen las reglas para la misma ubicación.

Creación de una regla personalizada

Haga clic en Añadir regla personalizada para abrir el modal del grupo de ubicaciones y crear una regla desde cero. Utilice esta opción cuando necesite combinaciones de países específicos, segmentación por estados de EE. UU. más allá de California, segmentación por provincias canadienses o ajustes de consentimiento personalizados.

Configuración de un grupo de ubicaciones

Al hacer clic en «Añadir regla personalizada», se abre una ventana modal con el formulario de configuración.

Añadir modal de grupo de ubicaciones

Configuración del nombre del grupo

En primer lugar, introduzca un nombre descriptivo que identifique esta regla. Los nombres adecuados describen las ubicaciones y el propósito, como «Unión Europea - RGPD» o «Privacidad de California + Colorado».

Selección de ubicaciones

El selector de ubicación utiliza un árbol jerárquico organizado por continentes.

  1. Utilice el cuadro de búsqueda para filtrar las ubicaciones por nombre. Los resultados coincidentes se expanden automáticamente.
  2. Marque la casilla de un continente para seleccionar todos los países que lo componen.
  3. Haga clic en la flecha situada junto a un continente para ampliarlo y seleccionar países individuales.
  4. Expanda Estados Unidos (EE. UU.) para seleccionar estados individuales de EE. UU. Al marcar la casilla de verificación del país EE. UU., se seleccionan todos los estados.
  5. Expanda Canadá para seleccionar provincias y territorios canadienses individuales. Al marcar la casilla de verificación del país Canadá, se seleccionan todas las provincias.
  6. Utilice los botones Expandir todo, Contraer todo y Borrar todo para gestionar rápidamente el árbol.

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

Cada ubicación solo puede pertenecer a un grupo. Las ubicaciones ya asignadas a otro grupo muestran la etiqueta «(Usado)» y están desactivadas. Debe eliminar primero el otro grupo para reasignar esa ubicación.

A continuación, configura cómo se comportará 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 cumplir con el RGPD y se recomienda para la LGPD.
  • Mostrar banner de consentimiento: activa o desactiva el banner para estos visitantes. Desactívalo en las regiones donde no se requiera un banner de consentimiento.
  • Botón Mostrar configuración: controla la visibilidad del botón flotante de preferencias que permite a los visitantes cambiar sus opciones de consentimiento más adelante.
  • Modo de consentimiento: Elija entre:

Opt-in (el usuario debe dar su consentimiento activo): los scripts están bloqueados por defecto. El visitante debe hacer clic en «Aceptar» antes de que se instalen cookies no esenciales. Requerido por el RGPD y la LGPD. – Opt-out (se asume el consentimiento a menos que se rechace): los scripts se ejecutan por defecto. El visitante puede hacer clic en «Rechazar» para revocar su consentimiento. Se utiliza para cumplir con la CCPA.

Personalización del contenido del banner

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

Personalización de los botones del banner

Para personalizar los botones, activa la opción Personalizar botones del banner. Esto mostrará las opciones de configuración de los botones.

Configuración del botón del banner

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

  • Edite el texto del botón para mostrar una redacción adecuada a la ubicación.
  • Active o desactive el botón con el interruptor de estado.
  • Arrastra los botones utilizando el controlador para reordenarlos.

Si tiene configuradas traducciones en varios idiomas, el texto del botón establecido aquí anula esas traducciones para los visitantes que coincidan con este grupo de ubicación.

Personalización del mensaje del banner

Para utilizar un mensaje personalizado, active la opción Personalizar mensaje del banner. A continuación, introduzca un mensaje personalizado para este grupo de ubicaciones. Deje el área de texto vacía para utilizar el mensaje predeterminado del banner.

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

Guardar y gestionar grupos de ubicaciones

Una vez que haya configurado los ajustes, haga clic en Guardar grupo de ubicaciones. La página se recargará y la nueva regla aparecerá en la tabla de grupos de ubicaciones.

La tabla muestra estas columnas para cada grupo:

ColumnaDescripción
NombreEl nombre del grupo que has introducido
UbicacionesLista separada por comas de las ubicaciones seleccionadas
Tipo de consentimientoRGPD, CCPA, LGPD o personalizado
Configuración de consentimientoMarcas de verificación que muestran el estado de Bloquear script, Mostrar banner y Mostrar botón de configuración.
Modo de consentimientoOptar por participar u optar por no participar
AcciónBotones Editar y Eliminar

Para editar un grupo existente, haz clic en el icono de edición para volver a abrir el modal con su configuración cargada. Para eliminar un grupo, haz clic en el icono de eliminación y confirma 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 impide asignar el mismo país, estado o provincia a varios grupos.

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

Ocultar el banner de forma predeterminada

Una práctica habitual es ocultar el banner de consentimiento de forma global y mostrarlo solo en las regiones reguladas. Para configurarlo:

  1. Ve a WPConsent >> Configuración y desactiva el banner de consentimiento.
  2. Vaya a WPConsent >> Geolocalización y cree grupos de ubicación para las regiones reguladas con la opción Mostrar banner de consentimiento habilitada.

El sistema de geolocalización obliga a que el banner se cargue en la interfaz siempre que al menos un grupo de ubicaciones tenga habilitada la opción Mostrar banner de consentimiento, incluso si la configuración del banner principal está desactivada. A continuación, la interfaz utiliza la búsqueda de geolocalización para decidir si mostrar el banner a cada visitante.

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

Comprender el almacenamiento en caché de geolocalización

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

El almacenamiento en caché reduce la carga del servidor al eliminar las llamadas API repetidas para los visitantes que regresan. El punto final REST en geo.wpconsent.com solo se llama una vez por visitante, cuando no hay datos almacenados en caché o la cookie ha caducado.

Si cambia la configuración de un grupo de ubicaciones, los visitantes existentes con una cookie almacenada en caché seguirán viendo la configuración anterior hasta que expire su cookie. Puede aconsejar 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 el wpconsent_geolocation cookie a la categoría Cookies esenciales cuando crees tu primer grupo de ubicaciones.

Casos de uso comunes

Cumplimiento exclusivo de la UE

Utiliza la plantilla del RGPD para mostrar un banner de consentimiento opt-in solo a los visitantes europeos. A continuación, desactiva el banner en WPConsent >> Ajustes para que los visitantes fuera de Europa no vean ningún banner.

Ley de Protección de Datos Personales de California (CCPA)

Utilice la plantilla CCPA para los residentes de California. El modo de consentimiento de exclusión voluntaria permite las cookies de forma predeterminada hasta que los usuarios las rechacen activamente. Esto se ajusta a los requisitos de la CCPA.

Brasil LGPD

Utilice la plantilla LGPD para solicitar el consentimiento explícito de los visitantes brasileños antes de instalar cookies no esenciales. La LGPD exige el consentimiento expreso, similar al RGPD.

Múltiples regiones con diferentes reglas

Cree grupos separados para cada marco normativo. Por ejemplo, añada una regla del RGPD para Europa (opt-in), una regla de la CCPA para California (opt-out) y una regla personalizada para Quebec, Canadá (opt-in), a fin de cumplir con la Ley 25 de Quebec.

Focalización a nivel provincial en Canadá

Expanda Canadá en el selector de ubicación para seleccionar provincias específicas. Esto le permite aplicar reglas más estrictas a provincias como Quebec, mientras que utiliza reglas más flexibles para otras provincias canadienses.

Texto del banner específico para cada región

Utilice el botón y la personalización de mensajes para mostrar el idioma adecuado para cada región. Para los visitantes de California, puede cambiar el texto del botón de rechazo a «No vender mis datos» y utilizar un mensaje en el banner que haga referencia a los derechos de la CCPA.

Verificación de la configuración

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

  1. Visite su sitio desde una ubicación incluida en una regla o utilice una VPN para simular una ubicación diferente.
  2. Comprueba que el banner aparece u oculta según la configuración de tus reglas.
  3. Comprueba que el modo de consentimiento (aceptación o rechazo) coincide con tu configuración.
  4. Si ha personalizado los botones, confirme que el texto y el orden son correctos.
  5. Inspeccione las cookies del navegador para encontrar el wpconsent_geolocation cookie con los datos del grupo coincidente.
  6. Borrar el wpconsent_geolocation cookie y recargar para activar una nueva búsqueda.

Para realizar la prueba sin una VPN, añade temporalmente tu ubicación actual a una regla. Recuerda eliminarla después de la prueba.

Solución de problemas

El banner muestra una configuración incorrecta para una ubicación.

Comprueba si hay conflictos entre las reglas. Cada ubicación solo puede existir en un grupo, y el primer grupo que coincida tendrá prioridad. Verifica que el modo de consentimiento y la configuración de tu regla coincidan con tus expectativas. A continuación, edita o elimina las reglas conflictivas de la tabla de grupos de ubicaciones.

Fallo en la detección de ubicación

El servicio de geolocalización requiere acceso HTTP saliente a geo.wpconsent.com. Comprueba las reglas del cortafuegos de tu servidor o ponte en contacto con tu proveedor de alojamiento si las solicitudes están bloqueadas. Cuando la detección falla, el sistema vuelve a la configuración predeterminada.

Los cambios no se ven después de guardar.

Borrar el wpconsent_geolocation cookie en su navegador. Esta cookie almacena los datos de ubicación durante 30 días. Los visitantes que regresan siguen viendo la configuración anterior hasta que la cookie caduca o se borra.

El bloqueo de scripts no funciona para un grupo de ubicaciones.

Verifique que la opción «Bloquear scripts antes del consentimiento» esté habilitada en la configuración del grupo de ubicaciones. Confirme también que tiene scripts o servicios configurados para bloquear en WPConsent >> Contenido. El grupo de ubicaciones controla si el bloqueo está activo, pero aún así necesita contenido para bloquear.

El banner se muestra a todos los visitantes, en lugar de a regiones específicas.

Asegúrate de haber desactivado el banner de consentimiento en WPConsent >> Configuración para los ajustes predeterminados. El sistema de geolocalización anula los ajustes predeterminados, y no al revés. Si el banner predeterminado está activado, todos los visitantes lo verán independientemente de las reglas de ubicación.

Preguntas frecuentes

¿Puedo asignar la misma ubicación a varios grupos?

No. Cada ubicación (país, estado o provincia) solo puede pertenecer a un grupo a la vez. Las ubicaciones ya asignadas a un grupo muestran la etiqueta «(Usado)» y están desactivadas en el selector de ubicación. Para reasignar una ubicación, primero elimine el grupo al que pertenece.

¿Qué ocurre si la ubicación de mi visitante no coincide con ningún grupo?

WPConsent vuelve a la configuración predeterminada del complemento. El banner, el modo de consentimiento y el bloqueo de scripts siguen lo que hayas configurado en WPConsent >> Configuración.

¿Cómo puedo mostrar el banner solo en determinados países?

En primer lugar, desactive el banner de consentimiento en WPConsent >> Configuración. A continuación, cree grupos de geolocalización para los países en los que desea que aparezca el banner, con la opción Mostrar banner de consentimiento activada. Los visitantes que no pertenezcan a esos grupos no verán el banner.

¿Con qué frecuencia comprueba WPConsent la ubicación de un visitante?

WPConsent comprueba una vez por visitante y almacena el resultado en la caché. wpconsent_geolocation cookie durante 30 días. Una vez que la cookie caduca, la siguiente carga de la página activa una nueva búsqueda.

¿Mis cambios se aplicarán inmediatamente a todos los visitantes?

No. Los visitantes que ya han visitado la página anteriormente y tienen una caché wpconsent_geolocation Las cookies seguirán mostrando la configuración anterior hasta que caduquen (hasta 30 días). Los nuevos visitantes y aquellos con cookies caducadas verán la configuración actualizada de inmediato.

Conclusión

Las reglas de geolocalización te permiten controlar con precisión cómo se comporta tu banner de consentimiento para los visitantes de diferentes regiones. Al combinar plantillas predefinidas con reglas personalizadas, puedes cumplir con el RGPD, la CCPA, la LGPD y otras normativas de privacidad desde una única instalación de WordPress.

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

¿Le ha resultado útil este artículo?

Artículos relacionados