Abrir workspace

Guia · Microsoft Clarity

Microsoft Clarity e o consentimento, passo a passo

O Clarity grava sessões e cria mapas de calor do seu site. Desde 31 de outubro de 2025, visitas do EEE, Reino Unido e Suíça precisam de um sinal de consentimento válido para o Clarity funcionar por completo. Veja os três jeitos de enviar esse sinal e os erros mais comuns.

Conferir o Clarity do meu siteLer o guia
  • ✓Baseado na documentação oficial do Clarity
  • ✓Código pronto para copiar
  • ✓Leitura sem alterar o site
2025ano em que o Clarity passou a exigir o sinal, desde 31 de outubro
3regiões com exigência: EEE, Reino Unido e Suíça
2tipos de consentimento lidos pelo Clarity: analytics_storage e ad_storage
9meses de validade máxima do consentimento, salvo mudança antes

O que é

Um aviso de consentimento para a ferramenta de gravações da Microsoft

O Microsoft Clarity é uma ferramenta gratuita de análise de comportamento. Ele mostra mapas de calor, gravações de sessões e onde os visitantes clicam, rolam ou desistem. Muitos editores usam o Clarity para melhorar o layout e a posição dos anúncios.

Para fazer isso, o Clarity usa cookies próprios que ligam as páginas de uma mesma visita. Na Europa, gravar esses cookies exige consentimento prévio do visitante.

Por isso, a Microsoft criou um modo de consentimento no Clarity. Desde 31 de outubro de 2025, visitas do EEE, Reino Unido e Suíça precisam chegar com um sinal de consentimento válido para que o Clarity funcione por completo.

Sem o sinal, o Clarity não para de vez. Ele continua carregando, mas sem cookies e com recursos limitados. O problema é que os relatórios ficam incompletos e as sessões aparecem picadas.

Checklist

O que você precisa cumprir

Se o site usa o Clarity e recebe visitas do EEE, Reino Unido ou Suíça, estes pontos precisam estar funcionando.

  1. Sinal válido para EEE, Reino Unido e Suíça

    Desde 31 de outubro de 2025, visitas dessas regiões precisam chegar com um sinal de consentimento válido. Sem ele, o Clarity não grava cookies e limita recursos como gravações e funis.

  2. Ligar o modo de consentimento no projeto

    A Microsoft pede que o modo de consentimento do Clarity esteja ligado antes de usar qualquer CMP. Cada projeto do Clarity precisa do seu próprio sinal.

  3. Chamar a API logo depois do script

    Com banner próprio, chame a API consentv2 logo depois de o script do Clarity carregar e antes de qualquer cookie. Os dois campos são obrigatórios.

    // Visitante aceitou
window.clarity('consentv2', {
  ad_Storage: 'granted',
  analytics_Storage: 'granted'
});

// Visitante recusou
window.clarity('consentv2', {
  ad_Storage: 'denied',
  analytics_Storage: 'denied'
});

  4. Cookies do Clarity como não essenciais

    No banner, os cookies do Clarity precisam ficar numa categoria não essencial. Assim eles só são gravados depois do aceite.

    Exemplo

    Coloque _clck e _clsk na categoria Análise do banner, nunca em Necessários.

  5. Avisar os visitantes sobre o cookie

    A Microsoft diz que você precisa informar os visitantes sobre o cookie que o Clarity usa.

    Exemplo

    Usamos o Microsoft Clarity, com os cookies _clck e _clsk, para entender como os visitantes usam o site.

  6. Avisar quando o visitante desiste

    Se o visitante recusar depois de aceitar, envie o sinal negado. O Clarity apaga os cookies que já tinha gravado.

  7. Nada de Clarity para menores de 18

    A Microsoft diz que o Clarity não deve ser usado em sites ou apps voltados a menores de 18 anos.

  8. CMP certificada pelo Google para os anúncios

    Para anúncios personalizados do Google, o EEE e o Reino Unido exigem CMP certificada com TCF desde 16 de janeiro de 2024. A Suíça exige desde 31 de julho de 2024.

    Exemplo

    O Clarity lê o Consent Mode do Google, então o mesmo banner certificado pode atender os dois.

Na prática

Certo e errado

Ferramentas oficiais

CMPs certificadas e links oficiais

A Microsoft publica a lista de CMPs que passam o sinal ao Clarity sozinhas, e o Google mantém a lista de CMPs certificadas para o EEE, Reino Unido e Suíça.

A quem se aplica

Quem precisa ajustar o Clarity

A regra é da própria Microsoft e vale para qualquer projeto do Clarity com visitas das três regiões.

Sites com Clarity instalado

Qualquer site que usa o Clarity e recebe visitas do EEE, Reino Unido ou Suíça precisa enviar o sinal.

Quem liga o Clarity ao Microsoft Ads

O sinal de anúncios decide se o Clarity pode compartilhar dados com o Microsoft Advertising.

Sites com Consent Mode do Google

O Clarity lê os sinais do Consent Mode do Google sozinho. Para esses sites, o ajuste costuma ser pequeno.

Fora das três regiões

O modo de consentimento vem ligado por padrão apenas para EEE, Reino Unido e Suíça. Leis locais, como a LGPD, continuam valendo.

Definições

Os termos da documentação do Clarity

Estes nomes aparecem no painel, no código e nos guias da Microsoft.

analytics_storage

Consentimento para guardar dados de análise, como uso do site e padrões de interação. Negado, o Clarity coleta só dados sem cookie.

ad_storage

Consentimento para dados ligados a anúncios. Negado, o Clarity não compartilha dados com o Microsoft Ads.

Modo sem cookie

Sem consentimento, o Clarity cria um identificador novo a cada página vista e não grava cookies para ligar a visita.

Cookies _clck e _clsk

Os cookies próprios do Clarity. São apagados quando o visitante recusa depois de ter aceitado.

API consentv2

O comando oficial para enviar os dois sinais a partir de um banner próprio ou de uma CMP sem integração.

Modo de consentimento no painel

Configuração do projeto em que o Clarity espera um sinal válido antes de gravar cookies.

Com e sem sinal

O que o Clarity faz em cada caso

A diferença aparece direto nos relatórios de gravações e mapas de calor.

Visitante que aceitou

O Clarity grava os cookies _clck e _clsk, liga as páginas da mesma visita e entrega gravações e mapas de calor completos.

  • Sessões inteiras, do primeiro ao último clique
  • Todos os recursos do Clarity funcionando
  • Integração com o Microsoft Ads, se o ad_storage também foi aceito
  • Depende de o sinal chegar logo após o script carregar

Visitante que recusou ou não respondeu

O Clarity carrega, mas sem cookies. Cada página vista vira um registro separado, e parte dos recursos não funciona.

  • Respeita a escolha do visitante
  • Ainda gera alguma informação sem cookie
  • Sessões picadas e funis incompletos
  • Nenhum dado compartilhado com o Microsoft Ads

Os três caminhos

Como enviar o sinal ao Clarity

A Microsoft aceita três formas. Use a que combina com o que o site já tem.

Consent Mode do Google

Indicado para sites que já usam o Consent Mode do Google. O Clarity reconhece os sinais sem configuração extra.

CMP compatível

Várias CMPs, como Cookiebot, CookieYes, Usercentrics e Axeptio, enviam o sinal ao Clarity sozinhas. É preciso ligar o modo de consentimento no projeto.

API consentv2

Para banners próprios ou CMPs sem integração. O site chama a API logo depois de o script do Clarity carregar.

Como implementar

Enviando o consentimento com a API consentv2

  1. Ligue o modo de consentimentoNo projeto do Clarity, abra Configurações e depois Configuração e desligue a gravação de cookies por padrão, para o Clarity esperar o sinal.
  2. Chame a API logo após o scriptA Microsoft orienta chamar a API de consentimento logo depois de o script do Clarity carregar e antes de qualquer cookie ser gravado.
  3. Envie os dois sinaisOs dois campos são obrigatórios: ad_Storage e analytics_Storage, cada um com granted ou denied, conforme a escolha no banner.
  4. Repita quando a escolha mudarSe o visitante recusar depois de aceitar, envie de novo com denied. O Clarity apaga os cookies e reinicia a coleta sem cookie.
  5. Confira o resultadoA documentação traz um comando de metadados que mostra no console o estado do consentimento lido pelo Clarity.
Exemplo baseado na documentação oficial da API consentv2
// Visitante aceitou tudo
window.clarity('consentv2', {
  ad_Storage: 'granted',
  analytics_Storage: 'granted'
});

// Visitante recusou tudo
window.clarity('consentv2', {
  ad_Storage: 'denied',
  analytics_Storage: 'denied'
});

Direitos do visitante

Retirar o consentimento e por quanto tempo ele vale

Enquanto o visitante não responde, o Clarity trata o consentimento como negado. Só depois de um sinal concedido ele passa a gravar cookies.

O consentimento vale por até 9 meses, a menos que o visitante mude a escolha antes ou que a configuração local peça um prazo menor. Depois disso, o site precisa perguntar de novo.

Se o visitante aceitar e depois mudar de ideia, o site precisa avisar o Clarity. Ao receber a recusa, o Clarity apaga os cookies que já tinha gravado, encerra a sessão atual e volta a coletar sem cookie.

A API antiga de consentimento ainda funciona, mas a Microsoft informa que ela será descontinuada e não deve mais ser usada em novas implementações. O caminho atual é a consentv2.

Fiscalização e AdSense

Quem cobra e como o Clarity convive com o Google

A cobrança técnica é da própria Microsoft. Sem um sinal válido, o Clarity limita os recursos para visitas do EEE, Reino Unido e Suíça. A documentação não fala em multa: o efeito é ter dados incompletos para esse tráfego.

A cobrança legal é das autoridades de proteção de dados europeias. Gravar cookies de análise sem consentimento, num site com visitantes europeus, pode ser questionado por elas como qualquer outro cookie não essencial.

Para quem tem AdSense ou Ad Manager, a boa notícia é que o Consent Mode do Google, enviado pela CMP certificada, também é lido pelo Clarity. Um único banner bem configurado pode atender Google e Clarity ao mesmo tempo.

Atenção: o Clarity e a tag UET do Microsoft Advertising são ferramentas diferentes. O sinal do Clarity não substitui o sinal que a UET precisa receber.

Erros comuns

O que faz o Clarity perder dados ou gravar sem permissão

Os erros aparecem dos dois lados: sinal que não chega e cookie gravado antes da hora.

Modo de consentimento desligado

O projeto continua gravando cookies por padrão. O Clarity não espera o sinal antes de gravar.

API chamada tarde demais

O sinal só é enviado muito depois de o script carregar. Parte da visita sai sem consentimento.

Só um dos dois sinais

O site envia analytics_Storage e esquece ad_Storage, ou o contrário. A API pede os dois.

Recusa não repassada

O visitante muda de ideia no banner, mas o Clarity não recebe a recusa e mantém os cookies.

API antiga em uso

O site ainda usa o comando de consentimento antigo, que a Microsoft planeja descontinuar.

Clarity antes da CMP

O script do Clarity carrega antes de a CMP existir na página, e nenhum sinal chega a tempo.

Na prática

O que pode e o que não pode com o Clarity

Exemplos práticos para editores que usam o Clarity para melhorar layout e anúncios.

Pode

  • Deixar o Clarity coletar sem cookie enquanto o visitante não responde
  • Usar o Consent Mode do Google que a CMP já envia
  • Usar uma CMP compatível com envio automático ao Clarity
  • Chamar a consentv2 com os dois sinais logo após o script
  • Perguntar de novo depois de 9 meses

Não pode

  • Gravar _clck e _clsk antes do clique no banner
  • Manter os cookies depois de uma recusa
  • Enviar só um dos dois sinais da consentv2
  • Usar a API antiga em implementações novas
  • Achar que o sinal do Clarity cobre a tag UET de anúncios

No ConsentMode

O que a auditoria confere sobre o Clarity

  • Detecta o script do Clarity e abre o site como visitante da Europa e de fora dela.
  • Verifica se os cookies _clck e _clsk aparecem antes do clique no banner.
  • Procura no código a chamada consentv2 ou o Consent Mode do Google que o Clarity lê.
  • Confere se a recusa no banner apaga os cookies do Clarity.
  • Entrega prints e o ajuste a fazer na CMP, no painel do Clarity ou no código.
Fazer uma auditoriaVer tudo o que é conferido

Perguntas frequentes

O Clarity para de funcionar sem consentimento?

Não. Ele carrega e coleta dados sem cookie. Mas as sessões ficam picadas e alguns recursos não funcionam para visitas das três regiões.

Meu site é brasileiro. Preciso disso?

A exigência do Clarity vale para visitas do EEE, Reino Unido e Suíça. Para o público brasileiro, a LGPD também pede transparência sobre cookies na política de privacidade.

Se eu já tenho o Consent Mode do Google, preciso fazer mais alguma coisa?

Segundo a Microsoft, o Clarity lê os sinais do Consent Mode do Google sem mudança extra. Confira mesmo assim se os cookies só aparecem depois do aceite.

O Clarity pode ser usado sem banner?

Fora das três regiões, a Microsoft não exige o sinal. Para visitantes europeus, sem banner o Clarity fica em modo sem cookie e as gravações perdem continuidade.

Clarity e UET são a mesma coisa?

Não. O Clarity é uma ferramenta de análise. A UET é a tag de conversões do Microsoft Advertising. Cada uma precisa do seu próprio sinal.

Como confiro o estado do consentimento?

A documentação do Clarity traz um comando de metadados que mostra o estado no console. Ou rode uma auditoria do ConsentMode, que confere os cookies antes e depois do clique.

Biblioteca

Fontes oficiais

Este guia foi escrito a partir destas páginas oficiais. Leia direto na fonte:

Descubra se o Clarity respeita a escolha dos visitantes

A auditoria abre o site como visitante europeu e mostra o que o Clarity grava antes e depois do banner.

Começar a auditoria