打开空间

指南 · Microsoft Clarity

Microsoft Clarity 与同意，分步讲解

Clarity 会录制会话并为您的网站创建热图。自 2025 年 10 月 31 日起，来自欧洲经济区、英国和瑞士的访问需要有效的同意信号，Clarity 才能完整运行。下面介绍发送该信号的三种方式以及最常见的错误。

检查我网站上的 Clarity阅读指南
  • ✓基于 Clarity 的官方文档
  • ✓可直接复制的代码
  • ✓只读取，不修改网站
2025年份：Clarity 自 10 月 31 日起开始要求该信号
3有要求的地区：欧洲经济区、英国和瑞士
2Clarity 读取的同意类型：analytics_storage 和 ad_storage
9同意的最长有效月数，除非在此之前发生变更

是什么

Microsoft 录制工具的同意通知

Microsoft Clarity 是一款免费的行为分析工具。它显示热图、会话录制，以及访客在哪里点击、滚动或离开。许多发布商用 Clarity 来改进版面和广告位置。

为了做到这一点，Clarity 使用自己的 Cookie 来关联同一次访问中的各个页面。在欧洲，写入这些 Cookie 需要事先取得访客的同意。

因此，Microsoft 在 Clarity 中创建了同意模式。自 2025 年 10 月 31 日起，来自欧洲经济区、英国和瑞士的访问必须带有有效的同意信号，Clarity 才能完整运行。

没有信号时，Clarity 不会完全停止。它仍会加载，但不带 Cookie，且功能受限。问题在于报告不完整，会话也会被切碎。

清单

你需要做到的事项

如果网站使用 Clarity，并接待来自欧洲经济区、英国或瑞士的访问，这些要点必须到位。

  1. 适用于欧洲经济区、英国和瑞士的有效信号

    自 2025 年 10 月 31 日起，来自这些地区的访问必须带有有效的同意信号。没有信号时，Clarity 不会写入 cookie，并会限制录制和漏斗等功能。

  2. 在项目中开启同意模式

    Microsoft 要求在使用任何 CMP 之前，先开启 Clarity 的同意模式。每个 Clarity 项目都需要各自的信号。

  3. 在脚本之后立即调用 API

    使用自有横幅时，要在 Clarity 脚本加载之后、任何 cookie 之前，立即调用 consentv2 API。两个字段都是必填的。

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

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

  4. 把 Clarity 的 cookie 归为非必要

    在横幅中，Clarity 的 cookie 必须放在非必要类别里。这样它们只会在访客接受之后才被写入。

    示例

    把 _clck 和 _clsk 放在横幅的“分析”类别中，绝不要放在“必要”类别里。

  5. 告知访客有关 cookie 的信息

    Microsoft 表示，您需要告知访客 Clarity 使用的 cookie。

    示例

    我们使用 Microsoft Clarity 和 cookie _clck、_clsk，来了解访客如何使用网站。

  6. 访客反悔时要通知

    如果访客在接受之后又拒绝，请发送拒绝的信号。Clarity 会删除它已经写入的 cookie。

  7. 不要对 18 岁以下的访客使用 Clarity

    Microsoft 表示，Clarity 不应用于面向 18 岁以下用户的网站或应用。

  8. 经 Google 认证、用于广告的 CMP

    对于 Google 个性化广告，欧洲经济区和英国自 2024 年 1 月 16 日起要求使用通过 TCF 认证的 CMP，瑞士自 2024 年 7 月 31 日起要求。

    示例

    Clarity 会读取 Google 的 Consent Mode，所以同一个认证横幅可以同时满足两边。

实际案例

正确与错误示例

官方工具

经认证的 CMP 与官方链接

Microsoft 发布了会自动把信号传给 Clarity 的 CMP 列表，Google 则维护适用于欧洲经济区、英国和瑞士的认证 CMP 列表。

适用对象

谁需要调整 Clarity

这条规则来自 Microsoft 自己，适用于任何有来自这三个地区访问的 Clarity 项目。

安装了 Clarity 的网站

任何使用 Clarity 并接收来自欧洲经济区、英国或瑞士访问的网站，都需要发送该信号。

将 Clarity 连接到 Microsoft Ads 的人

广告信号决定 Clarity 是否可以与 Microsoft Advertising 共享数据。

使用 Google Consent Mode 的网站

Clarity 会自动读取 Google 的 Consent Mode 信号。对这类网站来说，需要调整的地方通常很少。

这三个地区以外

同意模式默认仅对欧洲经济区、英国和瑞士开启。LGPD 等当地法律仍然适用。

定义

Clarity 文档中的术语

这些名称出现在面板、代码和 Microsoft 的指南中。

analytics_storage

同意存储分析数据，例如网站使用情况和交互模式。拒绝时，Clarity 只收集不带 Cookie 的数据。

ad_storage

同意与广告相关的数据。拒绝时，Clarity 不与 Microsoft Ads 共享数据。

无 Cookie 模式

没有同意时，Clarity 会为每次页面浏览创建一个新的标识符，且不写入 Cookie 来关联访问。

Cookie _clck 和 _clsk

Clarity 自己的 Cookie。当访客在接受之后又拒绝时，它们会被删除。

consentv2 API

通过自有横幅或没有集成的 CMP 发送这两个信号的官方指令。

面板中的同意模式

项目配置，Clarity 会在写入 Cookie 之前等待有效的信号。

有信号与无信号

Clarity 在每种情况下会怎么做

差异直接体现在录制和热图报告中。

已接受的访客

Clarity 写入 _clck 和 _clsk Cookie，关联同一次访问的页面，并提供完整的录制和热图。

  • 完整的会话，从第一次点击到最后一次点击
  • Clarity 的所有功能都在运行
  • 如果 ad_storage 也被接受，则与 Microsoft Ads 集成
  • 取决于信号是否在脚本加载后立即到达

已拒绝或未回应的访客

Clarity 会加载，但不带 Cookie。每次页面浏览成为一条单独的记录，部分功能无法使用。

  • 尊重访客的选择
  • 仍会产生一些不带 Cookie 的信息
  • 会话被切碎，漏斗不完整
  • 不会向 Microsoft Ads 共享任何数据

三条路径

如何向 Clarity 发送信号

Microsoft 接受三种方式。请使用与网站现有设置相匹配的那一种。

Google Consent Mode

适用于已经使用 Google Consent Mode 的网站。Clarity 无需额外配置即可识别这些信号。

兼容的 CMP

Cookiebot、CookieYes、Usercentrics 和 Axeptio 等多个 CMP 会自动向 Clarity 发送信号。需要在项目中开启同意模式。

consentv2 API

适用于自有横幅或没有集成的 CMP。网站在 Clarity 脚本加载之后立即调用该 API。

如何实施

使用 consentv2 API 发送同意

  1. 开启同意模式在 Clarity 项目中，打开“设置”，再打开“配置”，并默认关闭 Cookie 的写入，让 Clarity 等待信号。
  2. 在脚本之后立即调用 APIMicrosoft 建议在 Clarity 脚本加载之后、任何 Cookie 写入之前，立即调用同意 API。
  3. 发送两个信号两个字段都是必填的：ad_Storage 和 analytics_Storage，各取 granted 或 denied，取决于横幅中的选择。
  4. 在选择变化时重复发送如果访客在接受之后又拒绝，请再次发送 denied。Clarity 会删除 Cookie 并重新开始不带 Cookie 的收集。
  5. 检查结果文档提供了一条元数据命令，可在控制台中显示 Clarity 读取到的同意状态。
基于 consentv2 API 官方文档的示例
// Visitante aceitou tudo
window.clarity('consentv2', {
  ad_Storage: 'granted',
  analytics_Storage: 'granted'
});

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

访问者的权利

撤回同意及其有效期

在访客回应之前，Clarity 将同意视为拒绝。只有在收到授予信号之后，它才会开始写入 Cookie。

同意最长有效 9 个月，除非访客在此之前更改选择，或当地配置要求更短的期限。之后，网站必须再次询问。

如果访客接受之后又改变主意，网站必须通知 Clarity。收到拒绝后，Clarity 会删除已写入的 Cookie，结束当前会话，并重新开始不带 Cookie 的收集。

旧的同意 API 仍然可用，但 Microsoft 表示它将被停用，不应再用于新的实施。目前的方式是 consentv2。

执法和 AdSense

谁来执行，以及 Clarity 如何与 Google 共存

技术层面的约束来自 Microsoft 自己。没有有效信号时，Clarity 会限制来自欧洲经济区、英国和瑞士访问的功能。文档中没有提到罚款：影响是这部分流量的数据不完整。

法律层面的约束来自欧洲的数据保护机构。在有欧洲访客的网站上未经同意写入分析 Cookie，可能像其他任何非必要 Cookie 一样受到他们的质疑。

对使用 AdSense 或 Ad Manager 的人来说，好消息是：由认证的 CMP 发送的 Google Consent Mode，Clarity 也会读取。一个配置良好的横幅就可以同时满足 Google 和 Clarity。

注意：Clarity 与 Microsoft Advertising 的 UET 标签是不同的工具。Clarity 的信号不能代替 UET 需要收到的信号。

常见错误

什么会让 Clarity 丢失数据或未经许可就录制

错误出现在两个方面：信号没有到达，以及 Cookie 写入得过早。

同意模式已关闭

项目默认仍在写入 Cookie。Clarity 在写入之前不会等待信号。

API 调用得太晚

信号在脚本加载很久之后才发送。部分访问在没有同意的情况下就结束了。

只有两个信号中的一个

网站发送了 analytics_Storage 却忘了 ad_Storage，或者相反。该 API 要求同时提供两者。

拒绝没有被传递

访客在横幅中改变了主意，但 Clarity 没有收到拒绝，仍保留着 Cookie。

仍在使用旧 API

网站仍在使用旧的同意指令，而 Microsoft 计划将其停用。

Clarity 先于 CMP 加载

Clarity 脚本在页面上出现 CMP 之前就已加载，没有信号能及时到达。

实际案例

使用 Clarity 时的允许与不允许

适用于使用 Clarity 来改进版面和广告的发布商的实用示例。

可以

  • 在访客回应之前，让 Clarity 不带 Cookie 地收集
  • 使用 CMP 已经发送的 Google Consent Mode
  • 使用能自动向 Clarity 发送信号的兼容 CMP
  • 在脚本之后立即以两个信号调用 consentv2
  • 9 个月后再次询问

不可以

  • 在点击横幅之前写入 _clck 和 _clsk
  • 拒绝之后仍保留 Cookie
  • 只发送 consentv2 两个信号中的一个
  • 在新的实施中使用旧 API
  • 以为 Clarity 的信号涵盖了广告的 UET 标签

在 ConsentMode 中

审核会针对 Clarity 检查什么

  • 检测 Clarity 脚本，并分别以欧洲访客和非欧洲访客的身份打开网站。
  • 验证 _clck 和 _clsk Cookie 是否在点击横幅之前出现。
  • 在代码中查找 consentv2 调用，或 Clarity 读取的 Google Consent Mode。
  • 检查在横幅中拒绝是否会删除 Clarity 的 Cookie。
  • 提供截图，以及需要在 CMP、Clarity 面板或代码中进行的修复。
开始审核查看所有检查项

常见问题

没有同意时 Clarity 会停止工作吗？

不会。它会加载并收集不带 Cookie 的数据。但会话会被切碎，对于来自这三个地区的访问，部分功能将无法使用。

我的网站在巴西。我需要这个吗？

Clarity 的要求适用于来自欧洲经济区、英国和瑞士的访问。对巴西的受众，LGPD 也要求在隐私政策中对 Cookie 保持透明。

如果我已经有 Google Consent Mode，还需要做其他事情吗？

据 Microsoft 称，Clarity 无需额外更改即可读取 Google Consent Mode 的信号。尽管如此，仍请检查 Cookie 是否只在接受之后才出现。

没有横幅可以使用 Clarity 吗？

在这三个地区之外，Microsoft 不要求该信号。对欧洲访客来说，没有横幅时 Clarity 处于无 Cookie 模式，录制会失去连续性。

Clarity 和 UET 是一回事吗？

不是。Clarity 是分析工具。UET 是 Microsoft Advertising 的转化标签。它们各自需要自己的信号。

我如何检查同意状态？

Clarity 的文档提供了一条在控制台中显示状态的元数据命令。或者运行 ConsentMode 的审核，它会检查点击前后的 Cookie。

资料库

官方来源

本指南根据以下官方页面编写。请直接阅读原文：

了解 Clarity 是否尊重访客的选择

审核会以欧洲访客的身份打开网站，并显示 Clarity 在横幅之前和之后记录了什么。

开始审核