Integracion de Microsoft Clarity Consent Mode con UniConsent CMP

Microsoft Clarity es una herramienta de analisis de comportamiento gratuita que utiliza mapas de calor y grabaciones de sesiones para ayudarle a comprender como interactuan los usuarios con su sitio web. Clarity Consent Mode le permite ajustar el comportamiento de Clarity en funcion de las preferencias de consentimiento individuales de los usuarios, garantizando el cumplimiento de las normativas de proteccion de datos como el GDPR.

Clarity no establece cookies hasta que recibe una senal de consentimiento valida. Cuando se otorga el consentimiento, Clarity establece cookies de primera y tercera parte para realizar el seguimiento de los usuarios entre sesiones. Cuando no se recibe el consentimiento, Clarity funciona en modo sin cookies con funciones limitadas.

Importante: A partir del 31 de octubre de 2025, Clarity aplica requisitos de senal de consentimiento para las visitas a paginas originadas en el Espacio Economico Europeo (EEE), el Reino Unido (RU) y Suiza (CH). Se requiere una senal de consentimiento valida para la funcionalidad completa de las funciones de Clarity para los usuarios de estas regiones. Consent Mode esta habilitado de forma predeterminada para estos usuarios.

Como funciona

Clarity Consent Mode utiliza dos tipos de consentimiento independientes:

PermisoUso de datos
analytics_StorageDatos relacionados con el analisis (comportamiento del usuario, uso y patrones de interaccion).
ad_StorageDatos relacionados con la publicidad (retargeting, conversiones y rendimiento de campanas).

Cada permiso puede establecerse en granted o denied. Los permisos son independientes entre si, y Clarity funciona correctamente con cualquier combinacion de valores de consentimiento.

Las claves ad_Storage y analytics_Storage distinguen entre mayusculas y minusculas. Los valores aceptados son granted o denied en minusculas.

Las siguientes cookies se escriben unicamente cuando se otorga el permiso correspondiente:

analytics_Storage=grantedad_Storage=granted
_clck (primera parte)MUID
_clsk (primera parte)

Para integrar Microsoft Clarity con UniConsent CMP, siga estos pasos para garantizar el cumplimiento de las preferencias de consentimiento del usuario:

En su panel de Clarity, seleccione el proyecto y vaya a Settings → Setup, luego desactive la opcion de establecer cookies de forma predeterminada. Esto garantiza que Clarity espere una senal de consentimiento valida antes de establecer cualquier cookie. (Consent Mode ya esta habilitado de forma predeterminada para el trafico del EEE, el Reino Unido y Suiza).

2. Cargar el script de Clarity

El script de Clarity debe cargarse lo antes posible durante la carga de la pagina, independientemente del estado del consentimiento. Clarity funciona correctamente en todas las configuraciones de Consent Mode y adapta automaticamente su comportamiento en funcion de las senales de consentimiento que recibe.

3. Establecer el estado de consentimiento predeterminado en la parte superior de su pagina (recomendado):

Recomendamos colocar el script de consentimiento en sus etiquetas <head> para que el modo de consentimiento se establezca por defecto y se actualice cuando un usuario modifique su configuracion de consentimiento. Las llamadas se anaden a una cola en caso de que el script de Clarity aun no se haya cargado.

// Clarity tag is added here
// You can set default consent mode right after the Clarity tag
<script>
window.clarity = window.clarity || function () {
    (window.clarity.q = window.clarity.q || []).push(arguments);
};
window.clarity('consentv2', {
    'ad_Storage': 'denied',
    'analytics_Storage': 'denied'
});
</script>

4. Configurar UniConsent CMP en su sitio

UniConsent CMP envia automaticamente senales de consentimiento a Microsoft Clarity mediante la Consent API V2 (consentv2), garantizando el cumplimiento de las preferencias de privacidad del usuario. Asigna los fines de analisis o estadisticas a analytics_Storage y los fines de marketing o publicidad a ad_Storage, actualizando el estado de consentimiento de Clarity cada vez que un usuario acepta, rechaza o realiza elecciones granulares.

5. Verificar su implementacion

Para confirmar que el consentimiento se transmite correctamente, abra las herramientas de desarrollador de su navegador, vaya a la pestana Console (Consola) y ejecute:

clarity('metadata', (d, upgrade, consent) => {
    console.log('consentStatus:', consent);
}, false, true, true);

Antes de que un usuario acepte las cookies, deberia ver ambos permisos denegados:

{
    analytics_storage: "DENIED",
    ad_storage: "DENIED"
}

Despues de que el usuario acepte en el banner de UniConsent CMP, los valores se actualizan en consecuencia (por ejemplo, ambos "GRANTED"). Tambien puede confirmar que no se escribe ninguna cookie _clck ni _clsk mientras el consentimiento esta denegado.

Referencias:

Tutoriales relacionados