网站接入指南：3 分钟给网站加访问统计代码

接入小葱计数器只需要三件事：创建站点拿密钥、把统计代码粘到网站 head 里、访问一个页面验证上报。整个过程不改服务器配置，不需要装插件。

一、创建站点并拿到密钥

登录面板，进入「站点」页
点击「创建站点」，填写站点名称与域名
复制生成的埋点密钥，形如 xk_3b8ecf1e1b360b6a1cde9d2e4649e23b

密钥等同密码，只放在服务端或页面配置里，不要提交到公开的 Git 仓库。域名白名单填了之后，非白名单域名的上报会被拒绝。

二、插入统计代码

把下面这段放进网站 <head> 内（或 </body> 之前），s.src 换成你的计数器域名：

<script>
  window.小葱计数器 = { 站点密钥: 'xk_你的密钥' };
  (function(d,s){
    s=d.createElement('script');
    s.src='https://js.7w4.net/sdk.js';
    s.async=true;
    d.head.appendChild(s);
  })(document);
</script>

关键点只有一个：配置对象必须写在脚本之前。SDK 加载后会读取这个对象自动初始化，顺序颠倒就一条数据都不会发。

可选配置

参数	类型	说明
`显示徽章`	布尔	页面右下角显示品牌徽章，默认关闭
`徽章位置`	字符串	右下角 / 左下角 / 右上角 / 左上角
`徽章主题`	字符串	深色 / 浅色 / 极简

三、验证数据是否上报

浏览器打开接入的页面，按 F12 切到 Network
筛选 track.php，应当看到一条 POST 请求，状态 200
回到面板「实时」页，几秒内出现该访问记录，含页面标题、浏览器、省份

只要 Network 里那条 POST 返回 200 而面板没数据，问题一定在服务端消费队列，不在前端。

四、常见问题排查

现象	原因	处理
Network 里没有 track.php	配置对象在 SDK 之后定义，或站点密钥为空	调整顺序，确认密钥非空
请求被浏览器拦截（CORS）	接口未返回 `Access-Control-Allow-Origin`	检查 track.php 的跨域头
返回 403	域名不在白名单，或站点被停用	面板「站点」页补充绑定域名
返回 429	触发单 IP 或单站限流	正常流量不会触发，排查是否有循环上报
有上报但面板没数	消费队列未运行	配置每分钟执行的消费脚本（见部署指南）

五、进阶：转化事件

除了自动记录页面浏览，可以在关键动作发生时手动打点，用于来源归因和转化率统计：

window.小葱计数器.转化('下单', { 金额: 199 });

打点后到面板「转化」页查看，或通过接口的「转化归因」动作拉取每个来源的转化数与转化率。

六、性能与隐私

不拖慢页面：SDK 异步加载，上报批量合并（10 条 / 3 秒），页面卸载时用 sendBeacon 补发。
可关 cookie：新老访客默认用 cookie 识别，如果站点有合规要求可关闭，改为会话级识别。
数据不出境：所有数据写进你自己的数据库，不经过第三方。