電影、音樂和電視
下表定義 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,可做為頻道的專屬 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 |
擁有者政策的專屬 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 |
應用政策的專屬 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,也可以是標準 ID,例如 ISRC。值的長度上限為 64 位元組,而且可包含英數字元、連字號 (-)、底線 (_)、句號 (.)、「@」符號或正斜線 (/)。 |
date |
活動發生的日期。該值採用 YYYYMMDD 格式。
|
date_created |
參考檔案的建立日期與時間 (以世界標準時間為準)。 |
date_id |
活動發生的日期。該值採用 YYYYMMDD 格式。
|
day |
活動發生的日期。 |
director |
與資產相關聯的導演。 |
directors |
與資產相關聯的導演。 |
display_ads_enabled |
指出影片是否顯示第三方廣告。 |
display_isrc |
資產顯示的 ISRC。 |
effective_policy |
在內容擁有者具備擁有權的地區,影片適用的使用政策。 |
eidr |
分派給電影或電視節目的國際影視產業識別碼 (EIDR)。這個值包含 EIDR 識別碼的標準字首、正斜線、20 位數十六進制字串和英數 (0-9、A-Z) 檢查字元。 |
embedding_allowed |
指出影片是否可嵌入第三方網站。 |
end_date |
結束日期和時間。 |
engaged_views |
含廣告內容使用者產生的互動觀看次數總計。 |
engaged_views_in_conflict |
有爭議內容的互動觀看次數。 |
episode_number |
與影片相關聯的集數。 |
episode_title |
電視或電影劇集的名稱。 |
excluded_perc |
參考檔案中遭排除的區段比例 (相較於排除區段總長以及檔案總長度)。 |
exclusions |
參考檔案中遭排除的區段和類型 (例如參考檔案片段重疊、手動排除和無效的區段)。
可用的排除類型:
|
grid |
GRid 是用於識別資產的選填中繼資料欄位。這個欄位的值必須為 18 個英數字元。 |
has_multiple_claims |
指出影片是否有多項著作權聲明。如果影片只有一項著作權聲明,值為 false ;如果有多項著作權聲明,值為 true 。注意:在 YouTube 創作者工作室的「報表」選單中下載的報表,這個欄位會顯示為 Multiple Claims? 。
|
hfa |
Harry Fox Agency (HFA) 核發的樂曲專屬識別碼 (共六個字元)。 |
hfa_song_code |
Harry Fox Agency (HFA) 核發的樂曲專屬識別碼 (共六個字元)。 |
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) 純音訊參與串流次數。使用者原創內容是指使用者上傳的影片,這類影片的收益分享方式與合作夥伴提供的授權內容不同。這個欄位僅適用於音樂合作夥伴。 |
monetized_views_ugc_audio_visual |
在 YouTube Premium 訂閱服務中,歸屬你內容的使用者原創內容 (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 影片,報表才會顯示這個 ID。 |
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 個字元組成的論壇媒體系統 (TMS) ID 值,這是電影或電視節目的專屬 ID 值。 |
total_playbacks |
在 YouTube 純音訊層級服務中的總播放次數。 |
total_revenue_by_source |
按來源劃分的總收益,例如廣告或訂閱收益。 |
total_views |
含廣告內容使用者產生的觀看次數總計。 |
unlaunched_territories_adjustment |
未推出地區的 Shorts 集區調整。 |
upc |
通用產品代碼 (UPC) 是用於識別資產的選填中繼資料欄位。 |
uploader |
上傳影片的內容擁有者名稱。 |
upload_source |
將影片上傳至 YouTube 的方式。 |
us_sourced_revenue |
來自美國的收益金額。 |
usd_local_rate |
美元兌當地貨幣的匯率。這個值代表報表統計期間的每日交易平均匯率。 |
username |
YouTube 內容擁有者的名稱。 |
video_channel_id |
YouTube 為發布已聲明著作權影片的頻道產生的頻道 ID。 |
video_duration |
影片長度。 |
video_duration_sec |
影片長度 (以秒為單位)。 |
video_id |
與該列資料相關聯的著作權影片。這個欄位的值是 YouTube 影片 ID,可做為影片的專屬 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 |
音樂唱片公司、電影和電視合作夥伴:DoubleClick for Publishers (DFP) 的總收益。這筆金額隨後會根據收益分成率分配。
音樂發行商:DoubleClick for Publishers (DFP) 總收益,已計入資產擁有權。這筆金額隨後會根據收益分成率分配。 |
youtube_revenue_split_reserved |
音樂唱片公司、電影和電視合作夥伴:透過 DoubleClick (DCLK) 和其他 YouTube 銷售來源預訂銷售的廣告收益總額。這筆金額隨後會根據收益分成率分配。
音樂發行商:透過 DoubleClick (DCLK) 和其他 YouTube 銷售來源預訂銷售的廣告總收益,已計入資產擁有權。這筆金額隨後會根據收益分成率分配。 |
your_isrc |
您為資產提供的 ISRC。 |
特選
下表定義 YouTube Reporting API 系統管理報表中,為 Primetime 節目合作夥伴顯示的欄位:
欄位 | |
---|---|
AgeGroup |
報表中的觀眾年齡層。請注意,特定年齡層的成員必須至少有 50 次觀看事件,該年齡層才會列出。這個欄位可能的值包括:
|
AverageViewDuration |
所有觀看事件中,節目平均觀看秒數。 |
AverageViewPercent |
所有觀看事件的平均節目觀看百分比。 |
CallSign |
如適用,可識別節目播出的電台呼號。 |
ConcurrentViewers |
在特定分鐘數的集數 (由 MinutesSinceStart 欄位值識別) 觀看事件期間,觀看事件的總數。 |
ContentId |
這是中繼資料提供者用來識別資產的專屬值,且已提供給 YouTube。你可以使用這個值,在自己的內容管理系統中比對資產。 這個值可以是您為資產建立的專屬 ID,也可以是標準 ID,例如 TMS ID。值的長度上限為 64 位元組,而且可包含英數字元、連字號 (-)、底線 (_)、句號 (.)、「@」符號 (@) 或正斜線 (/)。 |
ContentLength |
節目長度 (以秒為單位)。請注意,如果是採用動態廣告插播 (DAI) 的隨選視訊節目,廣告長度不會計入。 |
ContentType |
觀眾觀看內容的方式。這個欄位可能的值包括:
|
Date |
節目觀看次數發生的日期。該值採用 YYYYMMDD 格式。
|
DeviceType |
觀眾觀看內容時所用的裝置類型。請注意,特定裝置類型必須至少有 50 個觀看事件,才會列出該裝置類型。可能的欄位值包括:
|
DmaId |
Nielsen 用來識別指定行銷區域 (DMA) 的 3 位數 ID,與資料列中描述的觀看事件相關聯。 |
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 個字元組成的論壇媒體系統 (TMS) ID 值,這是節目的專屬 ID 值。 |
TotalWatchTime |
所有觀看事件的節目觀看時間總長 (以秒為單位)。 |
ViewersComplete |
觀眾在特定分鐘內停止觀看影片的直播、DVR 和隨選視訊觀看事件總數,由 MinutesSinceStart 欄位值識別。如果 MinutesSinceStart 值代表的值短於整個節目 (ContentLength ),表示這些觀眾在節目結束前停止觀看。 |
ViewersResume |
觀眾在影片的第一分鐘 (第 0 分鐘) 以外的任何時間,開始觀看 DVR 節目或隨選影片節目的觀看事件總數。 |
ViewersStart |
符合下列任一條件的觀看事件總數:
|
Views |
所有觀看活動中,節目觀看次數的總和。 |