Documentación de WPConsent

Documentación, Materiales de Referencia y Tutoriales para WPConsent

Modo de consentimiento de Microsoft Clarity

¿Desea que Microsoft Clarity recopile datos de mapas de calor y grabaciones de sesiones sin cookies hasta que los visitantes den su consentimiento? WPConsent se integra con el Modo de Consentimiento de Clarity para permitir que Clarity funcione en un estado sin cookies y solo active el seguimiento completo después de que se otorgue el consentimiento. El Modo de Consentimiento de Microsoft Clarity le brinda análisis de comportamiento respetando las opciones de privacidad de los visitantes.

Tabla de contenidos

Requisitos previos

Antes de empezar, asegúrate de tener:

  • WPConsent instalado y activado
  • El banner de consentimiento habilitado en WPConsent >> Ajustes
  • El script de seguimiento de Clarity instalado en su sitio (a través de un plugin como WPCode, su tema o manualmente en su encabezado)
  • Al menos 1 servicio con clarity en su slug en su base de datos de cookies. Ejecute un escaneo si aún no lo ha hecho

Cómo funciona

El Modo de Consentimiento de Clarity funciona de manera diferente al Modo de Consentimiento v2 de Google. A diferencia del Modo de Consentimiento de Google, no hay forma de establecer un estado denegado predeterminado para Clarity al cargar la página. Clarity se ejecuta automáticamente en modo sin cookies para los visitantes de la Unión Europea, pero aún utiliza cookies para los visitantes de otras regiones por defecto.

Si desea un control total sobre las cookies para todos los visitantes, independientemente de su ubicación, debe deshabilitar las cookies en la configuración de su panel de Microsoft Clarity. Esto asegura que Clarity funcione en modo sin cookies a nivel mundial y solo habilite las cookies después de que WPConsent comunique el consentimiento.

Cuando un visitante interactúa con su banner, WPConsent dispara window.clarity('consentv2', {...}) con el estado del consentimiento. Esto sucede cada vez que un visitante guarda sus preferencias, ya sea a través del botón de aceptar, el botón de denegar o el modal de preferencias.

WPConsent mapea sus categorías de cookies a los parámetros de consentimiento de Clarity:

Categoría de cookie de WPConsentParámetro de consentimiento de ClarityValor aceptadoValor denegado
marketingalmacenamiento_anunciosconcedidodenegado
estadísticasalmacenamiento_analíticasconcedidodenegado

El Modo de Consentimiento de Clarity está habilitado por defecto. Para verificar o cambiar esta configuración, navegue a WPConsent >> Ajustes y seleccione la pestaña Avanzado.

A continuación, busque el interruptor Modo de Consentimiento de Clarity. La descripción dice "Usar Microsoft Clarity sin cookies hasta que se otorgue el consentimiento."

Conmutador del modo de consentimiento de Clarity en Configuración avanzada

El interruptor está activado por defecto. Si estaba deshabilitado previamente, actívelo y haga clic en Guardar Cambios en la parte inferior de la página.

El Modo de Consentimiento de Clarity requiere que el banner de consentimiento esté habilitado. Si el banner está deshabilitado, las señales de consentimiento no se enviarán a Clarity.

Confirmando la existencia de un servicio de Clarity

WPConsent solo envía señales de consentimiento a Clarity si al menos 1 servicio en su base de datos de cookies tiene clarity en su slug.

Para comprobarlo, vaya a WPConsent >> Ajustes y seleccione la pestaña Cookies. Busque un servicio de Clarity en su lista.

Si ejecutaste el escáner del sitio, es probable que Clarity ya esté detectado. Si no está en la lista, crea un nuevo servicio y establece el slug a clarity. Asígnalo a la categoría de estadísticas.

Comprender la relación con el bloqueo de scripts

Cuando el Modo de Consentimiento de Clarity está habilitado, WPConsent omite automáticamente el bloqueo de scripts para Clarity. Esto es intencional.

El Modo de Consentimiento de Clarity permite que el script de Clarity se cargue inmediatamente en un estado sin cookies. En lugar de bloquearlo por completo, WPConsent utiliza la propia API de consentimiento de Clarity para controlar qué datos recopila. El script se ejecuta sin cookies hasta que se otorga el consentimiento.

No necesitas configurar nada para este comportamiento. Ocurre automáticamente siempre que:

  • El interruptor Modo de Consentimiento de Clarity esté habilitado
  • El nombre del servicio reconocido por el bloqueador de scripts sea clarity

Otros scripts que no son de Clarity continúan siendo bloqueados normalmente por el bloqueo automático de scripts.

Verificar su configuración

Prueba que el Modo de Consentimiento de Clarity funciona correctamente abriendo tu sitio en una ventana privada del navegador.

Comprobando que Clarity se cargó

Abre las herramientas de desarrollador del navegador (F12), ve a la pestaña Consola y escribe:

typeof window.clarity

Esto devuelve "function" si Clarity se está cargando correctamente. Si devuelve "undefined", tu script de seguimiento de Clarity no está instalado o algún otro plugin lo está bloqueando.

Antes de hacer clic en aceptar en tu banner, pega esto en la consola para interceptar las llamadas de Clarity:

const originalClarity = window.clarity;
window.clarity = function(...args) {
  console.log('Clarity called:', args);
  return originalClarity.apply(this, args);
};

Ahora acepta todas las cookies. Verás una salida como esta:

Clarity called: ['consentv2', {ad_Storage: 'granted', analytics_Storage: 'granted'}]

Borra tus cookies y recarga la página. Configura la misma interceptación que antes, luego deniega todas las cookies. Verás:

Clarity called: ['consentv2', {ad_Storage: 'denied', analytics_Storage: 'denied'}]

También puedes verificar que el evento subyacente wpconsent_consent_saved se dispara correctamente:

window.addEventListener('wpconsent_consent_saved', (e) => {
  console.log('Consent saved:', e.detail);
});

Este evento se dispara cada vez que un visitante guarda sus preferencias. El objeto detail contiene las elecciones de categorías del visitante (por ejemplo, {essential: true, statistics: true, marketing: false}).

Solución de problemas

Comprueba si el interruptor está habilitado. Navega a WPConsent >> Ajustes >> Avanzado y verifica que el interruptor Modo de Consentimiento de Clarity esté activado.

Comprueba si el banner está habilitado. El Modo de Consentimiento de Clarity solo funciona cuando tu banner de consentimiento está activo. Verifica que Banner de Consentimiento esté activado en WPConsent >> Ajustes.

Comprueba si hay un servicio de Clarity. Ve a WPConsent >> Ajustes y selecciona la pestaña Cookies. Verifica que exista un servicio con clarity en el slug.

El script de Clarity sigue bloqueado

Si Clarity está siendo bloqueado a pesar de tener el Modo de Consentimiento habilitado, comprueba lo siguiente:

  • El slug del servicio debe contener clarity (en minúsculas)
  • El Bloqueo Automático de Scripts debe estar habilitado en WPConsent >> Ajustes
  • El bloqueador de scripts debe reconocer el script como perteneciente al servicio de clarity. Si utilizas una implementación personalizada, asegúrate de que el nombre del script en el sistema de bloqueo sea clarity.

Abre la consola del navegador y busca errores de JavaScript. Luego, verifica que la función window.clarity exista antes de aceptar las cookies:

typeof window.clarity

Si devuelve "undefined", tu script de seguimiento de Clarity no se está cargando. Comprueba que esté instalado correctamente y que no esté siendo bloqueado por otro plugin o regla de seguridad.

Verifica que estás utilizando una versión reciente del script de seguimiento de Clarity que admita la API consentv2. También comprueba la configuración de tu proyecto de Clarity en el panel de Microsoft Clarity para confirmar que el modo de consentimiento esté configurado en su lado.

Preguntas frecuentes

¿Necesito modificar mi configuración de Clarity para que esto funcione?

No. WPConsent maneja las señales de consentimiento automáticamente. Solo asegúrate de que Clarity esté instalado en tu sitio y de que exista un servicio de Clarity en tu base de datos de cookies.

¿Por qué mi script de Clarity no se bloquea cuando el bloqueo de scripts está activado?

Cuando el Modo de Consentimiento de Clarity está habilitado, WPConsent omite intencionadamente el bloqueo para Clarity. El script se carga en un modo sin cookies y depende de la API de consentimiento propia de Clarity en lugar del bloqueo de scripts.

El Modo de Consentimiento de Google establece un estado denegado predeterminado al cargar la página y luego lo actualiza después del consentimiento. El Modo de Consentimiento de Clarity no establece un estado predeterminado. En su lugar, Clarity se carga normalmente sin cookies y espera a que WPConsent comunique el consentimiento a través de la API consentv2.

Sí. Ambas funciones funcionan de forma independiente. WPConsent envía las señales de consentimiento apropiadas a cada servicio según las elecciones del visitante.

Conclusión

El Modo de Consentimiento de Clarity permite a Microsoft Clarity recopilar datos de comportamiento sin cookies respetando las opciones de privacidad del visitante. WPConsent maneja toda la integración automáticamente, desde omitir el bloqueo de scripts hasta enviar señales de consentimiento cuando los visitantes interactúan con tu banner.

Para saber cómo WPConsent maneja el consentimiento para los servicios de Google, consulta la guía sobre configuración del Modo de Consentimiento de Google v2.

¿Te ha resultado útil este artículo?

Artículos relacionados