安装
每个页面只放下面这一行。YOUR_ORIGIN 换成你的收数域名，YOUR_SITE_KEY 换成站点标识。
html
<script async src="https://YOUR_ORIGIN/w.js" data-site="YOUR_SITE_KEY"></script>同一页再放一次会被忽略。客服组件由这段脚本按需去拉同目录的 w-chat.js，不要再贴第二段，见 客服组件 w-chat.js。
初始化
没有单独的初始化函数。存在 data-site 时，脚本在文档就绪后发送第一次浏览，并挂钩后续的地址变化。哈希路由在同一标签上加 data-hash="true"。要自己发浏览时加 data-auto-track="false"。
页面浏览
自动采集打开时，首次进入和后续地址变化都会发浏览，同一地址不重复发。需要补发时调用 webcount.pageview()。单页应用见 页面浏览与 SPA。
事件
js
webcount.track('purchase', { revenue: 19.9, currency: 'CNY' });名称最长 100 个字符。属性最多 20 个，键最长 50，字符串值最长 200，只保留字符串、数字和布尔。
身份
核心对象一开始只有 track 和 pageview。项目处于识别模式时，第一次浏览的响应会再加载同目录的 w-id.js，随后可以调用：
js
webcount.login('USER_ID', { plan: 'pro' }, { type: 'login' });
webcount.logout();邮箱和手机号会先做哈希。标识为空、超过 200 个字符或属于占位词时，调用直接返回。识别档位的说明见 身份关联。
限制
| 项目 | 默认 | 说明 |
|---|---|---|
| 隐私信号 | 遵守 | 浏览器开启请勿跟踪或全球隐私控制时不采集；加 data-respect-dnt="false" 可关闭 |
| 本机访问 | 跳过 | localhost、127.* 等本机主机名不上报；加 data-allow-local="true" 或显式 data-api 时照常上报 |
| 脚本异常 | 静默 | 内部错误不抛到页面上 |
错误
缺少 data-site 时脚本直接退出，网络里看不到请求。采集接口收下请求也不等于已经入库，到实时报表里核对，见 验证安装。