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.
• 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:

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 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

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.

Attiva Consent Mode nelle impostazioni di Clarity

• Vai alla tua dashboard di Microsoft Clarity.
• 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.

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.

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.

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.

Aggiornato il: 20/10/2026