System-Managed Reports - Fields

電影、音樂和電視

下表定義了電影、音樂和電視合作夥伴的 YouTube Reporting API 系統管理報表中顯示的欄位:

欄位
active_claims 有效的版權聲明數量。
active_reference_id YouTube 為相關有效參考檔案產生的 ID。
activity_month 報表月份。
adjustment_amount 以當地幣別表示的調整收益金額。
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 指出唱片公司是否管理發布權,也就是為詞曲創作者、作曲家、發布商或其他擁有樂曲著作權的當事人,收取及管理權利金。可能的值為 True 和 False。
adsense_earnings_month 要查詢 AdSense 報表的收益月份。
album 錄音內容所屬的專輯。值的長度上限為 255 個位元組。
approx_daily_views 資產的每日觀看次數平均值。
approx_daily_engaged_views 資產的每日互動觀看次數約略值。
approximate_request_timestamp YouTube 最早收到要求,為藝人啟用頻道的大概日期。
artist 與報表列中識別的資產相關聯的藝人名稱。值的長度上限為 255 個位元組。
artist_name 與藝人官方頻道啟用要求相關聯的原始藝人名稱。
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_label 與資產相關聯的資產標籤。
asset_labels 與資產相關聯的資產標籤。你可以使用資產標籤將資產歸類到自訂類別中。接著,您可以使用標籤搜尋資產、更新資產群組、為加上標籤的資產建立廣告活動、篩選 YouTube 數據分析等。
asset_metadata_type 參考檔案的資產類型,例如 Web 或 Movie。
asset_owners 參考檔案目前所屬的資產擁有者。在 1.1 以上版本中,這項資訊包含內容擁有者顯示名稱 (或外部 ID),而非合作夥伴代碼。
asset_policy_block 擁有者政策為「Block」的地域。值為該地域的雙字母國家/地區代碼。
asset_policy_id 擁有者政策的專屬 ID。目前只能透過 API 取得這個值。但不會顯示在工作室內容管理工具中。
asset_policy_monetize 擁有者政策為「Monetize」的地域,值為地域的雙字母國家/地區代碼。
asset_policy_track 擁有者政策為「Track」的地域,值為地域的雙字母國家/地區代碼。
asset_title 資產標題。
asset_type 資產類型。可能的值包括:
  • Art Track:代表 YouTube 上沒有 Premium MV 的錄音曲目。
  • Composition:代表樂曲。樂曲有 ISWC 和作者等中繼資料,這是唯一一種在每個地域可有多位擁有者的資產類型。可能內嵌於錄音資產。
  • Movie:代表劇情長片。電影擁有 ISAN/EIDR 和原創作者者等中繼資料。
  • Music Video:代表錄音內容的官方音樂影片。音樂影片擁有影片 ISRC、歌曲和演出者等中繼資料,其資產也包含錄音資產。
  • Sound Recording:代表錄音。錄音軌擁有 ISRC、演出者和專輯等中繼資料,且會內嵌樂曲資產;相對的,錄音軌也可能內嵌在音樂影片資產中。
  • Television episode:代表電視節目的劇集。它擁有播出季別和劇集編號等中繼資料。
  • Web:代表 YouTube Originals,或其他資產類型未涵蓋的其他類型影片內容。
audio_royalties 從 YouTube 純音訊層級收益中認列的收益。金額將根據「合作夥伴音訊的音訊廣告淨收益分成」或「音訊單次播放的最低合作夥伴收益」計算 (以較高者為準)。
audio_share 合作夥伴純音訊層級播放次數在總純音訊層級播放次數中的占比。
campaign_id 與交易相關聯的促銷廣告活動 ID。
category 影片類型,顯示在影片觀賞頁面。這個值是 YouTube 影片類別 ID。您可以使用 YouTube Data API 的 videoCategories.list 方法,擷取影片類別 ID 與類別名稱的對應關係。
channel_display_name 上傳影片的頻道顯示名稱。
channel_id 與該列資料相關聯的影片 (video_id) 所屬頻道。欄位值是 YouTube 頻道 ID,可專門識別頻道。您可以使用 YouTube Data API 的 channels.list 方法,擷取頻道的其他資料。
channel_name 與該列資料相關聯的 YouTube 頻道顯示名稱。
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 指定版權聲明的狀態。可能的值包括:
  • ACTIVE:著作權聲明有效。
  • APPEALED:上傳者對遭拒的版權聲明爭議提出申訴,目前正在等待合作夥伴審查。
  • DELAYED_TAKEDOWN:合作夥伴發出排定的下架要求,在下架生效前有 7 天的寬限期。
  • DISPUTED:上傳者已對版權聲明提出爭議,目前正在等待合作夥伴審查。
  • INACTIVE:著作權聲明無效。
  • PENDING:申請案正在等待狀態計算或處理。
  • POTENTIAL:著作權聲明為潛在著作權聲明,等待合作夥伴審查。
  • REMOVAL_UNDER_REVIEW:著作權聲明有肖像及聲音移除要求正在審查中。
  • REMOVED:收到肖像及聲音移除要求,因此已移除著作權聲明影片。
  • TAKEDOWN_UNDER_REVIEW:著作權聲明有著作權下架要求正在審查中。
  • TAKENDOWN:已聲明著作權的影片因著作權下架政策而遭下架。
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 指出影片是否啟用留言功能。
comp_custom_id 合作夥伴指派給詞曲資產的自訂 ID。
comp_id YouTube 資產 ID,用於明確識別詞曲資產。
comp_iswc 樂曲資產的國際標準音樂作品代碼 (ISWC)。
comp_title 作曲資產的標題。
comp_writers 樂曲的作曲者清單。
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。
contractual_minimum_partner_earnings_usd 合約規定的合作夥伴最低收益 (美元)。
conversion_rate 交易適用的貨幣匯率。
corrected_tax_withholding_rate 計算退稅時套用的修正預扣稅率。
country 活動發生地點的國家/地區。
country_code 活動發生國家/地區的代碼。這個值是 ISO 3166-1 alpha-2 國家/地區代碼。
coupon_used 指出交易是否使用了促銷優待券。
created_date 資產的建立日期。
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。
dpid 提交藝人官方頻道 (OAC) 要求的 DDEX 訊息傳送者 DDEX Party ID (DPID)。
earnings_usd 合作夥伴收益 (美元)。
effective_policy 在內容擁有者擁有權所屬地域,影片適用的使用政策。
eidr 指派給電影或電視劇集的國際影視產業識別碼機構 (EIDR) ID。這個值包含 EIDR 註冊資料庫的標準前置字元,後面依序為正斜線、20 個字元的十六進位字串,以及英數字元 (0-9A-Z) 檢查字元。
eidr_edit_id 資產的國際影視產業識別碼機構 (EIDR) 編輯層級 ID。
eidr_title_id 資產的國際影視產業識別碼機構 (EIDR) 影視內容層級 ID。
embedding_allowed 指出影片是否可嵌入第三方網站。
end_date 結束日期和時間。
engaged_views 含廣告內容使用者產生的互動觀看總次數。
engaged_views_in_conflict 爭議內容的參與收視次數。
episode_number 與影片相關聯的集數。
episode_title 電視節目或電影的劇集名稱。
excluded_perc 參考檔案中遭排除的區段比例 (相較於排除區段總長以及檔案總長度)。
exclusions 參考檔案中遭排除的區段和類型 (例如參考檔案片段重疊、手動排除和無效的區段)。 可用的排除類型:
  • O = 透過內容管理員執行的手動排除
  • P = 透過 API 執行的手動排除
  • I = 透過內容上傳執行的手動排除
  • C = 參考檔案片段重疊
  • S = 無效區隔
  • B = 永久排除
final_partner_earnings_usd 交易的最終合作夥伴收益 (美元)。
grid GRid 是用於識別資產的選填中繼資料欄位。欄位值包含 18 個英數字元。
has_multiple_claims 指出影片是否有多項著作權聲明。如果影片有一項版權聲明,這個值會是 false;如果有多項版權聲明,這個值會是 true。

注意:在 YouTube 工作室「報表」選單可下載的報表中,這個欄位稱為 Multiple Claims?。
hfa Harry Fox Agency (HFA) 核發的六字元代碼,用於識別特定作品。
hfa_song_code 由 Harry Fox Agency (HFA) 核發的六字元代碼,用於識別特定作曲。
id YouTube 資產 ID,用於明確辨識錄音資產。
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 已淘汰:這個欄位已淘汰,一律填入 No。先前用於指出是否可在影片播放期間,放送第三方不可略過的長版廣告。
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 訂閱服務中,歸屬你內容的使用者原創內容純音訊互動串流播放次數。使用者原創內容是指使用者上傳的影片,這類影片與合作夥伴提供的授權內容不同,不適用收益分潤。這個欄位僅適用於音樂合作夥伴。
monetized_views_ugc_audio_visual 在 YouTube Premium 訂閱服務中,歸屬你內容的使用者原創影音互動串流播放次數。使用者原創內容是指使用者上傳的影片,這類影片與合作夥伴提供的授權內容不同,不適用收益分潤。這個欄位僅適用於音樂合作夥伴。
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 各國家/地區和優惠的音樂活動百分比。
name_of_title 交易制隨選影片 (TVOD) 內容的標題。
native_contractual_minimum_partner_earnings 合約規定的合作夥伴最低收益 (以當地貨幣計算)。
native_final_partner_earnings 以合作夥伴當地幣別計算的最終合作夥伴收益。
native_partner_currency 合作夥伴收款時使用的當地幣別。
native_partner_earnings 合作夥伴收益 (以合作夥伴幣別計算)。
native_partner_earnings_using_tax_exclusive_retail_price 以當地幣別未稅零售價計算的合作夥伴收益。
native_partner_funded_discounts 合作夥伴資助的折扣金額 (以當地幣別計算)。
native_refunds_and_chargebacks 退款和交易退單金額 (以當地幣別計算)。
native_retail_currency 零售交易價格的幣別。
native_retail_price 零售交易價格,以當地零售幣別表示。
native_tax_exclusive_retail_price 以當地零售幣別表示的未稅零售交易價格。
native_total_tax 以當地幣別計算的稅金總額。
net_partner_revenue 合作夥伴的淨收益。
net_partner_revenue_post_revshare 套用收益分潤比例後,合作夥伴的淨收益。
revshare_rate_type 套用至收益的收益分潤費率類型。
nonskippable_video_ads_enabled 指出是否為影片播放第三方不可略過廣告。串流內影片廣告會在內容影片播放期間顯示。
notes 如果調整項款項延後支付,此欄會顯示前幾個月的付款。
number_of_evaluated_requests_in_sample 品質樣本中評估的藝人官方頻道 (OAC) 要求數量。
number_of_purchases 該影片的總購買次數。
number_of_refunds_and_chargebacks 書籍的退款和交易退單總數。
oac_channel 在藝人官方頻道啟用要求中,提供的自有自營頻道 ID。
oac_status 藝人頻道的最新藝人官方頻道 (OAC) 啟用狀態,例如啟用或停用。
oac_status_rationale 藝人官方頻道 (OAC) 啟用要求遭拒或待處理的原因。
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_earnings_fraction 計算合作夥伴收益時套用的收益分潤比例。
partner_earnings_usd 合作夥伴收益 (美元)。
partner_earnings_using_tax_exclusive_retail_price_usd 合作夥伴收益 (以美元計算),計算方式是使用未含稅的零售價格。
partner_funded_discounts_usd 合作夥伴資助的折扣金額 (美元)。
partner_name 合作夥伴名稱。
partner_playbacks 你的內容在 YouTube 純音訊層級服務中的播放次數。
partner_reporting_id 合作夥伴提供的資產報表 ID。
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 您從使用者原創內容獲得的收益。
partner_status 合作夥伴的藝人官方頻道 (OAC) 品質評估狀態。
payment_period 付款時間範圍。
per_play_minimum 該國家/地區的每播放最低費率。
per_play_minimum_currency 音訊單次播放最低收益的幣別。
per_play_minimum_partner_revenue 根據單次播放最低費率計算的收益,用來計算出較大的值。
per_sub_min_rate 根據單位訂閱者最低收益計算的每國家/地區收益;用來計算出較大的值。
per_subs_min_rate 該國家/地區的每位訂閱者最低費率。
percentage_of_high_severity_bad_requests 樣本中,嚴重錯誤率偏高的藝人官方頻道 (OAC) 要求百分比。
percentage_of_low_severity_bad_requests 樣本中,低嚴重性錯誤的藝人官方頻道 (OAC) 評估要求百分比。
play_asset_id 與內容相關聯的 Google Play 資產 ID。
policy 套用至影片的政策。值為 monetize 或 track。
pool_participating_rate 動態集區中所有參與合作夥伴的廣告隨選視訊 (AVOD) 市占率,相較於基準主要合作夥伴。
postrolls_enabled 指出影片是否可播放片尾廣告。片尾廣告會在觀眾觀看的影片或直播結束後播放。
prerolls_enabled 指出影片是否可播放片頭廣告。片頭廣告會在觀眾觀看的影片或直播前播放。有時會播放多則片頭廣告。
provider 提供參考檔案的內容擁有者名稱。
psaid 在藝人官方頻道 (OAC) 申請中提供的合作夥伴提供藝人 ID (PSAID)。
purchase_location 購買交易發生的平台或介面。
purchase_type 付費功能購買類型。
quantile 錄音資產的觀看次數分位數。
ratings_allowed 指出是否啟用影片評分功能。
record_label 資產中繼資料中的唱片公司名稱,僅適用於音樂合作夥伴。
reference_id YouTube 為版權聲明相關參考檔案提供的 ID。如為合作夥伴上傳的著作權聲明,這個欄位會留空。
reference_type 參考資料類型或管道,例如 Audio、Visual、AudioVisual。
reference_video_id YouTube 為參考影片提供的 ID。如果與版權聲明有關的參考檔案來源為 YouTube 影片,報表才會顯示這個 ID。
refund_chargeback 指出交易資料列代表退款或交易退單。
refunds_and_chargebacks_usd 退款和交易退單總金額 (美元)。
release_date 資產中繼資料中的發布日期,僅適用於電視/電影合作夥伴。
report_date 報表產生日期,採用人類可讀格式。
report_name 與管道調整項相關聯的來源報表名稱。
request_funnel 向 YouTube 提交藝人官方頻道 (OAC) 申請的管道,例如 DDEX 或舊版。
resolution 交易的影片解析度,例如 HD 或 SD。
retail_price_usd 零售交易價格 (美元)。
revenue_source 指出收益來源。可能的值包括:
  • Ads:影片中顯示的廣告所帶來的收益。
  • Subscriptions:YouTube Premium 付費訂閱收益。
  • Transactions:來自付費內容或購買等交易的收益。
revenue_type 指出資料列代表的收益類型。
right_type 指定與著作權聲明相關聯的樂曲權利類型。這個欄位的有效值如下:
  • 機械式
  • 效能
  • 同步處理
season 電視節目集數所屬的季別。這個欄位的長度上限為 5 個位元組。
season_title 與內容相關聯的電視節目季別名稱。
shorts_creations 使用該資產的 YouTube Shorts 創作數量。
shorts_flat_fee_revenue_usd Shorts 的固定費用收益 (美元)。
shorts_monthly_pool_usd Shorts 匯總收益的每月收益 (美元)。
shorts_partner_revenue_usd Shorts 合作夥伴收益 (美元)。
shorts_usages_marketshare Shorts 的市占率。
show_title 與內容相關聯的電視節目名稱。
skippable_video_ads_enabled 指出影片是否已啟用可略過的影片廣告。可略過的串流內廣告會在 YouTube 以及 Google 影片合作夥伴網站和應用程式上,於其他影片播放前後或播放期間放送。觀眾可在廣告播放 5 秒後選擇略過,然後繼續觀看影片。
source_of_fingerprint 參考檔案的指紋來源。
sponsored_cards_enabled 指出影片是否啟用贊助商資訊卡。贊助產品資訊卡可讓觀眾購買影片中出現的產品。
sr_approx_daily_engaged_views 錄音內容每日互動觀看次數的約略值。
start_date 開始日期和時間。
status 這個欄位會顯示資產的狀態。可能的值為 active 或 inactive。
status_change 表示與交易相關聯的任何狀態變更。
status_detail 提供參考檔案狀態的詳細資料或原因。這個欄位僅適用於每週參考檔案報表 1.1 版。
studio 與資產相關聯的工作室。
subscribers 訂閱人數。
tax_exclusive_retail_price_usd 以美元計算的零售交易未稅價格。
tax_refund_amount 以當地幣別計算的退稅金額。
tax_withholding_rate 預扣稅報表中的適用預扣稅率。
tax_withheld_amount 預扣稅報表中的預扣稅額。
territory 擁有權或活動適用的地域。
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。
title 與報表資料列中資料相關聯的資產標題。
title_name 交易制隨選影片 (TVOD) 內容的標題。
tms 12 到 14 個字元的 Tribune Media Systems (TMS) ID 值,可明確識別電影或電視節目。
total_playbacks 在 YouTube 純音訊層級服務中的總播放次數。
total_revenue_by_source 各來源的總收益,例如廣告或訂閱收益。
total_tax_usd 稅金總額 (美元)。
total_views 由含廣告內容使用者產生的總觀看次數。
transaction_date 交易日期。
transaction_import_source 匯入交易的來源系統。
transaction_type 交易類型,例如租借或購買。
unix_report_micros 報表產生時間的時間戳記,以 Unix 紀元起算,單位為微秒。
unlaunched_territories_adjustment 未推出服務的地域,其 Shorts 資金池的調整。
upc 通用產品代碼 (UPC) 是用於識別資產的選填中繼資料欄位。
upcs 最多 10 個通用產品代碼 (UPC) 的清單,這些代碼屬於包含藝人官方頻道 (OAC) 要求的發行內容。
uploader 上傳影片的內容擁有者名稱。
upload_source 影片上傳至 YouTube 的方式。
us_sourced_revenue 來自美國的收益金額。
usd_local_rate 美元與當地幣別之間的匯率,這個值代表報表統計期間的每日交易平均匯率。
username YouTube 內容擁有者的名稱。
vevo_enablement_status 透過 DDEX 提交的藝人官方頻道 (OAC) 要求,其 Vevo 啟用狀態。
video_category 影片內容的類別。
video_channel_id YouTube 為已聲明著作權影片所屬頻道產生的頻道 ID。
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

唱片公司、電影和電視合作夥伴: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_video_id YouTube 影片 ID,用於識別特定影片。
your_isrc 你為資產提供的 ISRC。

特選

下表定義了 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 的隨選影片節目,這個數字只會計入節目時間。
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 觀眾在影片前一分鐘 (第 0 分鐘) 以外的任何時間點,開始觀看 DVR 節目或 VOD 節目的觀看事件總數。
ViewersStart 符合下列任一條件的觀看事件總數:
  • 觀眾在節目期間的任何一分鐘加入直播。
  • 觀眾在 DVR 節目開始後 1 分鐘內 (第 0 分鐘) 播放節目。
  • 觀眾在隨選影片節目開始後 1 分鐘內 (第 0 分鐘) 的任何時間點開始觀看。
Views 所有觀看事件中,節目獲得的總觀看次數。