电影、音乐和电视
下表定义了电影、音乐和电视合作伙伴的 YouTube Reporting API 系统管理报告中显示的字段:
| 字段 | |
|---|---|
| active_claims | 有效版权主张的数量。 | 
| active_reference_id | YouTube 为关联的有效参考文件生成的 ID。 | 
| activity_month | 报告对应的月份。 | 
| adjustment_type | 表示相应行是正常收入数据,还是对之前报告的收入进行的调整: 
 | 
| administer_publish_rights | 指明唱片公司是否负责管理出版权,即是否为歌曲作者、作曲家或出版商或乐曲的其他所有者收取和管理版税。可能的值有 True和False。 | 
| 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 | 资产的类型。可能的值包括: 
 | 
| 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 | 针对视频创建版权主张所用的方法。可能的字段值包括: 
 | 
| claim_policy_block | 适用的主张政策是 Block的地区。值是两个字母的国家/地区代码。 | 
| claim_policy_id | 已应用政策的唯一标识符。目前,此值仅在 API 中可用。此信息不会显示在工作室内容管理器中。 | 
| claim_policy_monetize | 适用的主张政策是 Monetize的地区。值是两个字母的国家/地区代码。 | 
| claim_policy_track | 适用的主张政策是 Track的地区。值是两个字母的国家/地区代码。 | 
| claim_status | 指明版权主张的状态是 ACTIVE、INACTIVE还是PENDING。 | 
| claim_status_detail | 版权主张状态的详细信息,例如 CLOSED_MANUALLY。 | 
| claim_type | 指明版权主张涵盖的是所声明内容的音频、视频还是视听部分。此字段的有效值如下: 
 | 
| claim_quality | 已声明版权的视频的来源。此字段的可能值包括: 
 注意:在 YouTube 创作者工作室的“报告”菜单中下载的报告中,此字段称为  | 
| 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 | 已声明版权的视频的来源。可能的值包括: 
 | 
| 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 | 参考文件中被排除的部分和排除类型(例如,参考文件雷同内容、人工排除的内容、无效片段)。
可用的排除类型: 
 | 
| 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_audio、monetized_views_partner_owned_audio和monetized_views_ugc_audio字段的总和。此字段仅适用于音乐合作伙伴。 | 
| monetized_views_audio_visual | YouTube Premium 订阅服务中归因于您的内容的音像互动播放总次数。该值是 monetized_views_art_track_audiovisual、monetized_views_partner_owned_audiovisual和monetized_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 | 应用于视频的政策。值为 monetize或track。 | 
| pool_participating_rate | 动态数据池中所有参与合作伙伴的广告支持型 (AVOD) 市场份额相对于基准主要平台的百分比。 | 
| postrolls_enabled | 指示视频是否可以播放后贴片广告。片尾广告在观看者观看的视频或直播结束后展示。 | 
| prerolls_enabled | 指明视频是否可以播放前贴片广告。前贴片广告在观看者观看的视频或直播开始前播放。有时,系统会播放多个前贴片广告。 | 
| provider | 提供参考文件的内容所有者的姓名/名称。 | 
| ratings_allowed | 指明是否已为相应视频启用评分。 | 
| record_label | 资产元数据中的唱片公司名称。仅适用于音乐合作伙伴。 | 
| reference_id | YouTube 为与版权主张关联的参考文件生成的 ID。对于合作伙伴上传的版权主张,此字段将留空。 | 
| reference_type | 参考类型或渠道,例如 Audio、Visual、AudioVisual。 | 
| reference_video_id | YouTube 为参考文件生成的视频 ID。仅当版权主张与源自 YouTube 视频的参考文件相关联时适用。 | 
| release_date | 资产元数据中的发布日期。仅适用于电视/电影合作伙伴。 | 
| revenue_source | 指明收入来源。可能的值如下: 
 | 
| 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 | 表示资产的状态。可能的值为 active或inactive。 | 
| 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 上获得的广告总收入。然后,系统会根据收益分成比例拆分此金额。 
对于音乐出版商:您的内容产生的 YouTube 广告总收入,已考虑资产所有权,但尚未根据收益分成比例进行分配。 | 
| youtube_revenue_split_auction | 对于音乐唱片公司、电影和电视合作伙伴:通过竞价售出的 AdSense 广告带来的总收入(在应用收益分成之前)。 对于音乐出版商:通过竞价售出的 AdSense 广告带来的总收入,已考虑资源所有权,但尚未应用收益分成比例。 | 
| youtube_revenue_split_partner_sold_partner_served | 
对于唱片公司、电影和电视合作伙伴:合作伙伴售出/投放的广告带来的总收入。然后,系统会根据收益分成比例拆分此金额。 
对于音乐出版商:由合作伙伴出售并投放的广告带来的总收入,已将资产所有权考虑在内。然后,系统会根据收益分成比例拆分此金额。 | 
| youtube_revenue_split_partner_sold_youtube_served | 
对于音乐唱片公司、电影和电视合作伙伴:来自 DFP 广告管理系统 (DFP) 的总收入。然后,系统会根据收益分成比例拆分此金额。 
对于音乐出版商:来自 DFP 广告管理系统 (DFP) 的总收入,考虑了资产所有权。然后,系统会根据收益分成比例拆分此金额。 | 
| youtube_revenue_split_reserved | 
对于唱片公司、电影和电视合作伙伴:通过 DoubleClick (DCLK) 以预订方式出售的广告以及其他 YouTube 出售的来源提供的广告带来的总收入。然后,系统会根据收益分成比例拆分此金额。 
对于音乐出版商:通过 DoubleClick (DCLK) 和其他 YouTube 出售的来源以预订方式售出的广告带来的总收入,其中考虑了资产所有权。然后,系统会根据收益分成比例拆分此金额。 | 
| your_isrc | 您为相应资产提供的 ISRC。 | 
Primetime
下表定义了 Primetime 节目合作伙伴的 YouTube Reporting API 系统管理报告中显示的字段:
| 字段 | |
|---|---|
| AgeGroup | 报告中观看者的年龄段。请注意,特定年龄段的会员必须至少有 50 次观看活动,该年龄段才会列出。此字段的可能值包括: 
 | 
| AverageViewDuration | 所有观看事件中节目的平均观看时长(以秒为单位)。 | 
| AverageViewPercent | 所有观看事件中观看的节目时长的平均百分比。 | 
| CallSign | 如果适用,则标识播放相应节目的电台的呼号。 | 
| ConcurrentViewers | 观看事件的总数,其中包含由 MinutesSinceStart字段值标识的剧集特定分钟的观看事件。 | 
| ContentId | 元数据提供方(即您)用于标识资产并已提供给 YouTube 的唯一值。您可以使用此值将相应资源与您自己的内容管理系统进行对账。 该值可以是你为资产创建的唯一 ID,也可以是标准标识符,例如 TMS ID。该值的最大长度为 64 字节,可以包含字母数字字符、连字符 (-)、下划线 (_)、英文句号 (.)、@ 符号 (@) 或正斜线 (/)。 | 
| ContentLength | 节目的时长(以秒为单位)。请注意,对于采用动态广告插播 (DAI) 的 VOD 节目,广告时长不包含在内。 | 
| ContentType | 观看者观看内容的方式。此字段的可能值包括: 
 | 
| Date | 节目观看发生的日期。该值的格式为 YYYYMMDD。 | 
| DeviceType | 观看者观看内容所用设备的类型。请注意,特定设备类型必须至少有 50 次观看活动,才能列出该设备类型。可能的字段值包括: 
 | 
| DmaId | Nielsen 用于标识与数据行中所述观看事件相关联的指定市场区域 (DMA) 的 3 位数标识符。 | 
| EpisodeNumber | 如果适用,则用于标识指定季中节目的连续剧集编号。
剧季由 SeasonNumber字段标识。例如,对于某个节目的第二季第一集,此值为1。 | 
| Gender | 报告中观看者的性别。请注意,只有当特定性别的会员至少发生 50 次观看活动时,系统才会列出该性别。此字段的可能值包括: 
 | 
| MinutesSinceStart | 观看活动开始时,距离节目开始的分钟数。请注意,此数字包括节目时间和广告时间,但使用动态广告插播 (DAI) 的点播 (VOD) 节目除外。对于采用 DAI 的 VOD 节目,该时长仅包含节目时长。 | 
| Network | 发布内容或播放内容的电视台或影音平台。 | 
| PeakConcurrentViewers | 特定节目在任意给定分钟内的并发观看活动数量上限。 | 
| Platform | 观看者观看内容的方式。可能的字段值包括: 
 | 
| ProgramTitle | 剧集、电影或活动的标题或名称。 | 
| ProgramType | 观看者观看的节目类型。可能的字段值包括: 
 | 
| 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 | 观看事件的总数,其中满足以下任一条件: 
 | 
| Views | 所有观看活动中节目的总观看次数。 |