把脚本装好，也把数据读明白。

第一步：接入网站访问

在后台添加自己有权管理的网站，复制站点安装页生成的脚本，放入网站公共页面模板的 head 中。托管版使用 stats.plost.io 采集，自托管版使用自己的统计服务域名。

1. 01

   使用后台生成的代码

   核对脚本中的站点域名和服务地址。单页应用通常只需在公共模板安装一次，避免各页面重复插入。

2. 02

   打开网站验证

   发布代码后访问网站，再检查 Plost 的近期活动；采集写入可能存在短暂延迟。

3. 03

   没有数据时排查

   检查脚本是否成功加载、站点配置是否一致，以及浏览器拦截、内容安全策略或网络是否阻止采集。

第二步：让活动来源可辨认

为推广链接填写 utm_source、utm_medium 和 utm_campaign。提前约定来源、媒介、活动的命名，保持大小写和含义一致。

例如同一篇发布内容在社区和邮件中使用不同来源名，在同一活动下保持 campaign 一致。不要把邮箱、手机号或其他个人信息写进 UTM。UTM 只标记链接来源，不证明一次访问最终促成了购买。

第三步：记录自定义事件

脚本安装后，在真实操作发生时调用事件接口。表单事件应在成功后记录，下载事件应与实际下载动作对应。

window.plost?.track("Download guide", { location: "article" })

先给事件写清楚含义，再自己触发一次并核对后台。事件属性使用内容类别、按钮位置等必要信息，避免发送个人资料。更多外链、文件下载与服务端采集方式见站点后台的埋点文档。

了解事件统计的使用方式

第四步：分享报表或读取 API

需要别人查看报表时，在站点设置的可见性中配置公开统计或创建命名分享链接。每个分享凭证只对应一个站点，持有者可以读取相应报表。

托管版需要程序读取时，可在账号设置的 API Key 中创建只读凭证，勾选允许读取的网站。可以调整授权范围或撤销 Key，新添加的网站不会自动授权。接口提供站点列表、在线与今日昨日汇总，以及指定范围的聚合报表。当前自托管下载包使用站点分享凭证读取统计，尚不包含账号 API Key 与站点列表接口，具体以包内和实例文档为准。

为不同用途分别创建凭证，停用时撤销对应授权。API 凭证只保存在自己的服务端或受信客户端中，勿放进公开网页、源码仓库或查询地址。网页组件通过自己的后端读取并缓存统计。

实例中的 /docs/api 提供调用说明，/api/v1/openapi.json 提供机器可读规范。托管版可在登录后打开下面的文档；自托管版请使用自己的实例地址。

读报表时保留同一个口径

先核对站点、时区和日期范围，再看趋势。今天与当前月份还在增长；多个日期的独立访客不能直接相加作为整个区间的去重人数。浏览量、访问次数、访客与事件次数也应分别理解。

埋点不设置 Cookie，但会在浏览器 localStorage 中保存随机匿名访客标识。清除存储、更换浏览器、脚本拦截和网络中断都可能影响统计。地区查询、地图和搜索集成的行为取决于实例配置。

阅读隐私说明