> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.pandectes.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Integración de la Clarity Consent API de Microsoft con Pandectes

Microsoft Clarity es una herramienta de analítica gratuita que ofrece mapas de calor y grabaciones de sesiones para ayudarte a entender el comportamiento de los usuarios en tu sitio web. Sin embargo, como Clarity recopila datos de comportamiento, su uso en la UE requiere el consentimiento previo del usuario conforme al **RGPD (GDPR)** y la **Directiva ePrivacy**.

Con Pandectes puedes integrar fácilmente Microsoft Clarity en tu tienda Shopify y asegurarte de que la recopilación de datos solo empiece **una vez obtenido el consentimiento válido del usuario**.

### Requisitos previos

Antes de empezar:

* Debes tener una cuenta de Microsoft Clarity.
* Tu tienda Shopify debe tener instalada y configurada la aplicación [Pandectes GDPR Compliance](https://apps.shopify.com/gdpr-cookie-consent).
* Asegúrate de haber activado la integración de Microsoft Clarity dentro de la aplicación.

### ¿Qué es la Clarity Consent API?

La Clarity Consent API te permite controlar lo que Clarity puede rastrear según las decisiones de consentimiento del usuario. Esto te ayuda a cumplir con el RGPD y evita la recopilación de datos no autorizada.
Clarity utiliza dos tipos de consentimiento independientes:

| Permiso de Clarity | Qué cubre | Categoría de cookies de Pandectes |
| ---- |
| `analytics_Storage` | Comportamiento del usuario, sesiones, mapas de calor | Rendimiento / Analítica |
| `ad_Storage` | Retargeting, conversiones, rendimiento de los anuncios | Marketing / Publicidad |

Cada permiso se puede conceder o denegar de forma independiente. Por ejemplo, un usuario puede aceptar la analítica y rechazar la publicidad. Pandectes respeta y comunica cada decisión a Clarity por separado.

### Cómo funciona la integración

Cuando la integración está activada, Pandectes envía señales de consentimiento a Clarity según las decisiones del usuario. Sin embargo, **no se instala ninguna cookie ni se realiza ningún seguimiento** hasta que se recibe la señal de consentimiento correspondiente.
a Clarity por separado

**La forma en que se carga el script de Clarity** depende de si indicas un Project ID en los ajustes de Pandectes:
* **Con un Project ID:** Pandectes carga el script de Clarity automáticamente lo antes posible durante la carga de la página, siguiendo la [recomendación oficial de Microsoft](https://learn.microsoft.com/en-us/clarity/setup-and-installation/cmp-integration-guide) de que el script se ejecute independientemente del estado del consentimiento para no perder nunca ninguna señal.
* **Sin un Project ID:** Eres responsable de cargar el script de Clarity en tu tienda. Pandectes seguirá enviando las señales de consentimiento, pero el script debe estar presente en la página para que surtan efecto.

Esto es lo que ocurre después de que el usuario interactúa con el banner de consentimiento:

1. Pandectes lee las decisiones del usuario sobre las cookies.
2. Para cada categoría aceptada, el permiso de Clarity correspondiente se establece en `"granted"`.
3. Para cada categoría rechazada, el permiso correspondiente se establece en `"denied"`.
4. Pandectes llama a la Clarity Consent API con los permisos resultantes.

###### Qué hace Clarity sin consentimiento

Cuando se deniega el consentimiento, Clarity **no** se limita a detenerse, sino que pasa al **modo sin cookies**, lo que significa que:
* No se realiza seguimiento entre sesiones.
* No se instalan las cookies que requieren consentimiento (consulta la tabla siguiente).
* Aún se pueden recopilar datos limitados que no identifican al usuario.

###### Cookies controladas por el consentimiento

| Cookie | Requiere |
| ---- |
| `_clck` (first-party) | `analytics_Storage=granted` |
| `_clsk` (first-party) | `analytics_Storage=granted` |
| `MUID` | `ad_Storage=granted` |

### Activar Consent Mode en Clarity

Antes de que Pandectes pueda comunicar el consentimiento a Clarity, debes asegurarte de que Consent Mode esté activo en los ajustes de tu proyecto de Clarity. Así evitas que Clarity instale cookies antes de recibir una señal de consentimiento válida.

|| Nota: Consent Mode está activado por defecto para los visitantes del Espacio Económico Europeo (EEE), el Reino Unido y Suiza. Si tu tienda vende exclusivamente en estas regiones, no es necesario ningún cambio. Si tu tienda tiene una audiencia global, sigue los pasos siguientes.

###### Activa Consent Mode en los ajustes de Clarity

* Ve a tu [panel de Microsoft Clarity](https://clarity.microsoft.com/).
* Ve a **Settings → Setup**.
* Desplázate hacia abajo y desactiva la opción **Cookies**.
* Clarity confirmará que las cookies están desactivadas hasta que se reciba el consentimiento.

![](https://storage.crisp.chat/users/helpdesk/website/-/1/a/5/a/1a5af239e847cf00/image_ho0429.png =800x405)
###### Verifica que el consentimiento funciona correctamente

Después de configurar la integración, puedes comprobar que Clarity recibe correctamente las señales de consentimiento de Pandectes:

1. Abre tu tienda en un navegador y abre las **Developer Tools** (`Ctrl+Shift+I` / `Cmd+Option+I`).
2. Ve a la pestaña **Console**.
3. Pega y ejecuta lo siguiente:
```
clarity('metadata', (d, upgrade, consent) => {
    console.log('consentStatus:', consent);
}, false, true, true);
```
4. Si no se ha concedido el consentimiento, deberías ver:
```
{ "analytics_storage": "DENIED", "ad_storage": "DENIED" }
```
5. Después de aceptar las cookies en el banner de Pandectes, el resultado debería actualizarse para reflejar las decisiones del usuario.

### Activar Microsoft Clarity en Pandectes
Sigue estos pasos:

1. Inicia sesión en tu tienda Shopify y accede a la **aplicación Pandectes**.
2. Ve a **Integrations**.
3. Desplázate hasta **Microsoft Clarity** y haz clic en **Configure**.
![](https://storage.crisp.chat/users/helpdesk/website/-/1/a/5/a/1a5af239e847cf00/image_eszb4s.png =300x225)
1. Activa el interruptor para **habilitar la integración**.* *
2. *(Opcional)* Pega tu **Clarity Project ID** si quieres que Pandectes cargue el script de Clarity por ti. Si lo dejas en blanco, deberás cargar el script en tu tienda de forma independiente.

![](https://storage.crisp.chat/users/helpdesk/website/-/1/a/5/a/1a5af239e847cf00/image_tiaixj.png =800x315)

Una vez activada, Pandectes:
* **Enviará señales de consentimiento granulares** (`analytics_Storage` y `ad_Storage`) según las decisiones reales del usuario.
* **Impedirá que se escriba cualquier cookie de Clarity** hasta que se conceda el consentimiento correspondiente.
* **Cargará el script de Clarity automáticamente** (solo cuando se indica un Project ID), lo antes posible durante la carga de la página para que las señales de consentimiento nunca se pierdan.

### Notas finales

Esta integración cumple plenamente la normativa y está optimizada para:
* Tiendas Shopify que venden en la UE
* Comerciantes sujetos al RGPD, la CCPA y otros marcos de privacidad
* Tiendas que buscan un control automatizado y granular del seguimiento de terceros

Para más información, consulta la documentación oficial de Microsoft sobre la [integración de CMP con Clarity](https://learn.microsoft.com/en-us/clarity/setup-and-installation/cmp-integration-guide).