首页 › 使用指南

PVUV.ai 使用指南

站长需要的一切，按顺序来：创建账号、添加站点、安装统计代码、看懂数据面板、衡量目标与漏斗、分享你想分享的数据，再让你的 AI 助手直接用上这些数字。

指南 · 2026 年 10 月更新 · 约 10 分钟读完

1. 你的账号

打开登录页，选择 Google 或 Web.Cafe。第一次登录时账号自动创建，不用再填任何资料。

  • 你添加的每个站点都属于这个账号。站点、漏斗和令牌只出现在你自己的面板里，其他用户看不到。
  • 每种登录方式各是一个独立账号：用 Google 登录和用 Web.Cafe 登录会得到两个不同的账号，即使邮箱相同也不会合并——请始终用同一种方式登录。
  • 一个账号最多可以添加 100 个站点。

绑定两种登录方式。在 ⚙ 设置 → 登录方式里，Google 账号可以绑定 Web.Cafe，Web.Cafe 账号也可以绑定 Google；绑定后用任一方式登录都会进入同一个账号。如果要绑定的账号已经有站点或 API 令牌，系统会先请你确认，确认后它们会转移到当前账号——此操作无法撤销。

2. 添加站点

在站点列表页点击添加站点：

  1. 域名——网站的主机名，用逗号分隔（例如 example.com, www.example.com, blog.example.com）。统计代码只接收来自这些域名的数据。
  2. 站点名称——在面板里显示的名字。
  3. 更多选项：时区（日期和报表按它切分，创建后不能修改）、广告防护模式（先保持关闭，见广告防护）和参与阈值（访问停留多少秒算“有参与”，默认 15 秒）。

如果添加的是你已经在统计的域名，会直接打开那个站点，不会重复创建。

3. 安装统计代码

站点创建后会给出一段已填好站点 ID 的代码。把它粘贴到每个页面的 <head> 里（大多数框架放在公共布局里即可）：

<script defer
  src="https://www.pvuv.ai/f.js"
  data-api="https://in.pvuv.ai"
  data-site="YOUR_SITE_ID"></script>

打开一次你的网站，几秒内就能在面板的实时人数里看到这次访问。

可选参数

  • 单页应用（React、Vue、Next.js 等）自动统计——每次路径变化算一次浏览。data-spa="true" 连查询参数的变化也算；data-spa="false" 关闭路由统计。
  • data-exclude="/admin/*" 跳过不想统计的页面。
  • data-sensors="off" 关闭移动端传感器的粗粒度信号。
  • data-downloads="off" 不自动记录文件下载事件。

看不到数据？检查页面域名是否在站点的域名列表里、脚本是否被你的内容安全策略（CSP）拦截，以及安装后是否重新打开过页面。

4. 看懂数据面板

在站点列表里点开一个站点。顶部依次是站点切换、最近在线人数、筛选和时间范围。

  • 最近在线人数默认统计最近 5 分钟见到的人，点击可切换到 10 或 30 分钟，标签上会写明当前是多久。
  • 访客数只算真人——bot 和爬虫不计入，卡片上会注明排除了多少。旁边是浏览量、会话数、跳出率、访问时长和真人占比，每项都和上一周期对比。
  • 下方依次是趋势图、来源（或渠道）、页面（入口页、退出页、404）、地区、设备、推广活动（UTM）和目标。
  • 点任意一行，整个面板就按它筛选；+ 筛选可以按“是”“不是”“包含”叠加条件。

标签页：概览、漏斗（漏斗与埋点健康检查）、可疑流量（逐个高分访客及原因）、广告防护、Web Vitals（真实用户的页面加载速度）和 AI 报告。⋯ → 访客旅程可以逐页回放单个访客做了什么。

5. Bot、爬虫与假冒爬虫

每次访问都有一个 0–100 的分数和一个判定：

  • 干净——真人。可疑——计入统计，但做了标记（琥珀色：不确定，并非定论）。
  • Bot——自动化流量，不计入访客数。
  • 爬虫——搜索引擎、链接预览或 AI 爬虫，单独统计。爬虫分类面板会列出每个爬虫的名字（Googlebot、Bingbot、GPTBot、facebookexternalhit 等），并用其运营方公布的 IP 段逐一核验。
  • 假冒爬虫——自称 Googlebot 或 GPTBot，IP 却不在对应运营方公布的 IP 段内。它计为 bot，并在流量质量图、筛选和访客列表里单独显示。

流量健康条会显示每个告警指标的当前值和离阈值还有多远，数字在变成问题之前你就能看到它在上升。

6. 目标、事件与收入

浏览之外的任何事件都算目标。有三种发送方式：

不写代码

<button data-pvuv-event="signup_click" data-pvuv-plan="pro">注册</button>

用 JavaScript

window.pvuv && window.pvuv('event', 'purchase', { revenue: 29, currency: 'USD', plan: 'pro' });
window.pvuv && window.pvuv('identify', internalUserId);   // 登录后调用；用内部 ID，不要用邮箱
window.pvuv && window.pvuv('set', { variant: 'b' });       // 给之后的所有事件带上这个属性

从服务端上报

注册、付款等后端确定发生的事，可以用服务端上报令牌（见 API 令牌）调用 POST https://api.pvuv.ai/v1/sites/<site_id>/events。带上访客的 _pv_id Cookie 或传给 identify 的 ID，事件就会接入该访客的旅程和漏斗，广告拦截和关闭页面都不会让它丢失。

外链点击、文件下载和 404 页面会自动记录。其他币种的收入会自动换算成美元。

7. 漏斗与埋点健康检查

在漏斗标签页里，用步骤搭建漏斗——步骤可以是页面（/pricing、/docs/*）或事件（signup）。每一步都可以：

  • 设置备选（“或”：几个页面或事件中任意一个即可）；
  • 加属性条件（例如 plan 是 pro）；
  • 限定时间窗口（比如整个漏斗要在 30 分钟内完成）。

按来源、设备或某个属性拆分漏斗，就能看到每一类人在哪一步流失，然后保存漏斗。系统还会根据你的网站已经发送的事件推荐漏斗。

漏斗下方的埋点健康检查会把网站实际发送的数据和埋点计划对照：计划了却从没收到的事件、没人计划过的事件、缺失的属性、从不触发的漏斗步骤，以及没能关联到访客的服务端事件。

比赛活动

平台会不定期举办流量比赛：各站点在指定日期内比拼真人访客数和真人浏览量。进行中的比赛会显示在站点列表页的 比赛活动区块——选一个站点，点用这个站点报名。每个报名都由管理员审核，通过后站点会出现在公开的比赛页面。

参加活动需要绑定 Web.Cafe 账号（或直接用 Web.Cafe 登录），这样主办方才知道每个网站属于哪位会员；在 ⚙ 设置 → 登录方式里绑定。

公开页面只显示部分隐藏的域名和你的昵称，不会显示站点 ID。昵称在 ⚙ 设置 → 公开昵称里设置；没设置时使用 Web.Cafe 昵称。Google 账号的名字一律不显示。bot、爬虫和假冒爬虫一律不计。你可以随时退出比赛。

完整排行榜（所有站点的数据、各项排序和 Bot 占比）只对参赛者（有站点审核通过的站长）开放；其他人只能看到真人访客和真人浏览量的前三名，其余数据都会打码。

8. 分享与导出

  • ⋯ → 分享链接：为一个站点生成只读的公开面板，拿到链接的人都能查看；关闭即可撤销。
  • ⋯ → 嵌入代码：把这个面板嵌到其他页面里。
  • ⋯ → 下载数据：导出面板上显示的数据。

9. 接入你的 AI

在站点里点 ⋯ → 接入 AI，选择它能做什么——只读取这个站点的数据，或读取数据，并可保存漏斗、创建服务端上报令牌——然后点创建连接。对话框会给出 Claude Code、Claude Code（网页版）、Cursor 和 Codex 的具体配置方法；其他 MCP 客户端用同样的地址和令牌即可。

接好以后直接问，比如：

  • “这个月从定价页到注册，访客在哪一步流失最多？”
  • “和上周比有什么变化，为什么？”
  • “昨天的流量里有多少是 bot，从哪来的？”
  • “对照埋点计划检查我们的埋点，把这个仓库里缺的补上。”

覆盖全部站点的连接（在 ⚙ 设置 → API 令牌里创建）还能列出你的所有站点，并按域名新建站点——让 AI 给新项目配好统计时很方便。

令牌只显示一次。不要把它提交到代码仓库：配置说明会把它放在你的用户配置或环境变量里。

10. API 令牌

站点列表页的 ⚙ 设置 → API 令牌会列出所有令牌，也可以新建，选择范围（单个站点或全部站点）和用途：

  • AI 助手 / 命令行——只读。
  • AI 助手——读取、编辑漏斗、创建站点。
  • 服务端上报——只能上报服务端事件和爬虫访问，不能读取任何数据。

令牌只显示一次，只以哈希形式存储，随时可以撤销。同一个令牌可用于 MCP 服务、REST API 和命令行工具，详见 API 文档（英文）。

11. 上报 AI 爬虫（可选）

ChatGPT、Perplexity 和 Claude 抓取页面时不执行 JavaScript，统计代码看不到它们。你的服务端可以上报这些抓取；面板上的 AI 助手与爬虫区块随后会显示每个 AI 读了哪些页面（已用其公布的 IP 段核验），以及它带回来的访客。共三步：

  1. 创建令牌。⚙ 设置 → API 令牌，范围选这个站点，用途选服务端上报。它只能上报爬虫访问，不能读取任何数据。把它作为密钥存在服务端，例如 PVUV_INGEST_TOKEN，同时设置 PVUV_SITE = 你的站点 ID（数据面板地址里 id= 后面那串）。
  2. 加上上报代码。最省事的做法是在网站项目里把下面这段话交给你的 AI 编程助手（Claude Code、Cursor、Codex 等）： 
    按照 https://api.pvuv.ai/docs/crawler-sync.md 给这个网站加上 pvuv.ai 爬虫上报。
站点 ID：你的站点ID。令牌在环境变量 PVUV_INGEST_TOKEN 里。
    这份指南里有现成代码，覆盖 Next.js（Vercel 或自部署）、Cloudflare Workers / Pages、Node / Express 和其他服务端。代码在响应发出后才上报，不会拖慢页面，也不会导致页面出错。
  3. 部署并验证。部署后，用爬虫的身份访问一个页面： 
    curl -A "ChatGPT-User/1.0" https://你的网站.com/
    刷新数据面板，会看到一条冒充的 ChatGPT-User 访问——这是对的，因为请求来自你的电脑，而不是 OpenAI 的地址。之后真实的 AI 访问会显示为已核验。

如果你已经通过 MCP 接入了 AI 助手，也可以直接对它说“帮我的网站设置爬虫上报”，它会自己创建令牌并按同一份指南操作。

12. 广告防护（可选）

广告防护只对判定为可信的流量加载广告代码。它默认关闭：

  1. 先观察一周，了解你的网站正常是什么样子。
  2. 打开广告防护标签页：它会根据你自己的流量，估算每一档会拦截多少浏览、误伤率是多少。
  3. 选一档（通常“均衡”就合适），在统计代码里加上 data-adguard 和 data-adclient。新的防护设置会先进入影子模式——只记录判断、广告照常加载——之后才真正生效。

它的设计是“出错即放行”：任何环节出问题，广告都会照常加载。

13. 语言、主题与时区

  • 语言：English、中文、日本語、한국어、Deutsch、Français、Español，在语言菜单里切换。
  • 主题：默认跟随系统，也可以选亮色或暗色——在语言菜单旁边（站点页在 ⋯ 菜单里）。
  • 时区：账号默认时区在 ⚙ 设置里；每个站点保持创建时选定的时区。

14. 隐私与用户同意

IP 地址只以截断哈希存储，设备指纹只存哈希和结论，爬虫的 IP 只用于核验、从不存储。在你的网站上，第一方 Cookie 保存访客标识、会话和首次来源归因，localStorage 也可能保存访客标识。在 GDPR/ePrivacy 适用的地区，这可能需要取得访客同意——作为站长，由你决定；data-sensors="off" 可以减少采集。详见隐私政策。

常见问题

为什么我的数字比 Google Analytics 低？

这里的访客只算真人：bot、爬虫和假冒爬虫都单独统计，不混在一起。广告拦截、Cookie 同意设置和会话规则不同，也会让任何两个工具的数字有差异。

别人能统计我的域名吗？

其他账号也可以添加同一个域名，但每个账号只能看到自己站点的数据，而且数据只会从站点列出的域名接收。

怎么删除令牌或停止分享？

在 ⚙ 设置 → API 令牌里撤销令牌；在 ⋯ → 分享链接里关闭分享。

收费吗？

免费——统计、漏斗、bot 识别、爬虫核验和广告防护都免费，最多 100 个站点。只有可选的 AI 报告是付费附加功能。你也可以自部署开源的单租户版本。