Metrics

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

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

核心指标

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

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

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

查看指标

次观看（核心指标）
此指标在不同类型的报告中表示不同的数值：
  • 在视频报告中，此指标用于指定视频的观看次数。
  • 在不使用 isCurated 维度的播放列表报告中，此指标会指定播放列表中视频的总观看次数，无论这些观看次数是在播放列表中发生的还是在其他情境中发生的。请注意，该指标值仅包含频道所有者的视频的观看次数。

    在这些报告中，playlistViews 指标表示特定播放列表中的播放列表视频的观看次数。
  • 在使用 isCurated 维度的播放列表报告中，此指标表示视频在特定播放列表中的观看次数。请注意，这些报告不支持 playlistViews 指标。
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.
不喜欢 （核心指标）
用户通过给出差评表示不喜欢某个视频的次数。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 数据分析 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 分钟后仍在观看。
  • 在与视频播放三分钟时刻对应的 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 数据分析 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
每千次播放的估算总收入。