嘿，我来帮你把这个指标的计算逻辑拆解清楚——官方那句“视频播放期间观看的平均百分比”确实太笼统了，结合官方文档的底层逻辑，具体计算方式是这样的：

核心计算公式 #

averageViewPercentage = (总观看时长 ÷ (视频总时长（分钟） × 播放次数)) × 100

这里需要先统一单位：视频总时长默认是秒，要转换成分钟（除以60），总观看时长API返回的是watchTimeMinutes，直接用就行。

拆解每个计算项 #

• 总观看时长（watchTimeMinutes）：所有观众观看该视频的累计分钟数，只统计实际观看的部分——比如观众跳转到视频第10秒处看了20秒，这20秒会折算成约0.33分钟计入总时长。
• 视频总时长（videoDurationSeconds）：视频本身的完整时长（固定值），计算时要转成分钟（除以60），比如120秒的视频就是2分钟。
• 播放次数（views）：视频被触发播放的次数，只要开始播放就算一次，哪怕观众看了1秒就关掉。

举个实际例子 #

假设你有一条时长60秒（1分钟）的视频：

• 播放次数是10次
• 总观看时长是7分钟

那计算过程就是：(7 ÷ (1 × 10)) × 100 = 70%
意思是所有播放会话的平均观看占比是70%，相当于观众平均看了42秒的内容。

几个容易混淆的点 #

• 这个指标是所有播放会话的平均值，不是单个观众的平均——比如5个观众看完了视频（100%），5个观众只看了20%，整体平均就是60%。
• 自动循环播放的情况：如果观众开启了自动循环，每次循环的观看时长都会累计，但播放次数只算初始的那一次。比如1分钟的视频被播放1次，观众循环看了3遍，总观看时长是3分钟，那averageViewPercentage就是300%，这是符合逻辑的。
• 跳过片段的观看时长会正常计入——比如观众直接跳过开头30秒，看了后面30秒，这30秒会算入总观看时长。

内容的提问来源于stack exchange，提问作者Chiko Yato