Metrics

本文档定义了您可以使用 YouTube Analytics API 检索的指标。此 API 支持实时查询，可生成自定义 YouTube 数据分析报告。

指标是对用户活动、广告效果或估计收入的单独衡量结果。用户活动指标包括视频观看次数和评分（赞和踩）等。

核心指标

虽然 YouTube Analytics API 受《服务条款》中定义的弃用政策约束，但非核心指标（和非核心维度）不受该政策约束。在本页面的定义中，任何核心指标都会明确标识出来。

以下列表列出了 API 的核心指标。

如需了解详情，请参阅符合弃用政策规定的 YouTube API 列表。

查看指标

engagedViews （核心指标）
频道视频的观看次数（不包括开头前几秒）。
观看次数 （核心指标）
此指标在不同类型的报告中表示不同的数字。 This is a core metric and is subject to the Deprecation Policy.
playlistViews
此指标在播放列表指标部分中定义。
redViews
YouTube Premium（以前称为“YouTube Red”）会员观看视频的次数。
viewerPercentage （核心指标）
观看视频或播放列表时已登录账号的观看者所占的百分比。This is a core metric and is subject to the Deprecation Policy.

观看时长指标

estimatedMinutesWatched （核心指标）
用户观看指定频道、内容所有者、视频或播放列表中的视频的时长（以分钟为单位）。This is a core metric and is subject to the Deprecation Policy.
estimatedRedMinutesWatched
YouTube Premium（以前称为“YouTube Red”）会员观看视频的时长（以分钟为单位）。
averageViewDuration （核心指标）
视频播放的平均时长（以秒为单位）。自 2021 年 12 月 13 日起，此指标不再包含循环播放的剪辑带来的流量。在播放列表报告中，此指标表示在播放列表上下文中发生的视频播放的平均时长（以秒为单位）。This is a core metric and is subject to the Deprecation Policy.
averageViewPercentage
视频播放期间的平均观看百分比。自 2021 年 12 月 13 日起，此指标不再包含循环播放的剪辑的流量。

互动指标

评论 （核心指标）
用户评论视频的次数。如需了解详情，请访问 YouTube 帮助中心。This is a core metric and is subject to the Deprecation Policy.
赞 （核心指标）
用户通过给出好评表示喜欢某个视频的次数。This is a core metric and is subject to the Deprecation Policy.
dislikes（核心指标）
用户通过给出差评表示不喜欢某个视频的次数。This is a core metric and is subject to the Deprecation Policy.
分享次数 （核心指标）
用户通过 Share 按钮分享视频的次数。如需了解详情，请访问 YouTube 帮助中心。This is a core metric and is subject to the Deprecation Policy.
subscribersGained （核心指标）
用户订阅频道的次数。This is a core metric and is subject to the Deprecation Policy.

频道可以在多个位置获得或失去订阅者，包括视频观看页、频道页以及 YouTube 首页上显示的导视。 在频道报告中，此指标包括通过以下任何位置获得的订阅者。不过，在使用 video 维度或 filter 参数将响应限制为仅包含特定视频数据的报告中，subscribersGained 指标将仅包含指定视频观看页面的统计信息。
subscribersLost （核心指标）
用户取消订阅频道的次数。This is a core metric and is subject to the Deprecation Policy.

此指标的数据报告方式与 subscribersGained 指标类似。 在频道报告中，此指标包括通过任何可供用户退订频道的机制而失去的订阅者。不过，在使用 video 维度或 filter 参数将响应限制为仅包含特定视频数据的报告中，此指标仅包含从指定视频的观看页面退订的用户。
videosAddedToPlaylists
视频被添加到任何 YouTube 播放列表中的次数。视频可能已添加到视频所有者的播放列表或其他频道的播放列表中。

此指标值包含视频被添加到“稍后观看”播放列表等默认播放列表的次数。不过，此指标不会统计视频自动添加到的播放列表，例如频道的上传内容播放列表或用户的观看记录。

此指标会返回一个绝对数值，也就是说，如果用户将某个视频添加到播放列表，然后将其移除，之后又再次添加，此指标值会反映该视频被添加到播放列表两次。此指标的数据不适用于 2014 年 10 月 1 日之前的日期。
videosRemovedFromPlaylists
视频从任何 YouTube 播放列表中移除的次数。视频可能已从视频所有者的播放列表或从其他频道的播放列表中移除。

此指标值包括视频从“稍后观看”播放列表等默认播放列表中移除的次数。

此指标返回的是绝对数值，这意味着，如果用户将视频添加到播放列表，然后将其移除，接着再次添加，然后再次移除，则此指标值会反映视频从播放列表中移除了两次。此指标的数据不适用于 2014 年 10 月 1 日之前的日期。

播放列表指标

播放列表报告包含两种类型的指标，用于说明观看者与播放列表中的视频互动的方式：

  • 汇总视频指标提供用户活动指标和展示指标，这些指标是针对播放列表中的所有视频（同时也是播放列表所属频道拥有的视频）汇总而成的。聚合中不会计算其他频道所拥有的视频的指标。因此，如果某个频道创建的播放列表仅包含其他频道拥有的视频，则这些播放列表的报告不会提供这些指标的值。

    如需了解受支持的视频汇总指标的定义，请参阅本文档的查看指标和观看时长指标部分。

  • 播放列表内指标反映用户在播放列表页面上的活动和互动情况。这些指标会统计播放列表中所有视频的观看次数，无论这些视频归哪个频道所有，但只会统计在播放列表上下文中发生的观看。

以下指标大多是播放列表内指标；列表中的其余指标（例如 playlistSaves 指标）与用户与播放列表本身的互动有关，而与播放列表中的视频无关。因此，这些指标既不属于汇总视频指标，也不属于播放列表内指标。

averageTimeInPlaylist
观看者在播放列表开始播放后观看播放列表中的视频的估计平均时长（以分钟为单位）。请注意，此指标仅包含在网络上发生的播放列表观看次数。
playlistAverageViewDuration
每次观看播放列表时所带来的预估平均观看时长（以秒为单位）。请注意，此指标表示播放列表中各个视频的平均观看时长；相比之下，averageTimeInPlaylist 指标表示每位观看者观看整个播放列表的平均时长。此指标包含其他频道拥有的播放列表视频的数据。
playlistEstimatedMinutesWatched
用户通过播放列表观看播放列表内容的总时长（以分钟为单位）。其他情境下的观看时长（例如，观看者在观看其他播放列表中的同一视频时产生的观看时长）不计入在内。此指标 包含其他频道所拥有的播放列表视频的数据。
playlistSaves
用户保存播放列表的净次数。如需详细了解已保存的播放列表，请参阅 YouTube 帮助中心。此指标返回的是净变化数，这意味着，如果用户保存某个播放列表，然后将其从已保存的播放列表列表中移除，之后又再次保存该播放列表，那么此指标值会反映新增了一次播放列表保存。
playlistStarts
观看者开始播放播放列表的次数。请注意，此指标仅包含在网络上发生的播放列表观看次数。
playlistViews
播放列表中的视频在该播放列表中的观看次数。 此指标包含其他频道拥有的播放列表视频的数据。
viewsPerPlaylistStart
每次开始播放播放列表时发生的平均视频观看次数。请注意，此指标仅包含在网络上发生的播放列表观看次数。

注释指标

注意：自 2012 年 6 月 10 日起，YouTube Analytics API 报告仅返回 annotationClickThroughRate 和 annotationCloseRate 指标的数据。此外，自 2013 年 7 月 16 日起，YouTube Analytics API 报告仅返回剩余注释指标的数据。

annotationImpressions
注释的总展示次数。
annotationClickableImpressions
显示且可供点击的注释数量。
annotationClicks
被点击的注释的数量。
annotationClickThroughRate （核心指标）
观众点击的注释数与可点击注释的总展示次数的比率。This is a core metric and is subject to the Deprecation Policy. YouTube 帮助中心提供了有关创建注释和使用链接注释的更多信息。
annotationClosableImpressions
显示且可关闭的注释数量。
annotationCloses
已关闭的注释数量。
annotationCloseRate （核心指标）
观看者关闭的注释数量与注释总展示次数的比率。This is a core metric and is subject to the Deprecation Policy.

卡片指标

YouTube 帮助中心提供了有关向视频添加卡片和 YouTube 数据分析卡片报告的更详细说明。

cardImpressions
卡片的展示次数。打开卡片面板后，系统会将视频中每个卡片的展示次数记录下来。
cardClicks
卡片的点击次数。
cardClickRate
卡片的点击率，计算方法为卡片点击次数与卡片展示次数之比。
cardTeaserImpressions
卡片宣传语的展示次数。一次视频观看可产生多次宣传广告展示。
cardTeaserClicks
信息卡宣传语获得的点击次数。卡片图标获得的点击次数将归于向用户展示的上一条宣传语。
cardTeaserClickRate
卡片宣传语的点击率，计算方法是将卡片宣传语获得的点击次数除以卡片宣传语的总展示次数。

直播指标（同时观看人数）

averageConcurrentViewers
特定视频的平均同时观看人数。如果为报告指定了 livestreamPosition 维度，则 averageConcurrentViewers 值表示特定片段期间的平均同时观看人数
peakConcurrentViewers
特定视频的同时观看人数峰值。如果为报告指定了 livestreamPosition 维度，则 peakConcurrentViewers 值指定了视频特定片段期间的同时观看人数峰值。

观众黏度指标

audienceWatchRatio
在视频的指定时间点观看视频的观看者的绝对比率。该比率的计算方法是将视频某部分的观看次数与视频的总观看次数进行比较。elapsedVideoTimeRatio 维度用于标识指标所对应的视频部分。

请注意，在一次视频观看中，视频的某一部分可能会被观看多次（或根本未被观看）。例如，如果用户多次倒回并观看视频的同一部分，则该部分视频的绝对比率可能大于 1。

以下示例说明了如何计算该值：
  • 一个时长为 1 分钟的视频被观看了 100 次。一半的观看者在 15 秒后停止观看，其余观看者则观看完整视频。没有观看者多次观看视频的任何部分。在这种情况下，对于视频前四分之一的时间段，此指标的值为 1；对于视频的剩余时间段，此指标的值为 0.50。
  • 一个时长为 1 分钟的视频被观看了 100 次。所有观看者都完整观看该视频，但其中 20 位观看者观看至视频的 45 秒标记处，然后跳回至视频的 30 秒标记处，接着观看视频的剩余部分。在这种情况下，对于视频前半部分或最后四分之一的时间段，相应指标的值将为 1。不过，对于视频第三季度的各个时间段，该值为 1.2，因为 100% 的观看者都观看了该视频片段，但其中 20% 的观看者观看了该片段两次。
relativeRetentionPerformance
一种衡量指标，用于显示视频在播放期间相对于 YouTube 上所有时长相近的视频而言，吸引观众继续观看的能力。该指标的值介于 0 和 1 之间，用于标识视频在给定时间点的相对观看时长表现。视频中的点由 elapsedVideoTimeRatio 维度提供。

值为 0 表示相应视频在吸引观众继续观看方面的表现不如任何其他时长相近的视频，而值为 1 则表示相应视频在吸引观众继续观看方面的表现优于任何其他时长相近的视频。中位数值为 0.5 表示，一半时长相近的视频在吸引观众继续观看方面的表现优于您的视频，而另一半则不如您的视频。

以下假设性示例展示了报告中可能显示的值。平均而言，观看时长为 10 分钟的视频的观看者中，有 90% 的人会在 3 分钟后继续观看，有 70% 的人会在 8 分钟后继续观看。不过，对于时长为 10 分钟的特定视频，只有 80% 的观看者在 3 分钟后仍在观看，但所有这些观看者在 8 分钟后仍在观看。
  • 在与视频播放到 3 分钟时对应的 elapsedVideoTimeRatio 值处，relativeRetentionPerformance 指标的值将低于 0.5，因为此时视频的效果不如平均水平。
  • 在与视频播放到 8 分钟时对应的 elapsedVideoTimeRatio 值处，relativeRetentionPerformance 指标的值会高于 0.5，因为此时视频的表现优于其他时长相近的视频。
startedWatching
在视频播放期间，特定视频片段成为观看者看到的第一个片段的次数。

例如，假设视频 X 的时长为 5 分钟。在此报告中，YouTube 会将视频划分为 100 个 3 秒片段，这些片段通过 elapsedVideoTimeRatio 维度进行标识。观看者访问 YouTube 并观看视频的前 1 分 10 秒， 其中包括视频的前 24 个片段的全部或部分内容。在后续访问 YouTube 时，观看者继续观看视频，从第 24 段开始播放，一直看到第 100 段。

此示例将生成以下观看指标值：
  • 对于细分 1 和 24，startedWatching 指标的值为 1，对于所有其他细分，该指标的值为 0。
  • 对于细分 24 和 100，stoppedWatching 指标的值为 1；对于所有其他细分，该指标的值为 0。
  • 对于细分 24，totalSegmentImpressions 指标的值为 2，对于所有其他细分，该指标的值为 1。
stoppedWatching
视频播放期间，视频的特定片段成为最后观看的片段的次数。如需了解此指标值的计算示例，请参阅 startedWatching 指标的定义。
totalSegmentImpressions
视频中特定片段的观看次数。如需查看此指标值的计算示例，请参阅 startedWatching 指标的定义。请注意，观看者可以在同一播放会话中多次观看视频的同一片段。

会员资格取消指标

membershipsCancellationSurveyResponses
在报告期内，已取消指定频道会员资格的 YouTube 用户完成的调查问卷数量。

估算收入指标

注意：估算收入指标受月末调整的影响，并且不包含合作伙伴出售的广告资源带来的收入和合作伙伴投放的广告带来的收入。如需详细了解估计收入数据，请访问 YouTube 帮助中心。

默认情况下，所有估计收入数据均以美元报告。不过，YouTube Analytics API 支持部分估算收入和广告效果指标的 currency 参数，因此您可以检索其他币种的估算收入数据。
estimatedRevenue （核心指标） （之前名为 earnings）
在所选日期范围和区域内，源于所有 Google 出售的广告来源以及非广告来源的总估算净收入。 This is a core metric and is subject to the Deprecation Policy.

“估算收入”类指标受月末调整的影响，而且不包含合作伙伴出售或投放的广告所产生的收入。
estimatedAdRevenue （之前称为 adEarnings）
在选定日期范围和地区内，源于 Google 出售的所有广告来源的总估算净收入。

估算收入指标可能会在月末进行调整，并且不包括合作伙伴出售和投放的广告。
estimatedRedPartnerRevenue （之前称为 redPartnerRevenue）
所选报告维度下通过 YouTube Premium（以前称为 YouTube Red）订阅获得的估算总收入。相应指标的值反映了音乐和非音乐内容的收入，并且可能会在月末进行调整。

广告效果指标

grossRevenue
在所选日期范围和区域内，所有 Google 出售的广告或 DoubleClick 合作伙伴出售的广告所带来的估算总收入（以美元为单位）。总收益以月末调整为准，且不涵盖合作伙伴投放的广告。总收入不应与估计收入或净收入混淆，后者会考虑您的所有权份额和收益分成协议。
cpm（之前称为 impressionBasedCpm）
每千次广告展示的估算总收入。
adImpressions（之前名为 impressions）
已投放的已验证广告展示次数。
monetizedPlaybacks
观看者播放您的视频并至少看到一次广告展示的次数。如果观看者看到前贴片广告，但在您的视频开始播放之前就退出观看广告，则此次播放会被计为一次创收的播放。此数据的预期估计误差为 ±2.0%。
playbackBasedCpm
每千次播放的估算总收入。