Microsoft Clarity
真实访客在每个页面上的行为,与抓取结果关联:Neova 读取您的 Microsoft Clarity 项目,把无效点击、愤怒点击、快速返回和 AI 引用变成标记、列和工单优先级。
Clarity 记录人们如何使用网站:点击哪里、滚动多远、何时离开。抓取看到的是服务器发送的内容;Clarity 看到的是访客如何使用这些内容。两者结合,Neova 就能指出真实用户遇到了哪些问题,以及应该先修复哪些页面。
带来什么
- 11 个检查项自成一个分类访客行为,在侧边栏中有自己的页面。
- 优先级:如果工单涉及的页面有真实访问,或在 AI 回答中被引用,工单就会升一级,并说明原因。所有标记按访问排序。
- 列:所有 URL 中的访问(Clarity)和摩擦;列中的滚动深度、参与时间、AI 引用和 AI 机器人请求;每个页面的详情中也有同样的数字。
- 仪表盘:访客摩擦(访问、每 100 个会话的摩擦、问题最多的页面、每天的会话数)和在 AI 回答中被引用的页面。
- 愤怒点击访客反复点击同一个位置
- 无效点击访客点击了没有任何反应的地方
- 快速返回访客立即离开页面
- 过度滚动访客上下滚动寻找内容
- JavaScript 错误脚本在访客的浏览器中出错
- 滚动深度低访客看到的内容不到页面的四分之一
- 有访问,但从未被抓取有人访问了没有任何链接指向的页面
- 有访问,但已损坏有人进入了返回错误的页面
- 在 AI 回答中被引用,但已损坏AI 助手引用的页面已损坏、被重定向或不可索引
- AI 机器人访问失效 URLAI 爬虫不断请求返回错误的地址
- 手机上的摩擦手机上的摩擦至少是桌面端的两倍
页面在最近 28 天内至少有 30 个会话,才会按摩擦来判断:寥寥几次访问不构成标记。摩擦是指页面每 100 个会话中的无效点击、愤怒点击和快速返回。
连接项目
- 在 Microsoft Clarity 中打开该网站的项目。只有项目管理员才能创建令牌。
- 依次打开 Settings、Data Export、Generate new API token。
- 为它命名,例如
Neova(4 到 32 个字母、数字、连字符、下划线或句点,不能有空格),然后复制令牌。 - 在 Neova 中:设置、连接、Microsoft Clarity、连接…,粘贴令牌,然后点 保存。
Neova 用一次请求检查令牌,根据返回结果中的页面识别网站,并保存最初的 3 天数据。每个 Clarity 项目一个令牌:其他网站各用一次添加项目…。令牌保存在您电脑的钥匙串中。如果有访问权限的人离开了项目,Microsoft 建议重新创建令牌。
Neova 如何读取
Microsoft 的 Data Export API 限制很严,所以 Neova 自己保存历史数据:
- 每天一次,在 Neova 的计划任务运行时,读取每个已连接项目当天的数据并保存在您的电脑上。只有当天的数据尚未保存时,抓取才会自己去读取 Clarity。
- 每次抓取使用最近 28 天的数据:访问量相加,滚动深度和参与时间按访问量加权。新连接从 3 天开始,每天增加一天。
- 只读取每个页面的数字:不读取录像,不读取单次访问,也不读取任何能识别访客身份的信息。
- 测试连接不发送任何请求:它只显示已保存的内容,因此每天 10 次的额度都留给每日读取。
AI Visibility
Clarity 的 AI Visibility 显示 AI 助手在回答中引用了哪些页面,以及 AI 机器人请求了哪些 URL。Neova 用同一个令牌读取这两项最近 28 天的数据,并与抓取结果关联:被引用的页面已损坏或被重定向,AI 机器人把访问花在了错误页面上。需要先在 Clarity 中完成两项设置:
- 引用需要先在 Clarity 的 AI Visibility 中验证网站的域名。
- 机器人活动需要在 Clarity 的 AI Visibility 设置中连接 CDN(Clarity 列出的有 Azure、Akamai、Fastly、Cloudflare、CloudFront 和 WordPress)。
没有这两项设置时,这两项检查会说明缺少什么;其余九项照常运行。
没有令牌?导入文件
如果公司规定不允许 Neova 连接,可以改为导入 Clarity 的数据:设置、连接、通过文件导入 Search Console、Analytics、Bing 和 Clarity。Neova 读取哪些内容,分步说明。
Clarity 的限制和步骤来自 Microsoft 的 Data Export API 页面,2026年11月19日查阅。Microsoft 和 Clarity 是 Microsoft 的商标;Neova Labs 与 Microsoft 无关联,也未获得其认可或赞助。NEOVA™ 是 Neova LLC 的商标。