Metrics

本文档定义了 YouTube Reporting API 检索的指标。此 API 用于检索包含面向频道或内容所有者的 YouTube 数据分析数据的批量数据报告。

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

核心指标

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

以下列表列出了 API 的核心指标。 YouTube Analytics API 中使用的任何此类指标也是该 API 中的核心指标。

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

查看指标

engaged_views （核心指标）
频道视频的观看次数（不包括开头前几秒）。
观看次数 （核心指标）
视频的观看次数。在播放列表报告中，此指标表示视频在播放列表中的观看次数。YouTube 帮助中心提供了有关观看次数报告方式的更多信息。 This is a core metric and is subject to the Deprecation Policy.
red_views
YouTube Premium（以前称为“YouTube Red”）会员观看视频的次数。
views_percentage （核心指标）
观看视频或播放列表时已登录账号的观看者所占的百分比。This is a core metric and is subject to the Deprecation Policy.

观看时长指标

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

频道可以在多个位置获得或失去订阅者，包括视频观看页、频道页以及 YouTube 首页上显示的导视。 如需确定有多少新频道订阅者不是通过视频观看页订阅的，基本用户活动报告中会包含一个未指定 video_id 维度值的行。该行还为 subscribersLost 指标指定了一个值，但未为其他指标指定值。
subscribers_lost （核心指标）
用户取消订阅频道的次数。This is a core metric and is subject to the Deprecation Policy.

此指标的数据报告方式与 subscribers_gained 指标类似。 如需确定有多少用户退订了频道，但不是在视频观看页面上退订的，基本用户活动报告中会包含一个未指定 video_id 维度值的行。该行还为 subscribers_gained 指标指定了一个值，但未为其他指标指定值。
videos_added_to_playlists
视频被添加到任何 YouTube 播放列表中的次数。视频可能已添加到视频所有者的播放列表或其他频道的播放列表中。

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

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

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

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

播放列表指标

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

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

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

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

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

playlist_starts
观看者开始播放播放列表的次数。请注意，此指标仅包含在网络上发生的播放列表观看次数。
playlist_saves_added （仅在 YouTube Reporting API 中受支持）
用户保存播放列表的次数。如需详细了解已保存的播放列表，请访问 YouTube 帮助中心。此指标返回的是绝对数值，这意味着，如果用户保存某个播放列表，然后将其从已保存的播放列表列表中移除，之后又再次保存该播放列表，则此指标值会反映出两次播放列表保存操作。
playlist_saves_removed （仅在 YouTube Reporting API 中受支持）
用户从已保存的播放列表列表中移除相应播放列表的次数。此指标返回的是绝对数值，这意味着，如果用户保存某个播放列表，然后将其从已保存的播放列表列表中移除，之后又保存该播放列表，然后再次将其移除，则此指标值会反映两次播放列表保存操作被移除。

注释指标

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

卡片指标

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

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

片尾画面指标

片尾画面是指在视频的最后 5-20 秒内显示的一些元素，用于宣传您的内容、频道和网站。YouTube 帮助中心包含有关向视频添加片尾画面和 YouTube 数据分析片尾画面报告的更详细说明。

end_screen_element_impressions
显示的片尾画面元素的数量。每当显示一个片尾画面元素时，系统就会记录一次展示。
end_screen_element_clicks
片尾画面元素被点击的次数。
end_screen_element_click_rate
片尾画面元素的点击率，计算方式为片尾画面元素点击次数与片尾画面元素展示次数的比率。

会员资格取消指标

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

估算收入指标

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

YouTube Reporting API 会以美元报告所有估算收入和收益数据。
estimated_partner_revenue （核心指标）
在所选日期范围和区域内，源于所有 Google 出售的广告来源以及非广告来源的总估算净收入。
estimated_partner_ad_revenue
在选定日期范围和地区内，源于 Google 出售的所有广告来源的总估算净收入。

估算收入指标可能会在月末进行调整，并且不包括合作伙伴出售和投放的广告。
estimated_partner_ad_auction_revenue （仅在 YouTube Reporting API 中受支持）
在所选日期范围和区域内，通过 AdSense 出售的竞价广告带来的总估算收入（净收入）。此指标以前称为 estimated_partner_ad_sense_revenue。
estimated_partner_ad_reserved_revenue （仅在 YouTube Reporting API 中受支持）
通过 DoubleClick (DCLK) 和其他 YouTube 销售渠道以预订方式售出的广告带来的总估算收入（净收入）。此指标以前称为 estimated_partner_double_click_revenue。
estimated_partner_red_revenue （仅在 YouTube Reporting API 中受支持）
YouTube Premium（以前称为 YouTube Red）订阅带来的估算总收入（净收入）。
estimated_partner_transaction_revenue （仅在 YouTube Reporting API 中受支持）
交易（例如付费内容和粉丝赞助）产生的总估算收入，减去合作伙伴要求的所有退款。

广告效果指标

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