Microsoft Clarity

Clarity é a ferramenta gratuita da Microsoft pra session replay + heatmaps. Não envia eventos de conversão — só grava sessões anônimas pra análise de UX.

Configuração por brand

{ clarityId: "abcd1234" }  // ← string ou null

Brand	clarityId
Todas as brands ativas hoje	null (não configurado)

Funcionamento

Quando clarityId é setado:

1. useAnalytics agenda initClarity(clarityId) via scheduleThirdParty (priority low — não compete com pixels de conversão)
2. Script Clarity é injetado no head
3. Clarity grava automaticamente toda interação (clicks, scrolls, navegação SPA, formulários — campos sensíveis são auto-mascarados)

O que Clarity captura

• Session replay (vídeo de cada sessão)
• Heatmaps de cliques e scroll
• Rage clicks (cliques rápidos repetidos = frustração)
• Dead clicks (clique que não faz nada)
• Performance metrics
• NÃO captura: input text de campos password, campos masked, dados financeiros

Como debuggar

Clarity dashboard

clarity.microsoft.com → escolhe o project → vê sessões em tempo real (latência ~30 min).

Console / Network

window.clarity  // SDK Clarity global

Network → filtra clarity.ms.

Anti-patterns

1. Desativar Clarity em prod sem aviso. Usado por times de UX/produto pra investigação de bug. Aviso interno antes de desativar.
2. Logar PII em campo não-mascarado. Verifique que campos sensíveis (CPF, telefone, endereço) tenham data-clarity-mask="true" ou estejam em <input type="password">.