Metrics

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

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

核心指标

虽然 YouTube Reporting API 需遵守服务条款中规定的弃用政策，但非核心指标（和非核心维度）不受此政策限制。在本页的定义中，任何属于核心指标的指标都会明确标识出来。

以下列表列出了该 API 的核心指标。 YouTube Analytics API 中也使用的所有这些指标也是该 API 中的核心指标。

如需了解详情，请参阅受弃用政策约束的 YouTube API 列表。

查看指标

观看次数 （核心指标）
视频的观看次数。在播放列表报告中，该指标表示在播放列表上下文中观看视频的次数。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.
踩的次数 （核心指标）
用户通过对视频给出负面评分表示踩视频的次数。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 数据分析“片尾画面报告”的更详细说明。

注意：我们自 2016 年 5 月 1 日起才开始提供片尾画面指标数据。

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

观众黏度指标

audience_retention_percentage
在视频的指定时间点观看视频的观看者的绝对比例。该比率的计算方式是将视频中某一部分的观看次数与该视频的总观看次数相比较。elapsed_video_time_percentage 维度用于标识视频中与此指标对应的部分。

请注意，视频的某个部分可能会在指定视频观看事件中被多次观看（或根本不观看）。例如，如果用户快退并多次观看视频的同一部分，则该部分视频的绝对比率可能会大于 1。

以下示例说明了该值的计算方式：
  • 一分钟视频的观看次数为 100 次。一半的观看者在 15 秒后停止观看，其余的观看者则看完整个视频。观看者均不会重复观看视频的任何部分。在本例中，对于视频前四分之一的时间段，此指标的值为 1；对于视频的其余部分，其值为 0.50。
  • 一分钟视频的观看次数为 100 次。所有观众观看了整个视频，但有 20 人观看了视频的 45 秒标记，然后跳回视频的 30 秒标记，然后观看视频的剩余部分。在本例中，对于视频前半部分或后四分之一的时间段，该指标的值将为 1。然而，对于视频处于第三四分位的时间段，该值将为 1.2，因为 100% 的观看者观看了该视频的该片段，但有 20% 的观看者观看了该片段两次。

估算收入指标

注意：“估算收入”指标受月末调整的影响，而且不包括合作伙伴出售的广告和合作伙伴投放的广告。有关估算收入数字的其他信息和注意事项，请参阅 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_sense_revenue（仅在 YouTube Reporting API 中受支持）
在选定日期范围和区域内，竞价出售的 AdSense 广告带来的总估算收入（净收入）。
estimated_partner_ad_reserved_revenue（仅在 YouTube Reporting API 中受支持）
通过 DoubleClick (DCLK) 预订出售的广告和其他 YouTube 出售来源带来的总估算收入（净收入）。此指标之前名为 estimated_partner_double_click_revenue。
estimated_partner_double_click_revenue（仅在 YouTube Reporting API 中受支持）
通过 DoubleClick (DCLK) 预订出售的广告和其他 YouTube 出售来源带来的总估算收入（净收入）。
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
每千次播放的估算总收入。