芭乐视频站长统计代码的核心，是把栏目打开、访客到访和视频播放等动作按统一口径记录，再用公式汇总成可比较的指标。这里的“官方版”沿用标题中的版本标识；下列统计口径与接口是可自行实现的示例，不代表某个既有站点的专有实现。下文说明各项数据的单位、计算方法和适用条件，并给出向站点自有接口发送事件的代码模板。统计结果取决于接收端如何去重与归档，代码本身不会自动生成报表。

先统一统计口径

PV（浏览量）按一次有效的栏目或视频入口载入计数，单位为次。同一访客刷新当前入口，通常新增一次 PV；若站点通过前端路由切换栏目而不重新载入文档，就应在路由切换完成后主动发送入口打开事件。

UV（独立访客数）按统计周期内去重后的访客标识计数，单位为个标识。一般使用经允许保存的第一方标识，并在服务端按日期或统计周期去重；清除存储、更换浏览器或设备可能让同一自然人被计为多个 UV，因此 UV 不等于真实人数。

会话数按一段连续访问过程计数，单位为次。本文示例将连续活动视为同一会话，空闲达到 30 分钟后再次访问则开启新会话；实际部署时应选择统一时长并保持整站一致。播放完成率按完成播放的有效次数除以有效播放开始次数，结果以百分比表示。重复触发、预加载或未真正开始播放的事件应排除在分子、分母之外。

公式、单位与适用条件

比例先用未四舍五入的原始数值计算，展示时再统一保留两位小数。若分母为零，应显示“—”或“不适用”，而不是填 0%；否则会把“没有发生”误读成“发生了但比例为零”。

统计代码模板与事件触发

以下模板将事件发送到同站接收路径 /stats/collect。站点需要自行实现该接收接口，将事件写入统计系统；这个路径不是现成的统计服务地址。访客标识采用第一方存储示意，不采集姓名、手机号等可识别字段，使用前应结合站点的告知与授权规则。

const key = 'bila_visitor_id';
let visitorId = localStorage.getItem(key);

if (!visitorId) {
  visitorId = crypto.randomUUID();
  localStorage.setItem(key, visitorId);
}

function track(eventName, extra = {}) {
  const payload = {
    event: eventName,
    visitor_id: visitorId,
    route: location.pathname,
    time: Date.now(),
    ...extra
  };

  const body = new Blob(
    [JSON.stringify(payload)],
    { type: 'application/json' }
  );

  navigator.sendBeacon('/stats/collect', body);
}

track('view_open');

普通站点入口在有效载入后调用一次 track('view_open')；前端路由站点则在每次路由切换完成后调用。播放器开始播放时发送 track('play_start', {video_id: '片源标识'})，达到完成条件时发送 track('play_complete', {video_id: '片源标识'})。接收端应校验事件名称、路由和片源标识，过滤明显异常请求，并用事件标识或合理的去重规则避免网络重试造成重复入账。

按一组数据计算

假设某统计周期收到 1280 次有效入口打开，去重后有 760 个访客标识，共形成 940 个会话；播放器记录 420 次有效开始、270 次完成。按照上面的口径，可得到以下结果：

例如，播放完成率的分母应是有效播放开始次数，而不是 PV 或视频详情打开次数。若同一访客打开视频详情却没有按下播放，不能把这次到访计入播放开始；若播放器重复上报开始事件，也应先去重再计算。这样得到的比例才反映实际播放过程。

从事件到报表的核算顺序

1. 定周期：明确按自然日、周或月汇总，并统一时区与跨日边界。
2. 收事件：栏目打开、路由切换和播放状态分别使用固定事件名，避免同一动作出现多个名称。
3. 做校验：检查时间、路由、访客标识和片源标识等字段，过滤测试流量及格式错误的记录。
4. 先去重后汇总：按事件规则清理重复记录，再计算 PV、UV、会话和播放次数。
5. 套用公式：保留原始计数作为分子、分母，最后计算比例与人均值，并在报表中注明单位。

核对代码是否正常工作时，可在测试环境依次打开栏目、切换前端路由并播放一段视频，检查每个动作是否只产生预期事件。若 PV 增长而播放开始数不变，通常说明入口统计已触发、播放器事件尚未接入；若 UV 大幅高于常态，则应检查访客标识是否每次载入都被重新生成。按统一口径持续记录，芭乐视频站长统计代码产生的浏览量、独立访客标识数和播放完成率才适合进行周期比较。