本页目录
  1. 开始之前
  2. 第一步：创建项目
  3. 第二步：登记网站域名
  4. 第三步：把脚本放进页面
  5. 第四步：打开自己的网站看一眼
  6. 单页应用不用额外配置
  7. 本地调试
  8. 下一步

整个过程一般不超过十分钟，不需要改后端，也不需要重新部署整站，只要你能改页面模板（或者网站后台有「自定义头部代码」之类的入口）。

开始之前

  • 一个能访问的网站域名。localhost 和直接双击打开的本地文件默认不会上报，见文末「本地调试」。
  • 修改页面 <head> 的权限。用建站平台的话，找「统计代码」「第三方代码」或「自定义 HTML」这类设置项。

第一步：创建项目

注册后控制台会引导你新建项目。项目是一套独立的数据和成员：同一个项目里可以同时放网站、App 和小程序，报表按项目汇总。

建项目时要选时区。报表里的「今天」「昨天」按这个时区切分，而不是按你电脑的时钟。团队在国内就选北京时间，主要市场在美国就选对应的美国时区，事后也能改，但改了以后每天的切分边界会跟着变。

第二步：登记网站域名

打开「网站统计 › 配置 › SDK 代码」，添加你的网站域名。注意三点：

  1. 只填主机名，比如 shop.example.com，不要带 https://，也不要带路径。
  2. 子域名会自动放行。登记了 example.com，www.example.com 和 blog.example.com 的访问也会收下。
  3. 没登记的域名发来的数据会被直接丢弃。这是为了防止别人把你的站点标识贴到他们的网站上，往你的报表里灌数据。

第三步：把脚本放进页面

同一页上会显示一段已经填好站点标识的代码，形如：

<script defer src="https://static.pathclue.com/client.js" data-site="你的站点标识"></script>

把它放进每个页面的 <head> 里。大多数网站有一个公共的头部模板，放一次就覆盖全站。

几个常见疑问：

  • data-site 的值要保密吗？ 不用。它只是告诉采集端「这条数据属于哪个项目」，本来就会出现在网页源码里。真正需要保密的是服务端接口用的 API 密钥，那个不会出现在页面上。
  • defer 能去掉吗？ 不建议。defer 让脚本在页面解析完之后才执行，不会拖慢首屏。
  • 放了两份会重复计数吗？ 不会。只有第一份生效，后加载的那份发现已经有一份在运行就直接退出。不过还是建议清理掉多余的一份，免得以后改属性时改错。

第四步：打开自己的网站看一眼

用已经登记的域名访问任意一页，然后回到控制台打开「网站统计 › 实时」。通常几秒内就能看到这次访问，路径和页面标题都应该和你刚打开的一致。

如果一分钟后还是空的，按 装好了却看不到数据 里的顺序排查，十有八九是域名没对上或者浏览器开了「请勿跟踪」。

单页应用不用额外配置

用 Vue Router、React Router、Next.js、Nuxt 这类框架做的站点，路由切换走的是浏览器的 History 接口，脚本会自动跟上，每切换一次记一次页面浏览。只有用 #/ 形式的 hash 路由时，才需要在脚本上加一个属性，见 单页应用与 hash 路由。

本地调试

在 localhost、127.0.0.1 这类地址上，脚本默认不发送任何数据，避免开发时的刷新把报表弄乱。确实要在本地验证时，在脚本上加 data-allow-local="true"，并且只在本地环境的模板里加，别带到线上。

下一步

本主题下一篇装好了却看不到数据：按顺序排查