System-Managed Reports - Fields

电影、音乐和电视

下表定义了电影、音乐和电视合作伙伴的 YouTube Reporting API 系统管理报告中显示的字段:

字段
active_claims 有效版权主张的数量。
active_reference_id YouTube 为关联的有效参考文件生成的 ID。
activity_month 报告对应的月份。
adjustment_type 表示相应行是正常收入数据,还是对之前报告的收入进行的调整:
  • 如果相应行表示正常收入数据,则该字段值为 None。此外,该行中的数据会报告与报告关联的月份的数据。
  • 如果相应行表示对之前报告的数据进行的调整,则该字段包含以下列表中的某个值。在这种情况下,相应行可能包含与报告关联的月份以外的月份的数据。例如,2016 年 11 月的报告可能包含适用于 2016 年 10 月或其他更早月份的调整。

    可能的调整类型包括:
    • Backpay - 因缺少所有权信息而被扣留的付款。
    • Conflict Resolution - 因所有权冲突而被扣留的款项。这也是一种补付款。
    • Dispute Resolution - 与已解决的争议相关的付款,涉及的是在当前月份的付款之前被扣留的收入。
    • Dispute Conflict Resolution - 因存在所有权冲突而被扣留的款项,是根据已解决的争议计算出的补发款项。
    • Spam Adjustment - 与垃圾内容更正相关的付款。这是 AdSense 报告为 Invalid Activity - YouTube 的扣减项。
    • Revenue Correction - 与技术 bug 或数据更正相关的付款。此值可以是贷项,也可以是扣项。
administer_publish_rights 指明唱片公司是否负责管理出版权,即是否为歌曲作者、作曲家或出版商或乐曲的其他所有者收取和管理版税。可能的值有 TrueFalse
adsense_earnings_month 要查询 AdSense 报告的收入月份。
album 录音所属的专辑。该值的长度上限为 255 字节。
approx_daily_views 相应资产的日均观看次数。
approx_daily_engaged_views 相应资产的每日互动观看次数的大致数量。
artist 与报告行中标识的资产相关联的音乐人姓名。该值的长度上限为 255 字节。
asset_channel_id 拥有相应资产 (asset_id) 声明版权的合作伙伴上传视频的频道。该字段值是一个可唯一标识相应频道的 YouTube 频道 ID。您可以使用 YouTube Data API 的 channels.list 方法检索有关频道的其他数据。
asset_custom_id 用来明确标识某项资产的可选资产元数据字段,通常为内部代码。其他合作伙伴无法查看您的自定义 ID。
asset_id YouTube 资产 ID,用于唯一标识与相应行中的数据相关联的资产。您可以使用 YouTube Content ID API 的 assets.list 方法检索有关资产的其他数据,也可以在 studio.youtube.com 的“资产”页面中查找相应资产。
asset_labels 与相应资产相关联的资产标签。资产标签可用于将资产归入自定义类别。然后,您可以使用标签来搜索资产、更新资产组、为已加标签的资产创建广告系列、过滤 YouTube 分析工具中的数据等。
asset_metadata_type 参考文件对应资产的类型,例如 Web 或电影。
asset_owners 参考文件对应的资产的当前所有者。
asset_policy_block 所有者政策为 Block 的地区。值是相应地区的双字母国家/地区代码。
asset_policy_id 所有者政策的唯一标识符。目前,此值仅在 API 中可用。此信息不会显示在工作室内容管理器中。
asset_policy_monetize 所有者政策是 Monetize 的地区。值是相应地区的双字母国家/地区代码。
asset_policy_track 所有者政策是 Track 的地区。值是相应地区的双字母国家/地区代码。
asset_title 相应资产的标题。
asset_type 资产的类型。可能的值包括:
  • Art Track - 代表 YouTube 上没有优质音乐视频的录音的曲目。
  • Composition - 表示乐曲。乐曲具有 ISWC 和作者等元数据,这是唯一一种可以在每个地区拥有多个所有者的资产类型。它可能嵌入在录音资产中。
  • Movie - 表示故事片。电影具有 ISAN/EIDR 和导演等元数据。
  • Music Video - 代表录音的官方音乐视频。音乐视频具有视频 ISRC、歌曲和音乐人等元数据。音乐视频资产中嵌有录音资产。
  • Sound Recording - 表示音频录制内容。录音有 ISRC、音乐人和专辑等元数据。它嵌入了乐曲资产,并且可能反过来嵌入到音乐视频资产中。
  • Television episode - 表示电视节目的剧集。剧集具有剧季和剧集编号等元数据。
  • Web - 表示 YouTube 原创视频或其他资产类型未涵盖的视频内容。
audio_royalties YouTube 音频层产生的已确认收入。以下列两种合作伙伴收入中的较高者为准:音频广告净收入中合作伙伴的音频份额收入以及根据音频每次播放带来的最低收入计算的合作伙伴收入。
audio_share 合作伙伴音频层播放次数与总音频层播放次数之比。
category 视频的流派,如视频的观看页面上所示。该值为 YouTube 视频类别 ID。您可以使用 YouTube Data API 的 videoCategories.list 方法检索视频类别 ID 与类别名称的映射。
channel_display_name 上传视频的频道的显示名称。
channel_id 与相应行中的数据相关联的视频 (video_id) 所属的频道。该字段值是一个唯一标识相应频道的 YouTube 频道 ID。您可以使用 YouTube Data API 的 channels.list 方法检索有关频道的其他数据。
claiming_asset_type 声明所涉及的资源类型。
claim_created_date 版权主张的创建日期。
claim_id YouTube 版权主张 ID,用于唯一标识相应行中与版权主张相关联的资产。您可以使用 YouTube Content ID API 的 claims.list 方法检索有关资产的其他数据,也可以在 studio.youtube.com 的“版权主张”页面上查找资产。
claim_origin 针对视频创建版权主张所用的方法。可能的字段值包括:
  • Audio Match
  • Audio Swap
  • Batch Tool
  • CMS_UPLOAD
  • Content ID API
  • Descriptive Search
  • External
  • GameID Match
  • Google Dev ID
  • Hashcode
  • Melody Match
  • SFTP Upload
  • Video Match
  • Web Search
  • Web Upload
  • YouTube Admin
claim_policy_block 适用的主张政策是 Block 的地区。值是两个字母的国家/地区代码。
claim_policy_id 已应用政策的唯一标识符。目前,此值仅在 API 中可用。此信息不会显示在工作室内容管理器中。
claim_policy_monetize 适用的主张政策是 Monetize 的地区。值是两个字母的国家/地区代码。
claim_policy_track 适用的主张政策是 Track 的地区。值是两个字母的国家/地区代码。
claim_status 指明版权主张的状态是 ACTIVEINACTIVE 还是 PENDING
claim_status_detail 版权主张状态的详细信息,例如 CLOSED_MANUALLY
claim_type 指明版权主张涵盖的是所声明内容的音频、视频还是视听部分。此字段的有效值如下:
  • 音频
  • 音像
  • 图像
claim_quality 已声明版权的视频的来源。此字段的可能值包括:
  • Partner-provided - 视频由 YouTube 合作伙伴上传。
  • Premium UGC - 视频由第三方上传,受版权保护的片段符合长度和比例要求,可被视为与合作伙伴提供的许可内容等同的内容,符合收益分成条件。
  • UGC - 视频是用户生成的内容,这意味着它是由第三方上传的,但不符合被视为与合作伙伴提供的许可内容等同的内容(可参与收益分成)的要求。

注意:在 YouTube 创作者工作室的“报告”菜单中下载的报告中,此字段称为 Content Type

claimed_by_another_owner 指明其他内容所有者是否对相应视频提出了有效的第一方或第三方版权主张。
claimed_by_this_owner 指明生成报告的内容所有者是否对相应视频拥有有效的第一方或第三方版权主张。
comments_allowed 指明是否为相应视频启用了评论。
composition_right_type 指定与版权主张关联的乐曲权利类型。此字段的有效值如下:
  • 机械
  • 性能
  • 同步
conflicting_country_code 与其他合作伙伴存在所有权冲突的地区的 ISO 国家/地区代码。
conflicting_owner 遇到所有权冲突问题的其他合作伙伴的 ID。
conflicting_owner_artist 存在所有权冲突的资源的所有者的音乐人。
conflicting_owner_asset_title 存在冲突的所有者的资产标题。
conflicting_owner_isrc 存在所有权冲突的所有者的资产的 ISRC。
content_type 已声明版权的视频的来源。可能的值包括:
  • Partner-provided - 您上传到自己拥有的 YouTube 频道的视频。您可以在上传视频的过程中声明版权,并对视频应用使用政策。针对合作伙伴上传的内容声明版权,就能启用获利选项、Content ID匹配和报告功能。
  • Premium UGC - 第三方上传的视频,其中包含受版权保护的片段,这些片段符合长度和比例要求,可被视为与合作伙伴提供的许可内容等同的内容。
  • UGC - 第三方上传的视频,其中包含您拥有所有权的内容(通过 Content ID 匹配或手动版权主张确定)。与相应版权主张相关联的匹配政策决定了视频在 YouTube 上的播放位置和播放方式。
constituent_asset_id 资产在合并之前曾使用的 ID。
constituent_asset_ids 资产在合并之前曾使用的 ID。
country 标识活动发生的国家/地区。
country_code 用于标识活动发生的国家/地区的国家/地区代码。该值是 ISO 3166-1 alpha-2 国家/地区代码
currency 表示相应行所代表的货币。
currency_code 表示相应行所代表的货币代码。
custom_id 元数据提供方(即您)用于标识资产的唯一值。该值可以是你为资产创建的独一无二的 ID,也可以是标准标识符,例如 ISRC。该值的最大长度为 64 字节,可以包含字母数字字符、连字符 (-)、下划线 (_)、英文句号 (.)、@ 符号 (@) 或正斜线 (/)。
date 活动发生的日期。该值的格式为 YYYYMMDD
date_created 参考文件创建的日期和时间(以世界协调时间 [UTC] 为准)。
date_id 活动发生的日期。该值的格式为 YYYYMMDD
day 相应活动发生的日期。
director 与相应资产关联的导演。
directors 与相应资产关联的导演。
display_ads_enabled 指明视频中是否显示第三方广告。
display_isrc 为相应资产显示的 ISRC。
effective_policy 在内容所有者拥有所有权的地区,视频所适用的使用政策。
eidr 分配给电影或电视剧集的娱乐业标识注册 (EIDR)。此值包含一个标准 EIDR 注册前缀,后跟一条正斜线,然后是 20 个字符的十六进制字符串,最后是一位字母数字 (0-9A-Z) 校验字符。
embedding_allowed 指明视频是否可以嵌入到第三方网站中。
end_date 结束日期和时间。
engaged_views 支持广告功能的用户产生的感兴趣的观看次数总数。
engaged_views_in_conflict 存在冲突的内容的互动式观看次数。
episode_number 与视频相关联的集数。
episode_title 电视或电影剧集的标题。
excluded_perc 参考文件中被排除的内容所占的百分比,具体根据排除片段的总数和总时长计算。
exclusions 参考文件中被排除的部分和排除类型(例如,参考文件雷同内容、人工排除的内容、无效片段)。 可用的排除类型:
  • O = 通过内容管理器人工排除
  • P = 通过 API 人工排除
  • I = 通过“内容传送”人工排除
  • C = 参考文件雷同
  • S = 无效细分
  • B = 永久排除
grid 全球发行标识符,用于明确标识某项资产的可选元数据字段。相应字段的值正好包含 18 位字母数字字符。
has_multiple_claims 指明视频是否收到多个版权主张。如果视频只有一项版权主张,则该值为 false;如果视频有多项版权主张,则该值为 true

注意:在 YouTube 创作者工作室的“报告”菜单中下载的报告中,此字段称为 Multiple Claims?
hfa Harry Fox Agency (HFA) 给出的包含 6 位字符的乐曲唯一标识码。
hfa_song_code Harry Fox Agency (HFA) 给出的包含 6 位字符的乐曲唯一标识码。
inactive_reference_id YouTube 为关联的无效参考文件生成的 ID。
is_made_for_kids_effective_setting 视频的有效“面向儿童的内容”设置。
is_made_for_kids_modifiable 指示用户是否可修改“面向儿童的内容”设置。
is_made_for_kids_user_selection 指示视频是否被用户指定为“面向儿童的内容”。
is_merged 表示资产的创建原因是否为资产合并。
is_shorts_eligible 指明视频是否符合 Shorts 短视频条件。
isrc 相关资产的国际标准音像制品编码 (ISRC)。相应字段的值正好包含 12 位字母数字字符。
iswc 乐曲资产的国际标准音乐作品编码 (ISWC)。此字段的值正好包含 11 个字符,格式为:以一个字母 (T) 开头,后跟 10 个数字。
label 发布录音的唱片公司。该值的长度上限为 255 字节。
lifetime_engaged_views_in_conflict 存在冲突的内容的生命周期内互动观看次数。
lifetime_views_in_conflict 存在所有权冲突的内容的观看总次数。
length_sec 参考文件的时长(以秒为单位)。
local_currency 收入支付所用的本地币种类型。
longest_match 版权主张对应的最长匹配部分。
long_nonskippable_video_ads_enabled 指明第三方较长的不可跳过的广告是否可以在视频播放期间播放。插播视频广告会在内容视频播放期间展示。
match_policy 应用的资产匹配政策。
matching_duration 版权主张对应的总匹配时长。
metadata_origination 相应资产的元数据来源。
monetized_views YouTube Premium 订阅服务中归因于您的内容的纯音频和音像互动播放总次数。此值仅适用于音乐合作伙伴。
monetized_views_art_track_audio YouTube Premium 订阅服务中归因于您的内容的 Art Track 纯音频互动播放次数。此字段仅适用于音乐合作伙伴。
monetized_views_art_track_audio_visual YouTube Premium 订阅服务中归因于您的内容的 Art Track 音像互动播放次数。此字段仅适用于音乐合作伙伴。
monetized_views_audio YouTube Premium 订阅服务中归因于您的内容的纯音频互动播放总次数。该值是 monetized_views_art_track_audiomonetized_views_partner_owned_audiomonetized_views_ugc_audio 字段的总和。此字段仅适用于音乐合作伙伴。
monetized_views_audio_visual YouTube Premium 订阅服务中归因于您的内容的音像互动播放总次数。该值是 monetized_views_art_track_audiovisualmonetized_views_partner_owned_audiovisualmonetized_views_ugc_audiovisual 字段的总和。此字段仅适用于音乐合作伙伴。
monetized_views_partner_owned_audio YouTube Premium 订阅服务中归因于您的内容的纯音频互动播放次数:针对合作伙伴提供的音乐视频内容和官方音乐视频内容。此字段仅适用于音乐合作伙伴。
monetized_views_partner_owned_audio_visual YouTube Premium 订阅服务中归因于您的内容的音像互动播放次数:针对合作伙伴提供的音乐视频内容和官方音乐视频内容。此字段仅适用于音乐合作伙伴。
monetized_views_total_sub_service YouTube Premium 订阅服务中纯音频和音像创收观看次数总和,由 YouTube 音乐合作伙伴声明过版权的所有内容产生。此值仅适用于音乐合作伙伴。
monetized_views_ugc_audio YouTube Premium 订阅服务中归因于您的内容的用户生成内容 (UGC) 的纯音频互动播放次数。用户原创内容 (UGC) 是指用户上传的视频,这些视频在收益分成方面与合作伙伴提供的许可内容不同。此字段仅适用于音乐合作伙伴。
monetized_views_ugc_audio_visual YouTube Premium 订阅服务中归因于您的内容的用户生成内容 (UGC) 的音像互动播放次数。用户原创内容 (UGC) 是指用户上传的视频,这些视频在收益分成方面与合作伙伴提供的许可内容不同。此字段仅适用于音乐合作伙伴。
monetized_views_ugc_master_audio_visual YouTube Premium 订阅服务中归因于您的内容的音像原版录制内容互动播放总次数。此值仅适用于音乐合作伙伴。
monetized_views_ugc_cover_audio_visual YouTube Premium 订阅服务中归因于您的内容的用户生成的翻唱视频流的总互动观看次数。此值仅适用于音乐合作伙伴。
monetized_views_ugc_cover_shared_audio_visual 在 YouTube Premium 订阅服务中,归因于您的内容且采用三方收入分成的用户自制翻唱视频获得的互动观看总次数。此值仅适用于音乐合作伙伴。
monetized_watchtime 归因于您的非音乐视频的 YouTube Premium 订阅总观看时长(以秒为单位)。
month 活动发生的月份。
midrolls_enabled 表示视频是否可以播放中贴片广告。中贴片广告是指在其他视频或活动的播放/进行期间展示的视频广告。例如,中贴片视频广告可能会在长篇电影播放期间间隔展示。中贴片广告仅适用于许可内容。
multiple_claims 指明视频是否收到多个版权主张。如果视频只有一项版权主张,则该值为 false;如果视频有多项版权主张,则该值为 true

注意:在 YouTube 创作者工作室的“报告”菜单中下载的报告中,此字段称为 Multiple Claims?
music_claim_type 指明版权主张涵盖的是所声明内容的音频、视频还是视听部分。此字段的有效值如下:
  • 音频
  • 音像
  • 图像
music_share 不同国家/地区和套餐的音乐活动的百分比。
net_partner_revenue 合作伙伴的净收入。
net_partner_revenue_post_revshare 应用收益分成比例后,合作伙伴的净收入。
revshare_rate_type 应用于收入的收益分成级别类型。
nonskippable_video_ads_enabled 指示视频是否播放第三方不可跳过的广告。插播视频广告会在内容视频播放期间展示。
notes 表示延迟调整付款情况下上个月的付款。
offweb_syndicatable 表示视频是否可以在浏览器外部显示。
overlay_ads_enabled 指明视频是否播放重叠式广告。重叠式广告是一种展示广告,会在视频播放 10 秒后显示在视频上方。
other_isrc 其他合作伙伴为相应资产提供的 ISRC。
other_owners_claiming 对相应视频主张版权的其他内容所有者的名称。
other_ownership_origination 其他所有者的原始所有权来源。
owned_views 您自有内容的参与式观看次数,其中您为相应内容设置的政策为“创收”或“跟踪”。

YouTube 广告报告和非音乐内容的 YouTube Premium 订阅报告均包含 policy 字段,用于指明与数据关联的政策是 monetize 还是 track
owned_subscription_views YouTube Premium 订阅者观看您拥有且内容政策为“创收”或“跟踪”的内容的总互动观看次数。
ownership 特定地区资产的所有者。
ownership_last_updated 上次更新所有权的日期和时间。
ownership_origination 原始所有权来源。
ownership_percentage 您占有的乐曲所有权百分比。
partner_audio_ad_revshare 根据账号的收入分配比率,按比例分成的 YouTube 音频层收入。用于计算两个收入数额中的较大值。
partner_audio_ad_revshare_rate 合作伙伴广告收入分配比率。
partner_playbacks YouTube 音频层服务中归因于您的内容的播放次数。
partner_revenue 应用收益分成比例后,您从广告中获得的收入(以美元为单位)。此字段会显示在 YouTube 广告报告中。youtube_revenue_split 字段包含应用收益分成比例之前的总收入。
partner_revenue_art_track 按比例分成的 YouTube Premium 订阅收入;针对在音像模式下播放的 Art Track 内容。
partner_revenue_audio 按比例分成的 YouTube Premium 订阅收入;针对在纯音频模式下播放的内容。
partner_revenue_local 应用收益分成比例后,您从广告中获得的以当地币种表示的收入。此字段会显示在 YouTube 广告报告中。youtube_revenue_split 字段包含应用收益分成比例之前的总收入。
partner_revenue_usd 应用收益分成比例后的广告收入。此字段会显示在 YouTube 广告报告中。youtube_revenue_split 字段包含应用收益分成比例之前的总收入。
partner_revenue_auction 通过竞价销售的 AdSense 广告带来的收入。
partner_revenue_per_play_min 根据每次播放带来的最低收入计算的收入。用于计算汇总到国家/地区层面时两个收入数额中的较大值。
partner_revenue_per_sub_min 根据每位订阅者产生的最低收入计算的每个国家/地区的收入;用于计算两个收入数额中的较大值。
partner_revenue_pro_rata 按比例分成的 YouTube Premium 订阅收入,考虑收益分成比例。
partner_revenue_pro_rata_audio 按比例分成的 YouTube Premium 订阅收入;针对在纯音频模式下播放的内容。
partner_revenue_pro_rata_audio_per_sub_min 按比例分成的 YouTube Premium 订阅收入;针对在纯音频模式下播放的内容。
partner_revenue_pro_rata_audio_visual 按比例分成的 YouTube Premium 订阅收入;针对在音像模式下播放的内容。
partner_revenue_pro_rata_partner_owned 按比例分成的 YouTube Premium 订阅收入;针对在音像模式下播放的合作伙伴上传的内容。
partner_revenue_pro_rata_ugc 按比例分成的 YouTube Premium 订阅收入;针对在音像模式下播放的用户生成的内容。
partner_revenue_pro_rata_art_track 按比例分成的 YouTube Premium 订阅收入;针对在音像模式下播放的 Art Track 内容。
partner_revenue_partner_sold_partner_served 您通过自己的外部广告服务器出售和投放的广告所带来的收入。
partner_revenue_partner_sold_youtube_served 通过 DoubleClick for Publishers (DFP) 销售广告获得的收入(在应用收益分成比例后)。
partner_revenue_reserved 通过 DoubleClick (DCLK) 和其他 YouTube 出售的来源以预订方式出售的广告为您带来的收入,在扣除收益分成后计算得出。
partner_revenue_ugc 您通过用户生成的内容获得的收入。
payment_period 付款的时间段。
per_play_minimum 相应国家/地区的每次播放带来的最低收入。
per_play_minimum_currency 音频每次播放带来的最低收入的币种。
per_play_minimum_partner_revenue 根据每次播放带来的最低收入计算的收入。用于计算两个收入数额中的较大值。
per_sub_min_rate 根据每位订阅者产生的最低收入计算的每个国家/地区的收入;用于计算两个收入数额中的较大值。
per_subs_min_rate 相应国家/地区的每位订阅者带来的最低收入。
policy 应用于视频的政策。值为 monetizetrack
pool_participating_rate 动态数据池中所有参与合作伙伴的广告支持型 (AVOD) 市场份额相对于基准主要平台的百分比。
postrolls_enabled 指示视频是否可以播放后贴片广告。片尾广告在观看者观看的视频或直播结束后展示。
prerolls_enabled 指明视频是否可以播放前贴片广告。前贴片广告在观看者观看的视频或直播开始前播放。有时,系统会播放多个前贴片广告。
provider 提供参考文件的内容所有者的姓名/名称。
ratings_allowed 指明是否已为相应视频启用评分。
record_label 资产元数据中的唱片公司名称。仅适用于音乐合作伙伴。
reference_id YouTube 为与版权主张关联的参考文件生成的 ID。对于合作伙伴上传的版权主张,此字段将留空。
reference_type 参考类型或渠道,例如 AudioVisualAudioVisual
reference_video_id YouTube 为参考文件生成的视频 ID。仅当版权主张与源自 YouTube 视频的参考文件相关联时适用。
release_date 资产元数据中的发布日期。仅适用于电视/电影合作伙伴。
revenue_source 指明收入来源。可能的值如下:
  • Ads - 视频中展示的广告带来的收入。
  • Subscriptions - YouTube Premium 付费订阅带来的收入。
  • Transactions - 交易收入,例如付费内容或购买交易带来的收入。
revenue_type 表示相应行所代表的收入类型。
right_type 指定与版权主张关联的乐曲权利类型。此字段的有效值如下:
  • 机械
  • 性能
  • 同步
season 与电视节目剧集相关联的季数。此字段的最大长度为 5 字节。
shorts_flat_fee_revenue_usd Shorts 的固定费用收入(以美元为单位)。
shorts_monthly_pool_usd Shorts 奖池的月度收入(以美元为单位)。
shorts_partner_revenue_usd Shorts 的合作伙伴收入(以美元为单位)。
shorts_usages_marketshare Shorts 使用的市场份额。
skippable_video_ads_enabled 指明相应视频是否已启用可跳过的视频广告。可跳过的插播广告在 YouTube 上以及 Google 视频合作伙伴的网站和应用中的其他视频播放前、播放过程中或播放后播放。广告播放 5 秒钟之后,观看者可以选择跳过广告,继续观看视频。
source_of_fingerprint 特定参考文件的指纹来源。
sponsored_cards_enabled 指示是否已为相应视频启用赞助卡片。借助赞助商品信息卡片,观看者可以购买视频中显示的商品。
sr_approx_daily_engaged_views 相应录音的每日互动观看次数的大概数量。
start_date 开始日期和时间。
status 表示资产的状态。可能的值为 activeinactive
studio 与相应媒体资源相关联的工作室。
subscribers 订阅人数。
tax_withholding_rate 预扣税报告中适用的预扣税率。
tax_withheld_amount 预扣税报告中预扣的税费金额。
third_party_ads_enabled 指明是否已为相应视频启用第三方广告。
third_party_video_id 合作伙伴提供的视频 ID,合作伙伴使用此 ID 来识别视频,以用于广告定位。
time_published 视频在 YouTube 上发布时的日期和时间,采用 MM/DD/YYYY HH:MM:SS 格式。如果视频从未公开(即私享视频或不公开列出的视频),此字段将为空白
time_uploaded 视频上传到 YouTube 的日期和时间,采用 MM/DD/YYYY HH:MM:SS 格式。
tms 由 12 至 14 个字符组成的 Tribune Media Systems (TMS) ID 值,用于唯一标识电影或电视节目。
total_playbacks YouTube 音频层服务中的总播放次数。
total_revenue_by_source 按来源划分的总收入,例如广告收入或订阅收入。
total_views 支持广告功能的用户产生的总观看次数。
unlaunched_territories_adjustment 针对未发布地区的短视频池的调整。
upc 通用商品代码 (UPC),用来明确标识某项资产的可选元数据字段。
uploader 上传视频的内容所有者的名称。
upload_source 将视频上传到 YouTube 所用的方法。
us_sourced_revenue 来自美国的收入金额。
usd_local_rate 美元兑换本地货币的汇率。该值表示整个报告期内每日交易的平均汇率。
username YouTube 内容所有者的名称。
video_channel_id YouTube 生成的频道标识符,其对应的频道发布了您主张版权的视频。
video_duration 视频的时长。
video_duration_sec 视频时长(以秒为单位)。
video_id 与相应行中的数据相关联的已声明版权的视频。该字段值是一个 YouTube 视频 ID,用于唯一标识相应视频。您可以使用 YouTube Data API 的 videos.list 方法检索有关视频的其他数据。
video_length 视频时长(以秒为单位)。
video_matching_length 已声明版权的视频中的总匹配时长。
video_privacy_status 指明视频是公开、私享还是不公开列出的。
video_title 与相应行中的数据相关联的视频的标题。
video_upload_date 您主张版权的视频的发布日期。
video_url YouTube 上视频的网址。
views 视频的观看次数。
writers 以竖线分隔的乐曲作者列表。
youtube_revenue_split

对于唱片公司、电影和电视合作伙伴:您的内容在 YouTube 上获得的广告总收入。然后,系统会根据收益分成比例拆分此金额。partner_revenue 字段包含您的收入。

对于音乐出版商:您的内容产生的 YouTube 广告总收入,已考虑资产所有权,但尚未根据收益分成比例进行分配。partner_revenue 字段包含您的收入。

youtube_revenue_split_auction

对于音乐唱片公司、电影和电视合作伙伴:通过竞价售出的 AdSense 广告带来的总收入(在应用收益分成之前)。

对于音乐出版商:通过竞价售出的 AdSense 广告带来的总收入,已考虑资源所有权,但尚未应用收益分成比例。

youtube_revenue_split_partner_sold_partner_served

对于唱片公司、电影和电视合作伙伴:合作伙伴售出/投放的广告带来的总收入。然后,系统会根据收益分成比例拆分此金额。partner_revenue_partner_served_partner_sold 包含从合作伙伴出售的广告和合作伙伴投放的广告中获得的收入。

对于音乐出版商:由合作伙伴出售并投放的广告带来的总收入,已将资产所有权考虑在内。然后,系统会根据收益分成比例拆分此金额。partner_revenue_partner_served_partner_sold 包含从合作伙伴出售的广告和合作伙伴投放的广告中获得的收入。

youtube_revenue_split_partner_sold_youtube_served

对于音乐唱片公司、电影和电视合作伙伴:来自 DFP 广告管理系统 (DFP) 的总收入。然后,系统会根据收益分成比例拆分此金额。partner_revenue_partner_served_partner_sold 包含从合作伙伴出售的广告和合作伙伴投放的广告中获得的收入。

对于音乐出版商:来自 DFP 广告管理系统 (DFP) 的总收入,考虑了资产所有权。然后,系统会根据收益分成比例拆分此金额。partner_revenue_partner_sold_youtube_sold 包含从合作伙伴出售的广告和合作伙伴投放的广告中获得的收入。

youtube_revenue_split_reserved

对于唱片公司、电影和电视合作伙伴:通过 DoubleClick (DCLK) 以预订方式出售的广告以及其他 YouTube 出售的来源提供的广告带来的总收入。然后,系统会根据收益分成比例拆分此金额。partner_revenue_reserved 包含来自这些来源的您的收入。

对于音乐出版商:通过 DoubleClick (DCLK) 和其他 YouTube 出售的来源以预订方式售出的广告带来的总收入,其中考虑了资产所有权。然后,系统会根据收益分成比例拆分此金额。partner_revenue_reserved 包含来自这些来源的您的收入。

your_isrc 您为相应资产提供的 ISRC。

Primetime

下表定义了 Primetime 节目合作伙伴的 YouTube Reporting API 系统管理报告中显示的字段:

字段
AgeGroup 报告中观看者的年龄段。请注意,特定年龄段的会员必须至少有 50 次观看活动,该年龄段才会列出。此字段的可能值包括:
  • 13-17
  • 18-24
  • 25-34
  • 35-44
  • 45-54
  • 55-64
  • 65+
AverageViewDuration 所有观看事件中节目的平均观看时长(以秒为单位)。
AverageViewPercent 所有观看事件中观看的节目时长的平均百分比。
CallSign 如果适用,则标识播放相应节目的电台的呼号。
ConcurrentViewers 观看事件的总数,其中包含由 MinutesSinceStart 字段值标识的剧集特定分钟的观看事件。
ContentId 元数据提供方(即您)用于标识资产并已提供给 YouTube 的唯一值。您可以使用此值将相应资源与您自己的内容管理系统进行对账。 该值可以是你为资产创建的唯一 ID,也可以是标准标识符,例如 TMS ID。该值的最大长度为 64 字节,可以包含字母数字字符、连字符 (-)、下划线 (_)、英文句号 (.)、@ 符号 (@) 或正斜线 (/)。
ContentLength 节目的时长(以秒为单位)。请注意,对于采用动态广告插播 (DAI) 的 VOD 节目,广告时长不包含在内。
ContentType 观看者观看内容的方式。此字段的可能值包括:
  • DVR:观看者录制了相应节目并将其保存到 DVR 中。
  • Live:观看者在节目首次直播期间观看了该节目。例如,观看者观看了一场体育赛事直播。
  • VOD:观看者选择了可按需观看的剧集或节目。
Date 节目观看发生的日期。该值的格式为 YYYYMMDD
DeviceType 观看者观看内容所用设备的类型。请注意,特定设备类型必须至少有 50 次观看活动,才能列出该设备类型。可能的字段值包括:
  • Computer
  • Console
  • Mobile Phone
  • Tablet
  • TV
DmaId Nielsen 用于标识与数据行中所述观看事件相关联的指定市场区域 (DMA) 的 3 位数标识符。
EpisodeNumber 如果适用,则用于标识指定季中节目的连续剧集编号。 剧季由 SeasonNumber 字段标识。例如,对于某个节目的第二季第一集,此值为 1
Gender 报告中观看者的性别。请注意,只有当特定性别的会员至少发生 50 次观看活动时,系统才会列出该性别。此字段的可能值包括:
  • Male
  • Female
MinutesSinceStart 观看活动开始时,距离节目开始的分钟数。请注意,此数字包括节目时间和广告时间,但使用动态广告插播 (DAI) 的点播 (VOD) 节目除外。对于采用 DAI 的 VOD 节目,该时长仅包含节目时长。
Network 发布内容或播放内容的电视台或影音平台。
PeakConcurrentViewers 特定节目在任意给定分钟内的并发观看活动数量上限。
Platform 观看者观看内容的方式。可能的字段值包括:
  • Android
  • iOS
  • TV HTML5
  • Web
ProgramTitle 剧集、电影或活动的标题或名称。
ProgramType 观看者观看的节目类型。可能的字段值包括:
  • PROGRAM_TYPE_UNKNOWN
  • PROGRAM_TYPE_MOVIE
  • PROGRAM_TYPE_EPISODE
  • PROGRAM_TYPE_COMPLEX_EPISODE
  • PROGRAM_TYPE_SPORTS
  • PROGRAM_TYPE_SPECIAL
  • PROGRAM_TYPE_EVENT
  • PROGRAM_TYPE_PAID_PROGRAMMING
PublishDateTime 节目的播出日期或发布日期。该值的格式为 YYYY-MM-DD
SeasonNumber 与节目相关联的季号。此字段的最大长度为 5 字节。
SeriesTitle 与报告行中的数据相关联的剧集的标题。例如,对于电视节目,此值将指定节目的名称,而 ProgramTitle 字段将指定剧集的标题。
TmsId 唯一标识节目的 12 至 14 个字符的 Tribune Media Systems (TMS) ID 值。
TotalWatchTime 所有观看活动中观看节目的总时长(以秒为单位)。
ViewersComplete 在直播、DVR 和 VOD 观看事件中,观看者在特定分钟(由 MinutesSinceStart 字段值标识)停止观看视频的总次数。如果 MinutesSinceStart 值表示的值短于整个节目 (ContentLength),则表示这些观看者在节目结束之前停止了观看。
ViewersResume 观看者在视频的第 1 分钟(第 0 分钟)以外的任何时间点开始观看 DVR 节目或 VOD 节目的观看事件总数。
ViewersStart 观看事件的总数,其中满足以下任一条件:
  • 观看者在相应节目的任意时间加入了直播。
  • 观看者在 DVR 节目的前 1 分钟(第 0 分钟)内的任意时间点开始观看。
  • 观看者在 VOD 节目的前 1 分钟(第 0 分钟)内的任意时间点开始观看。
Views 所有观看活动中节目的总观看次数。