仓库里没有 WordPress、Shopify 或其他建站工具的插件,也不要再找名为 TapCub 的插件。方法与普通网站相同,完整说明见 JavaScript(w.js)。
安装
html
<script async src="https://YOUR_ORIGIN/w.js" data-site="YOUR_SITE_KEY"></script>| 工具 | 放置位置 | 注意 |
|---|---|---|
| WordPress | 主题头部或页眉自定义 HTML | 全站模板只放一次 |
| Shopify | 主题布局的 head | 结账页若被平台隔离,这段脚本到不了那里 |
| Webflow / Wix | 站点级自定义代码 | 选全站,不要按单页重复贴 |
Hexo、Hugo、Jekyll、Ghost、Typecho 同样把这一行放进全站模板。
初始化
脚本自己启动。主题如果用哈希路由,在同一标签上加 data-hash="true"。后台预览、草稿地址可以用同一标签上的 data-exclude 排除,例如 data-exclude="/admin/*,/preview"。
页面浏览
脚本会在首次打开和站内地址变化时发送浏览。单页主题见 页面浏览与 SPA。
事件
js
webcount.track('purchase', { revenue: 19.9 });前端调用只适合按钮点击这类浏览侧动作,订单金额更适合由服务端上报,见 服务端事件与日志导入。
身份
会员登录成功后在浏览器里调用 webcount.login,服务端模板渲染时没有 webcount。方法要等身份脚本加载。
限制
属性最多 20 个,事件名最长 100 个字符。本机预览默认不上报。
错误
预览里没有请求时,先看公共头部是否真的输出了这段脚本,以及 data-site 是否还是占位符。主题如果按页面缓存了 HTML,改完头部要清一次缓存再看。采集被收下也不等于已经入库,按 验证安装 到实时报表核对。客服不要再贴第二段脚本,见 客服组件 w-chat.js。