Content Owner Reports

本頁列出內容擁有者可透過 YouTube Reporting API 擷取的報表。API 的 reportTypes.list 方法傳回的每個報表 id,都會顯示在報表名稱旁的括號中。

影片報表

影片報表會提供與頻道影片或內容擁有者影片相關的所有使用者活動統計資料。舉例來說,這些報表會顯示影片的觀看次數。

使用者活動

這份報表提供與內容擁有者頻道和這些頻道影片相關的使用者活動統計資料。

這份報表的 idcontent_owner_basic_a4

目錄
尺寸: datechannel_idvideo_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_code
指標: engaged_viewsviewscommentsshareswatch_time_minutesaverage_view_duration_secondsaverage_view_duration_percentageannotation_click_through_rateannotation_close_rateannotation_impressionsannotation_clickable_impressionsannotation_closable_impressionsannotation_clicksannotation_closescard_click_ratecard_teaser_click_ratecard_impressionscard_teaser_impressionscard_clickscard_teaser_clickssubscribers_gainedsubscribers_lostvideos_added_to_playlistsvideos_removed_from_playlistslikesdislikes、red_views

使用者活動 (依省分組)

這份報表提供美國各州和哥倫比亞特區的使用者活動統計資料。

這份報表的 idcontent_owner_province_a3

目錄
尺寸: datechannel_idvideo_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeprovince_code
指標: engaged_viewsviewswatch_time_minutesaverage_view_duration_secondsaverage_view_duration_percentageannotation_click_through_rateannotation_close_rateannotation_impressionsannotation_clickable_impressionsannotation_closable_impressionsannotation_clicksannotation_closescard_click_ratecard_teaser_click_ratecard_impressionscard_teaser_impressionscard_clickscard_teaser_clicksred_viewsred_watch_time_minutes

播放位置

這份報表提供影片播放次數的統計資料,並依據播放影片的頁面或應用程式類型分類。

這份報表的 idcontent_owner_playback_location_a3

流量來源

這份報表會根據觀眾在內容擁有者頻道上觀看影片的方式,匯總觀看統計資料。 舉例來說,這項指標會指出 Google 搜尋或相關影片連結帶來的觀看次數。

這份報表的 idcontent_owner_traffic_source_a3

裝置類型和作業系統

這份報表會根據觀眾的作業系統和裝置類型,匯總影片觀看統計資料。舉例來說,這項指標會指出在 Android 平板電腦或 Windows 桌機上發生的觀看次數。

這份報表的 idcontent_owner_device_os_a3

觀眾客層

這份報表會根據觀眾的年齡層和性別匯總觀看統計資料。

這份報表的 idcontent_owner_demographics_a1

目錄
尺寸: datechannel_idvideo_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeage_groupgender
指標: views_percentage

內容共享 (依平台分組)

這份報表會提供統計資料,顯示內容擁有者頻道上的影片在不同社群平台上的分享頻率。

這份報表的 idcontent_owner_sharing_service_a1

目錄
尺寸: datechannel_idvideo_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codesharing_service
指標: 分享

註解

這份報表提供內容擁有者頻道影片中顯示的註解統計資料。

報表資料會評估每部影片中個別註解的成效,相較之下,使用者活動報表會匯總影片所有註解的統計資料。

這份報表的 idcontent_owner_annotations_a1

目錄
尺寸: datechannel_idvideo_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeannotation_typeannotation_id
指標: annotation_click_through_rateannotation_close_rateannotation_impressionsannotation_clickable_impressionsannotation_closable_impressionsannotation_clicksannotation_closes

資訊卡

這份報表提供內容擁有者頻道影片中顯示的資訊卡曝光次數和點閱率統計資料。

報表資料會評估個別資訊卡的成效,相較之下,使用者活動報表會匯總影片所有資訊卡的統計資料。

這份報表的 idcontent_owner_cards_a1

目錄
尺寸: datechannel_idvideo_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codecard_typecard_id
指標: card_click_ratecard_teaser_click_ratecard_impressionscard_teaser_impressionscard_clickscard_teaser_clicks

片尾

這份報表提供影片停止播放後顯示的片尾曝光次數和點閱率統計資料。

這份報表包含內容擁有者頻道中影片的統計資料。

這份報表的 idcontent_owner_end_screens_a1

目錄
尺寸: datechannel_idvideo_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeend_screen_element_typeend_screen_element_id
指標: end_screen_element_clicksend_screen_element_impressionsend_screen_element_click_rate

字幕

這份報表會提供統計資料,說明觀眾觀看影片時,使用時間最長的隱藏式輔助字幕語言。系統會排除字幕大多處於關閉狀態的觀看次數。

合併

這份報表會結合「播放位置」、「流量來源」和「裝置/作業系統」報表所用的維度,提供精細的影片統計資料。

這份報表的 idcontent_owner_combined_a3

目錄
尺寸: datechannel_idvideo_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeplayback_location_typetraffic_source_typedevice_typeoperating_system
指標: engaged_viewsviewswatch_time_minutesaverage_view_duration_secondsaverage_view_duration_percentagered_viewsred_watch_time_minutes

播放清單報表

播放清單報表會提供與播放清單中影片觀看次數相關的統計資料。

使用者活動

這份報表提供與使用者在內容擁有者頻道上與播放清單互動相關的統計資料。

這份報表的 idcontent_owner_playlist_basic_a2

使用者活動 (依省分組)

這份報表提供美國各州和哥倫比亞特區使用者與內容擁有者頻道播放清單互動的使用者活動統計資料。報表會經過篩選,只納入 country_code 維度的值為 US 的資料。

這份報表的 idcontent_owner_playlist_province_a2

播放位置

這份報表會提供播放清單播放次數的統計資料,並依發生播放次數的頁面或應用程式類型分類。

這份報表的 idcontent_owner_playlist_playback_location_a2

流量來源

這份報表會根據觀眾在內容擁有者頻道上觀看播放清單影片的方式,匯總觀看統計資料。舉例來說,這份報表會指出 Google 搜尋或相關影片連結帶來的觀看次數。

這份報表的 idcontent_owner_playlist_traffic_source_a2

裝置類型和作業系統

這份報表會根據觀眾的作業系統和裝置類型,匯總播放清單觀看統計資料。舉例來說,這項指標會指出在 Android 平板電腦或 Windows 桌機上發生的觀看次數。

這份報表的 idcontent_owner_playlist_device_os_a2

合併

這份報表會結合「播放位置」、「流量來源」和「裝置/作業系統」報表使用的維度,提供精細的播放清單統計資料。

這份報表的 idcontent_owner_playlist_combined_a2

廣告費率報表

廣告費率報表會提供影片播放期間放送廣告的曝光次數指標。這些指標會計算每次廣告曝光,而每次播放影片可能會產生多次曝光。

這個 API 支援下列廣告費率報表,提供內容擁有者影片的廣告費率指標。

這份報表的 idcontent_owner_ad_rates_a1

這份報表的舊版 ID 為 content_owner_ad_performance_a1,現已全面淘汰。

這個版本與上一個版本的唯一差異在於,這個版本將報表名稱中的「performance」改為「rates」。因此,報表本身的版本編號 (a1) 與先前版本相同,但 report ID 不同。

估算的收益報表

預估收益報表會提供影片的預估總收益,包括來自 Google 售出廣告來源和非廣告來源的收益。這些報表也包含一些廣告成效指標。

收益指標會找出特定收益來源,以及透過這些收益串流累積的總收益金額。

估算的影片收益

這份報表會列出內容擁有者所有影片透過 Google 售出的廣告來源,以及非廣告來源獲得的總收益。也包含部分廣告成效指標。

這份報表的 idcontent_owner_estimated_revenue_a2

估算的資產收益

這份報表會列出內容擁有者所有資產透過 Google 銷售的廣告來源和非廣告來源賺取的總收益。當中也包含部分廣告成效指標。請注意,channel_id 維度會識別上傳 video_id 的頻道,並提供相關指標。

這份報表的 idcontent_owner_asset_estimated_revenue_a2

資產報表

資產報表會提供與連結至內容擁有者資產的影片相關的使用者活動指標。如果內容擁有者聲明影片與其資產相符,該影片就會納入內容擁有者的報表。影片可能是由內容擁有者或其他 YouTube 使用者上傳。

在資產報表中,channel_id 維度會識別上傳 video_id 的頻道,並提供相關指標。

注意:如果影片在當天遭到著作權聲明,資產報表中的使用者活動指標可能不正確。造成差異的原因是,報表中的指標反映的是當天的所有使用者活動,而不只是在提出著作權聲明後發生的活動。

舉例來說,假設某部影片在特定一天內獲得 10 次觀看,隨後遭到著作權聲明,之後又獲得 10 次觀看。即使只有 10 次觀看是在聲明著作權後發生,當天的資產報表仍會顯示影片觀看次數為 20 次。所有後續日期的指標都應準確反映與已聲明著作權影片相關的使用者活動。

使用者活動

這份報表提供與使用者對連結至內容擁有者資產的影片所採取的動作相關的統計資料。

這份報表這個版本的 idcontent_owner_asset_basic_a3

目錄
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_code
指標: engaged_viewsviewscommentslikesdislikesvideos_added_to_playlistsvideos_removed_from_playlistsshareswatch_time_minutesaverage_view_duration_secondsaverage_view_duration_percentageannotation_click_through_rateannotation_close_rateannotation_impressionsannotation_clickable_impressionsannotation_closable_impressionsannotation_clicksannotation_closescard_click_ratecard_teaser_click_ratecard_impressionscard_teaser_impressionscard_clickscard_teaser_clicksred_viewsred_watch_time_minutes

使用者活動 (依省分組)

這份報表提供美國各州和哥倫比亞特區的使用者活動統計資料。這表示報表會經過篩選,只納入 country_code 維度的值為 US 的資料。這份報表的 idcontent_owner_asset_province_a3

這份報表這個版本的 idcontent_owner_asset_province_a3

目錄
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeprovince_code
指標: engaged_viewsviewswatch_time_minutesaverage_view_duration_secondsaverage_view_duration_percentageannotation_click_through_rateannotation_close_rateannotation_impressionsannotation_clickable_impressionsannotation_closable_impressionsannotation_clicksannotation_closescard_click_ratecard_teaser_click_ratecard_impressionscard_teaser_impressionscard_clickscard_teaser_clicksred_viewsred_watch_time_minutes

影片播放位置

這份報表提供影片播放次數的統計資料,並依據播放影片的頁面或應用程式類型分類。

這份報表這個版本的 idcontent_owner_asset_playback_location_a3

目錄
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeplayback_location_typeplayback_location_detail
指標: engaged_viewsviewswatch_time_minutesaverage_view_duration_secondsaverage_view_duration_percentagered_viewsred_watch_time_minutes

流量來源

這份報表會根據觀眾觀看與內容擁有者資產連結的影片內容時,所採用的方式彙整觀看統計資料。舉例來說,這項指標會指出 Google 搜尋或相關影片連結帶來的觀看次數。

這份報表這個版本的 idcontent_owner_asset_traffic_source_a3

目錄
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codetraffic_source_typetraffic_source_detail
指標: engaged_viewsviewswatch_time_minutesaverage_view_duration_secondsaverage_view_duration_percentagered_viewsred_watch_time_minutes

裝置類型和作業系統

這份報表會根據觀眾的作業系統和裝置類型,匯總影片觀看統計資料。舉例來說,這項指標會指出在 Android 平板電腦或 Windows 桌機上發生的觀看次數。

觀眾客層

這份報表會根據觀眾的年齡層和性別匯總觀看統計資料。這份報表的 idcontent_owner_asset_demographics_a1

目錄
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeage_groupgender
指標: views_percentage

內容共享 (依平台分組)

這份報表會顯示與內容擁有者資產連結的影片,在不同社群平台上的分享頻率統計資料。這份報表的 idcontent_owner_asset_sharing_service_a1

目錄
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codesharing_service
指標: 分享

註解

這份報表提供與內容擁有者資產連結的影片中顯示的註解統計資料。報表資料會評估個別註解的成效,相較之下,使用者活動報表會匯總影片所有註解的統計資料。這份報表的 idcontent_owner_asset_annotations_a1

目錄
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeannotation_typeannotation_title
指標: annotation_click_through_rateannotation_close_rateannotation_impressionsannotation_clickable_impressionsannotation_closable_impressionsannotation_clicksannotation_closes

資訊卡

這份報表提供資訊卡的曝光次數和點閱率統計資料,這些資訊卡會在連結至內容擁有者資產的影片中顯示。報表資料會評估個別資訊卡的成效,相較之下,使用者活動報表會匯總與資產連結的每部影片中顯示的所有資訊卡的統計資料。這份報表的 idcontent_owner_asset_cards_a1

目錄
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codecard_typecard_id
指標: card_click_ratecard_teaser_click_ratecard_impressionscard_teaser_impressionscard_clickscard_teaser_clicks

片尾

這份報表提供影片停止播放後顯示的片尾曝光次數和點閱率統計資料。這份報表包含內容擁有者頻道中已聲明著作權影片的統計資料,並列出與影片相關聯的資產。這份報表的 idcontent_owner_asset_end_screens_a1

目錄
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeend_screen_element_typeend_screen_element_id
指標: end_screen_element_clicksend_screen_element_impressionsend_screen_element_click_rate

合併

這份報表會結合「播放位置」、「流量來源」和「裝置/作業系統」報表所用的維度,提供精細的影片統計資料。

這份報表的 idcontent_owner_asset_combined_a3