電影、音樂和電視
下表定義了電影、音樂和電視合作夥伴的 YouTube Reporting API 系統管理報表中顯示的欄位:
| 欄位 | |
|---|---|
active_claims |
有效的版權聲明數量。 |
active_reference_id |
YouTube 為相關有效參考檔案產生的 ID。 |
activity_month |
報表月份。 |
adjustment_amount |
以當地幣別表示的調整收益金額。 |
adjustment_type |
指出資料列代表正常收益資料,還是先前收益報表的調整項:
|
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 |
資產類型。可能的值包括:
|
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 |
對影片提出版權聲明的方式。可能的欄位值如下:
|
claim_policy_block |
適用版權聲明政策為「Block」的地域,值為兩個字母的國家/地區代碼。
|
claim_policy_id |
應用政策的專屬 ID,目前只能透過 API 取得這個值。但不會顯示在工作室內容管理工具中。 |
claim_policy_monetize |
適用版權聲明政策為「Monetize」的地域,值為兩個字母的國家/地區代碼。
|
claim_policy_track |
適用版權聲明政策為「Track」的地域,值為兩個字母的國家/地區代碼。
|
claim_status |
指定版權聲明的狀態。可能的值包括:
|
claim_status_detail |
版權聲明狀態的詳細資訊,例如「CLOSED_MANUALLY」。 |
claim_type |
指出版權聲明涵蓋聲明內容的音訊、影片或影音部分。這個欄位的有效值如下:
|
claim_quality |
已聲明著作權影片的來源。可能的欄位值包括:
|
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 |
已聲明著作權影片的來源。可能的值包括:
|
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 |
參考檔案中遭排除的區段和類型 (例如參考檔案片段重疊、手動排除和無效的區段)。
可用的排除類型:
|
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 |
指出收益來源。可能的值包括:
|
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 廣告總收益。這筆金額隨後會依收益分潤費率分配。
詞曲出版社:內容產生的 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 銷售來源,預訂銷售廣告獲得的總收益,已按照資產擁有權分配款項。這筆金額隨後會根據收益分潤率分配。 |
youtube_video_id |
YouTube 影片 ID,用於識別特定影片。 |
your_isrc |
你為資產提供的 ISRC。 |
特選
下表定義了 YouTube Reporting API 系統管理報表中,特選節目合作夥伴會看到的欄位:
| 欄位 | |
|---|---|
AgeGroup |
報表中觀眾的年齡層。請注意,特定年齡層的成員必須至少有 50 次觀看事件,系統才會列出該群組。可能的欄位值包括:
|
AverageViewDuration |
所有觀看事件中,節目的平均觀看秒數。 |
AverageViewPercent |
所有觀看事件中,節目平均觀看時間比例。 |
CallSign |
如果適用,請指明播出節目的電台呼號。 |
ConcurrentViewers |
觀看事件總數,其中包含由 MinutesSinceStart 欄位值識別的特定分鐘數。 |
ContentId |
你 (中繼資料提供者) 用來識別資產並提供給 YouTube 的專屬值。你可以使用這個值,在自己的內容管理系統中核對資產。 這個值可以是您為資產建立的專屬 ID,也可以是標準 ID,例如 TMS ID。值長度上限為 64 個位元組,可包含英數字元、連字號 (-)、底線 (_)、半形句號 (.)、「at」符號 (@) 或正斜線 (/)。 |
ContentLength |
節目長度 (以秒為單位)。請注意,如果 VOD 節目採用動態廣告插播 (DAI),廣告時間長度不會計入。 |
ContentType |
觀眾觀看內容的方式。可能的欄位值包括:
|
Date |
節目觀看次數的產生日期。值的格式為 YYYYMMDD。 |
DeviceType |
觀眾觀看內容時使用的裝置類型。請注意,特定裝置類型必須至少有 50 次觀看事件,才會列出該裝置類型。可能的欄位值如下:
|
DmaId |
Nielsen 用來識別指定行銷區域 (DMA) 的 3 位數 ID,與資料列中描述的觀看事件相關聯。 |
EpisodeNumber |
如果適用,請指明節目在指定季別中的集數。
季別由 SeasonNumber 欄位識別。舉例來說,如果節目是第二季第一集,這個值會是 1。 |
Gender |
報表中觀眾的性別。請注意,特定性別的成員必須至少有 50 次觀看事件,該性別才會列出。可能的欄位值包括:
|
MinutesSinceStart |
觀看事件開始時,節目已播放的分鐘數。請注意,這個數字包含節目時間和廣告時間,但使用動態廣告插播 (DAI) 的隨選 (VOD) 節目除外。如果是採用 DAI 的隨選影片節目,這個數字只會計入節目時間。 |
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 |
觀眾在影片前一分鐘 (第 0 分鐘) 以外的任何時間點,開始觀看 DVR 節目或 VOD 節目的觀看事件總數。 |
ViewersStart |
符合下列任一條件的觀看事件總數:
|
Views |
所有觀看事件中,節目獲得的總觀看次數。 |