> ## 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).

# Integrare la Consent API di Microsoft Clarity con Pandectes

Microsoft Clarity è uno strumento di analisi gratuito che offre mappe di calore e registrazioni delle sessioni per aiutarti a capire il comportamento degli utenti sul tuo sito. Tuttavia, poiché Clarity raccoglie dati comportamentali, il suo utilizzo nell'UE richiede il consenso preventivo dell'utente ai sensi del **GDPR** e della **direttiva ePrivacy**.

Con Pandectes puoi integrare facilmente Microsoft Clarity nel tuo negozio Shopify e assicurarti che la raccolta dei dati inizi solo **dopo aver ottenuto un consenso valido dell'utente**.

### Prerequisiti

Prima di iniziare:

* Devi avere un account Microsoft Clarity.
* Nel tuo negozio Shopify deve essere installata e configurata l'app [Pandectes GDPR Compliance](https://apps.shopify.com/gdpr-cookie-consent).
* Assicurati di aver attivato l'integrazione Microsoft Clarity all'interno dell'app.

### Cos'è la Clarity Consent API?

La Clarity Consent API ti permette di controllare cosa Clarity può tracciare in base alle scelte di consenso dell'utente. Questo ti aiuta a rimanere conforme al GDPR e a evitare la raccolta non autorizzata di dati.
Clarity usa due tipi di consenso indipendenti:

| Clarity permission | What it covers | Pandectes cookie category |
| ---- |
| `analytics_Storage` | Comportamento degli utenti, sessioni, mappe di calore | Performance / Analytics |
| `ad_Storage` | Retargeting, conversioni, prestazioni degli annunci | Marketing / Advertising |

Ogni autorizzazione può essere concessa o negata in modo indipendente. Ad esempio, un utente può accettare le analisi ma rifiutare la pubblicità. Pandectes rispetta e comunica ogni scelta a Clarity separatamente.

### Come funziona l'integrazione

Quando l'integrazione è attiva, Pandectes invia a Clarity segnali di consenso in base alle scelte dell'utente. Tuttavia, **non viene impostato alcun cookie e non avviene alcun tracciamento** finché non viene ricevuto il segnale di consenso appropriato.
a Clarity separatamente

**Il modo in cui viene caricato lo script di Clarity** dipende dal fatto che tu fornisca o meno un Project ID nelle impostazioni di Pandectes:
* **Con un Project ID:** Pandectes carica automaticamente lo script di Clarity il prima possibile durante il caricamento della pagina, seguendo la [raccomandazione ufficiale di Microsoft](https://learn.microsoft.com/en-us/clarity/setup-and-installation/cmp-integration-guide) secondo cui lo script viene eseguito indipendentemente dallo stato del consenso, così che i segnali non vadano mai persi.
* **Senza un Project ID:** Sei tu a doverti occupare di caricare lo script di Clarity nel tuo negozio. Pandectes invierà comunque i segnali di consenso, ma lo script deve essere presente nella pagina perché abbiano effetto.

Ecco cosa succede dopo che l'utente interagisce con il banner di consenso:

1. Pandectes legge le scelte dell'utente sui cookie.
2. Per ogni categoria accettata, la corrispondente autorizzazione di Clarity viene impostata su `"granted"`.
3. Per ogni categoria rifiutata, la corrispondente autorizzazione viene impostata su `"denied"`.
4. Pandectes chiama la Clarity Consent API con le autorizzazioni risultanti.

###### Cosa fa Clarity senza consenso

Quando il consenso viene negato, Clarity **non** si ferma semplicemente, ma passa alla **modalità senza cookie**, il che significa che:
* Non avviene alcun tracciamento tra sessioni diverse.
* I cookie che richiedono il consenso non vengono impostati (vedi tabella sotto).
* Possono comunque essere raccolti dati limitati e non identificativi.

###### Cookie controllati dal consenso

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

### Attivare Consent Mode in Clarity

Prima che Pandectes possa comunicare il consenso a Clarity, devi assicurarti che Consent Mode sia attivo nelle impostazioni del tuo progetto Clarity. Questo impedisce a Clarity di impostare cookie prima di aver ricevuto un segnale di consenso valido.

|| Nota: Consent Mode è attivo per impostazione predefinita per i visitatori dello Spazio economico europeo (SEE), del Regno Unito e della Svizzera. Se il tuo negozio vende esclusivamente in queste aree, non è necessaria alcuna modifica. Per i negozi con un pubblico globale, segui i passaggi qui sotto.

###### Attiva Consent Mode nelle impostazioni di Clarity

* Vai alla tua [dashboard di Microsoft Clarity](https://clarity.microsoft.com/).
* Vai su **Settings → Setup**.
* Scorri verso il basso e **disattiva** l'opzione **Cookies**.
* Clarity confermerà che i cookie sono disattivati finché non viene ricevuto il consenso.

![](https://storage.crisp.chat/users/helpdesk/website/-/1/a/5/a/1a5af239e847cf00/image_ho0429.png =800x405)
###### Verifica che il consenso funzioni correttamente

Dopo aver configurato l'integrazione, puoi verificare che Clarity riceva correttamente i segnali di consenso da Pandectes:

1. Apri il tuo negozio in un browser e apri gli **Strumenti per sviluppatori** (`Ctrl+Shift+I` / `Cmd+Option+I`).
2. Vai alla scheda **Console**.
3. Incolla ed esegui quanto segue:
```
clarity('metadata', (d, upgrade, consent) => {
    console.log('consentStatus:', consent);
}, false, true, true);
```
4. Se il consenso non è stato concesso, dovresti vedere:
```
{ "analytics_storage": "DENIED", "ad_storage": "DENIED" }
```
5. Dopo aver accettato i cookie nel banner di Pandectes, l'output dovrebbe aggiornarsi in base alle scelte dell'utente.

### Attivare Microsoft Clarity in Pandectes
Segui questi passaggi:

1. Accedi al tuo negozio Shopify e apri l'**app Pandectes**.
2. Vai su **Integrations**.
3. Scorri fino a **Microsoft Clarity** e clicca su **Configure**.
![](https://storage.crisp.chat/users/helpdesk/website/-/1/a/5/a/1a5af239e847cf00/image_eszb4s.png =300x225)
1. Sposta l'interruttore per **attivare l'integrazione**.* *
2. *(Facoltativo)* Incolla il tuo **Clarity Project ID** se vuoi che sia Pandectes a caricare lo script di Clarity al posto tuo. Se lo lasci vuoto, devi caricare lo script nel tuo negozio in modo indipendente.

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

Una volta attivata, Pandectes:
* **Invierà segnali di consenso granulari** (`analytics_Storage` e `ad_Storage`) in base alle scelte effettive dell'utente.
* **Impedirà la scrittura di qualsiasi cookie di Clarity** finché il consenso corrispondente non viene concesso.
* **Caricherà automaticamente lo script di Clarity** (solo quando viene fornito un Project ID), il prima possibile durante il caricamento della pagina, così che i segnali di consenso non vadano mai persi.

### Note finali

Questa integrazione è pienamente conforme e ottimizzata per:
* Negozi Shopify che vendono nell'UE
* Commercianti soggetti al GDPR, al CCPA e ad altri quadri normativi sulla privacy
* Negozi che cercano un controllo automatizzato e granulare sul tracciamento di terze parti

Per maggiori dettagli, consulta la documentazione ufficiale di Microsoft sull'[integrazione dei CMP con Clarity](https://learn.microsoft.com/en-us/clarity/setup-and-installation/cmp-integration-guide).