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 - 與技術錯誤或資料修正相關的付款。這個值可以是抵免或扣款。
administer_publish_rights 指出唱片公司是否管理發布權,也就是收取並管理詞曲創作者、作曲家或發布商,或其他擁有樂曲的一方所應支付的權利金。可能的值為 TrueFalse
adsense_earnings_month 要查詢 AdSense 報表的收益月份。
album 錄音內容所屬的專輯。這個值的長度上限為 255 位元組。
approx_daily_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 擁有者政策的專屬 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、歌曲和演出者等中繼資料,MV 資產內嵌錄音資產。
  • 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 已套用政策的專屬 ID。目前,這個值僅適用於 API。但不會顯示在工作室內容管理工具中。
claim_policy_monetize 適用版權聲明政策為 Monetize 的地域,值為兩個英文字母的國家/地區代碼。
claim_policy_track 適用版權聲明政策為 Track 的地域,值為以兩個英文字母組成的國家/地區代碼。
claim_status 指出版權聲明狀態為 ACTIVEINACTIVEPENDING
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。
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,或是標準 ID (例如 ISRC)。值的長度上限為 64 位元組,而且可包含英數字元、連字號 (-)、底線 (_)、句號 (.)、「at」符號 (@) 或正斜線 (/)。
date 活動發生的日期。值採用 YYYYMMDD 格式。
date_created 參考檔案的建立日期與時間 (以世界標準時間為準)。
date_id 活動發生的日期。值採用 YYYYMMDD 格式。
day 活動發生的日期。
director 與資產相關聯的導演。
directors 與資產相關聯的導演。
display_ads_enabled 指出影片是否顯示第三方廣告。
effective_policy 在內容擁有者具備擁有權的地區,套用至影片的使用政策。
eidr 電影或電視劇集的國際影視產業識別碼 (EIDR)。這個值包含 EIDR 註冊的標準字首、正斜線、20 位數十六進制字串和英數 (0-9、A-Z) 檢查字元。
embedding_allowed 指明影片是否可嵌入第三方網站。
end_date 結束日期和時間。
episode_number 與影片相關的集數。
episode_title 電視節目或電影劇集的名稱。
excluded_perc 參考檔案中遭排除的區段比例 (相較於排除區段總長以及檔案總長度)
exclusions 參考檔案中遭排除的區段和類型 (例如參考檔案片段重疊、手動排除和無效的區段)。 可用的排除條件類型:
  • O = 透過內容管理員執行的手動排除
  • P = 透過 API 執行的手動排除
  • I = 透過內容上傳執行的手動排除
  • C = 參考檔案片段重疊
  • S = 無效的區段
  • B = 永久排除
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 位元組。
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) 純音訊串流播放次數。使用者原創內容是指使用者上傳的影片,這類內容在收益分潤方面不與合作夥伴提供的授權內容相同。此欄位僅適用於音樂合作夥伴。
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_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 影片時,報表才會顯示這個 ID。
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 指出影片是否已啟用贊助商資訊卡。贊助商產品資訊卡可讓觀眾購買影片中出現的產品。
start_date 開始日期和時間。
status 這個欄位會顯示資產的狀態。可能的值為 activeinactive
studio 與資產相關聯的工作室。
subscribers 訂閱者人數。
tax_withholding_rate 稅務預扣報表中適用的預扣稅率。
tax_withheld_amount 預扣稅報表中的預扣稅額。
third_party_ads_enabled 指出是否已為影片啟用第三方廣告。
third_party_video_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,可用於識別影片。您可以使用 YouTube Data API 的 videos.list 方法,擷取影片的其他資料。
video_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

唱片公司、電影和電視合作夥伴:透過 DoubleClick for Publishers (DFP) 獲得的總收益。然後再根據收益分潤率分配這筆金額。partner_revenue_partner_served_partner_sold 包含合作夥伴銷售、合作夥伴放送的廣告為你帶來的收益

音樂內容發布者:DoubleClick for Publishers (DFP) 的總收益,已按照資產擁有權分配款項。然後再根據收益分潤率分配這筆金額。partner_revenue_partner_sold_youtube_sold 包含合作夥伴銷售、合作夥伴放送的廣告帶來的收益

youtube_revenue_split_reserved

音樂唱片公司、電影和電視合作夥伴:透過 DoubleClick (DCLK) 和其他 YouTube 銷售來源預訂銷售的廣告總收益。然後再根據收益分潤率分配這筆金額。partner_revenue_reserved 包含來自這些來源的收益。

音樂出版商:透過 DoubleClick (DCLK) 和其他 YouTube 銷售來源預訂銷售的廣告總收益,已考量資產擁有權。系統會依據收益分潤率分配這筆金額。partner_revenue_reserved 包含來自這些來源的收益。

特選

下表定義了 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,或是標準 ID (例如 TMS ID)。值的長度上限為 64 位元組,而且可包含英數字元、連字號 (-)、底線 (_)、句號 (.)、「at」符號 (@) 或正斜線 (/)。
ContentLength 節目片長,以秒為單位。請注意,如果 VOD 節目採用動態廣告插入 (DAI) 功能,廣告時間不會納入計算。
ContentType 觀眾觀看內容的方式。可能的欄位值包括:
  • DVR:觀眾錄下節目並儲存到 DVR。
  • Live:觀眾在節目原始直播期間觀看節目。例如,觀眾觀看體育賽事直播。
  • VOD:觀眾選取可隨選觀看的單集或節目。
Date 節目觀看次數產生的日期。值採用 YYYYMMDD 格式。
DeviceType 觀眾觀看內容時所使用的裝置類型。請注意,特定裝置類型必須有至少 50 個觀看事件,系統才會列出該裝置類型。可能的欄位值包括:
  • Computer
  • Console
  • Mobile Phone
  • Tablet
  • TV
DmaId Nielsen 用來識別指定市場區域 (DMA) 與資料列中所述觀看事件的 3 位數 ID。
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 個字元組成的論壇媒體系統 (TMS) ID 值,這是節目的專屬 ID 值。
TotalWatchTime 所有觀看事件中觀看節目的總時間 (以秒為單位)。
ViewersComplete 觀眾在特定分鐘內停止觀看影片的直播、DVR 和 VOD 觀看事件總數,可透過 MinutesSinceStart 欄位值識別。如果 MinutesSinceStart 值代表的值比整個節目 (ContentLength) 短,表示這些觀眾在節目結束前就停止觀看。
ViewersResume 觀眾在影片的前 1 分鐘 (第 0 分鐘) 以外的任何時間點啟動 DVR 節目或 VOD 節目的觀看事件總數。
ViewersStart 符合下列任一條件的觀看事件總數:
  • 觀眾在節目任何時間加入直播。
  • 觀眾在 DVR 節目播放的第一分鐘 (0 分鐘) 內的任何時間點開始觀看。
  • 觀眾在 VOD 節目播放的前 1 分鐘內 (第 0 分鐘) 的任何時間點開始觀看。
Views 所有觀看事件中,節目總觀看次數。