本頁面列出內容擁有者可使用 YouTube Reporting API 擷取的報表。每個報表的 id
(由 API 的 reportTypes.list
方法所傳回) 會顯示在報表名稱旁的括號中。
影片報表
影片報告會針對頻道或內容擁有者影片相關的所有使用者活動提供統計資料。舉例來說,這些報表包含您的影片獲得觀看次數。
使用者活動
這份報表提供了與內容擁有者頻道及這些頻道影片相關的使用者活動統計資料。目前報告版本的 id
為 content_owner_basic_a3
。
這份報表的id
是 content_owner_basic_a3
。這個版本與 a2
版之間有以下差異:
- 新增 red_views 指標
- 新增 red_watch_time_minutes 指標
目錄 | |
---|---|
尺寸: | date、channel_id、video_id、claimed_status、uploader_type、live_or_on_demand、subscribed_status、country_code |
指標: | 和 10.000 的 |
注意:content_owner_basic_a1
報表已全面淘汰。
使用者活動 (依省分組)
本報告提供美國各州及哥倫比亞特區的使用者活動統計資料。這份報表的id
是 content_owner_province_a2
。
這份報表的id
是 content_owner_province_a2
。這個版本與 a1
版之間有以下差異:
- 新增 red_views 指標
- 新增 red_watch_time_minutes 指標
播放位置
此報表提供與播放影片或網頁或應用程式類型相關的統計資料。這份報表的id
是 content_owner_playback_location_a2
。
這份報表的id
是 content_owner_playback_location_a2
。這個版本與 a1
版之間有以下差異:
- 新增 red_views 指標
- 新增 red_watch_time_minutes 指標
流量來源
這份報表會依據觀眾在內容擁有者頻道中收看影片的方式,彙整觀看統計資料。例如,Google 搜尋可產生的觀看次數,包括來自 Google 搜尋或相關影片連結的觀看次數。這份報表的id
是 content_owner_traffic_source_a2
。
這份報表的id
是 content_owner_traffic_source_a2
。這個版本與 a1
版之間有以下差異:
- 新增 red_views 指標
- 新增 red_watch_time_minutes 指標
裝置類型和作業系統
這份報表會依據觀眾作業系統和裝置類型彙整影片觀看次數統計資料。舉例來說,該報表可識別 Android 平板電腦或 Windows 電腦裝置的觀看次數。這份報表的id
是 content_owner_device_os_a2
。
這份報表的id
是 content_owner_device_os_a2
。這個版本與 a1
版之間有以下差異:
- 新增 red_views 指標
- 新增 red_watch_time_minutes 指標
觀眾客層
這份報表會依據觀眾年齡層和性別匯總觀看統計資料。
這份報表的id
為 content_owner_demographics_a1
。
目錄 | |
---|---|
尺寸: | date、channel_id、video_id、claimed_status、uploader_type、live_or_on_demand、subscribed_status、country_code、age_group、gender |
指標: | 觀看次數百分比 |
內容共享 (依平台分組)
這份報表提供了統計資料,說明內容擁有者頻道在不同社交平台上分享影片的頻率。
這份報表的id
為 content_owner_sharing_service_a1
。
目錄 | |
---|---|
尺寸: | date、channel_id、video_id、claimed_status、uploader_type、live_or_on_demand、subscribed_status、country_code、sharing_service |
指標: | 分享次數 |
註解
這份報告提供的統計資料,說明在內容擁有者的頻道影片中,顯示哪些註解。報表資料會評估每部影片個別註解的成效。相較之下,使用者活動報表則會匯總所有影片註解的統計資料。
這份報表的id
為 content_owner_annotations_a1
。
卡片
這份報表會針對內容擁有者頻道影片中播放的資訊卡,提供曝光次數和點閱後統計資料。
報表資料會評估個別資訊卡的成效。相較之下,使用者活動報表會匯總所有影片資訊卡的統計資料。
這份報表的id
為 content_owner_cards_a1
。
片尾
這份報表會針對影片停止播放後顯示的片尾提供曝光次數和點閱後統計資料。
這份報表含有內容擁有者頻道中的影片統計資料。
這份報表的id
是 content_owner_end_screens_a1
。
字幕
本報表提供影片觀看次數最長的隱藏式輔助字幕語言統計資料。但大部分影片字幕功能大多都是關閉狀態。這份報表的id
是 content_owner_subtitles_a2
。
這份報表的id
是 content_owner_subtitles_a2
。這個版本與 a1
版之間有以下差異:
- 新增 red_views 指標
- 新增 red_watch_time_minutes 指標
合併
這份報表結合了「播放位置」、「流量來源」和「裝置/作業系統」報表中使用的維度,提供精細的影片統計資料。這份報表的id
是 content_owner_combined_a2
。
這份報表的id
是 content_owner_combined_a2
。這個版本與 a1
版之間有以下差異:
- 新增 red_views 指標
- 新增 red_watch_time_minutes 指標
播放清單報表
播放清單報表提供與播放清單相關的影片觀看次數相關的統計資料。
使用者活動
這份報表提供使用者與內容擁有者頻道播放清單中使用者互動相關的統計資料。這份報表的id
是 content_owner_playlist_basic_a1
。
使用者活動 (依省分組)
這份報告會針對美國各州和哥倫比亞特區的使用者提供使用者與內容擁有者播放清單中播放清單互動情形的使用者活動統計資料。也就是說,如果 country_code 維度的值是 US
,報表會經過篩選,只納入資料。這份報表的id
是 content_owner_playlist_province_a1
。
播放位置
此報表提供與播放播放清單的網頁或應用程式類型相關的統計資料。這份報表的id
是 content_owner_playlist_playback_location_a1
。
流量來源
這份報表會依據觀眾在內容擁有者頻道上觸及播放清單影片的方式,彙整觀看統計資料。
例如,Google 搜尋可產生的觀看次數,包括來自 Google 搜尋或相關影片連結的觀看次數。這份報表的id
是 content_owner_playlist_traffic_source_a1
。
裝置類型和作業系統
這份報表會依據觀眾作業系統和裝置類型彙整出播放清單的檢視統計資料。舉例來說,該報表可識別 Android 平板電腦或 Windows 電腦裝置的觀看次數。這份報表的id
是 content_owner_playlist_device_os_a1
。
合併
這份報表結合了「播放位置」、「流量來源」和「裝置/作業系統」報表中所使用的維度,提供精細的播放清單統計資料。這份報表的id
是 content_owner_playlist_combined_a1
。
廣告費率報表
廣告費率報表提供影片播放期間所放送廣告的曝光機會指標。這些指標會計入每次廣告曝光,且每次影片播放都會帶來多次曝光。
這個 API 支援下列廣告費率報表,可提供內容擁有者影片的廣告費率指標。目前報告版本的 id
為 content_owner_ad_rates_a1
。
這份報表的id
是 content_owner_ad_rates_a1
。舊版報表 (目前已淘汰) 的 ID 是 content_owner_ad_performance_a1
。
與前一版相比的唯一差別是,這個版本會將報表名稱更新為使用「rates
」字詞,而不是 performance
字詞。因此,報表本身的版本號碼 (a1
) 與先前版本相同,但 report ID
不同。
目錄 | |
---|---|
尺寸: | date、channel_id、video_id、claimed_status、uploader_type、country_code、ad_type |
指標: | estimated_youtube_ad_revenue、ad_impressions、estimated_cpm |
估算的收益報表
預估收益報表會提供來自 Google 銷售的廣告來源,以及來自非廣告來源的影片的預估總收益。這類報表也包含一些廣告成效成效指標。
收益指標可識別特定收益來源,以及透過這些收益來源累積的總收益金額。
估算的影片收益
這份報表提供了內容擁有者所有影片從 Google 銷售的廣告來源,以及來自非廣告來源的所有影片總收益。以及一些廣告成效指標。目前報告版本的 id
為 content_owner_estimated_revenue_a1
。
這份報表的id
是 content_owner_estimated_revenue_a1
。與舊版 (content_owner_estimated_earnings_a1
) 的差異如下:
- 新增 estimated_partner_red_revenue 指標
- 新增 estimated_partner_transaction_revenue 指標
- 將 estimated_partner_ad_sense_revenue 指標重新命名為 estimated_partner_ad_auction_revenue
- 將 estimated_partner_double_click_revenue 指標重新命名為 estimated_partner_ad_reserved_revenue
- 更新報表名稱,改用
revenue
字詞,而不是earnings
字詞。因此,報表本身的版本號碼 (a1
) 與先前版本相同,但report ID
不同。
估算的資產收益
這份報表提供了內容擁有者從 Google 銷售的廣告來源,以及來自非廣告來源的所有資產總收益。以及一些廣告成效指標。請注意,channel_id 維度可識別上傳 video_id 的指標,做為提供指標的管道。目前報告版本的 id
為 content_owner_asset_estimated_revenue_a1
。
這份報表的id
是 content_owner_asset_estimated_revenue_a1
。與舊版 (content_owner_asset_estimated_earnings_a1
) 的差異如下:
- 新增 estimated_partner_red_revenue 指標
- 新增 estimated_partner_transaction_revenue 指標
- 將 estimated_partner_ad_sense_revenue 指標重新命名為 estimated_partner_ad_auction_revenue
- 將 estimated_partner_double_click_revenue 指標重新命名為 estimated_partner_ad_reserved_revenue
- 更新報表名稱,改用
revenue
字詞,而不是earnings
字詞。因此,報表本身的版本號碼 (a1
) 與先前版本相同,但report ID
不同。
資產報表
資產報表可提供與內容擁有者資產連結影片相關的使用者活動指標。內容擁有者在 YouTube 的內容擁有者報表中,發現某部影片符合某項內容擁有者的某項資產。影片可能是由內容擁有者或其他 YouTube 使用者所上傳。
在素材資源報表中,channel_id 維度可識別上傳 video_id 時提供的指標指標。
舉例來說,假設在某一天,某個影片獲得了 10 次觀看,系統接著對該部影片發出了 10 次版權聲明。當天的資產報告將指出該影片有 20 次觀看次數,即使在這些內容收到版權聲明後,只有 10 次是來自這個網頁。未來連續指標的指標應正確反映與已聲明版權影片相關的使用者活動。
使用者活動
這份報表會針對使用者與內容擁有者資產連結的影片相關的動作,提供相關的統計資料。這份報表的id
是 content_owner_asset_basic_a2
。
這份報表的id
是 content_owner_asset_basic_a2
。這個版本與 a1
版之間有以下差異:
- 新增 red_views 指標
- 新增 red_watch_time_minutes 指標
目錄 | |
---|---|
尺寸: | date、channel_id、video_id、asset_id、claimed_status、uploader_type、live_or_on_demand、subscribed_status、country_code |
指標: | 和 10 月 10 大獎 |
使用者活動 (依省分組)
本報告提供美國各州及哥倫比亞特區的使用者活動統計資料。也就是說,如果 country_code 維度的值是 US
,報表會經過篩選,只納入資料。這份報表的id
是 content_owner_asset_province_a2
。
這份報表的id
是 content_owner_asset_province_a2
。這個版本與 a1
版之間有以下差異:
- 新增 red_views 指標
- 新增 red_watch_time_minutes 指標
影片播放位置
此報表提供與播放影片或網頁或應用程式類型相關的統計資料。這份報表的id
是 content_owner_asset_playback_location_a2
。
這份報表的id
是 content_owner_asset_playback_location_a2
。這個版本與 a1
版之間有以下差異:
- 新增 red_views 指標
- 新增 red_watch_time_minutes 指標
流量來源
這份報表會依據觀眾與影片內容連結影片內容的收視方式,彙整觀看統計資料。例如,Google 搜尋可產生的觀看次數,包括來自 Google 搜尋或相關影片連結的觀看次數。這份報表的id
是 content_owner_asset_traffic_source_a2
。
這份報表的id
是 content_owner_asset_traffic_source_a2
。這個版本與 a1
版之間有以下差異:
- 新增 red_views 指標
- 新增 red_watch_time_minutes 指標
裝置類型和作業系統
這份報表會依據觀眾作業系統和裝置類型彙整影片觀看次數統計資料。舉例來說,該報表可識別 Android 平板電腦或 Windows 電腦裝置的觀看次數。這份報表的id
是 content_owner_asset_device_os_a2
。
這份報表的id
是 content_owner_asset_device_os_a2
。這個版本與 a1
版之間有以下差異:
- 新增 red_views 指標
- 新增 red_watch_time_minutes 指標
觀眾客層
這份報表會依據觀眾年齡層和性別匯總觀看統計資料。這份報表的id
是 content_owner_asset_demographics_a1
。
目錄 | |
---|---|
尺寸: | date、channel_id、video_id、asset_id、claimed_status、uploader_type、live_or_on_demand、subscribed_status、country_code、age_group |
指標: | 觀看次數百分比 |
內容共享 (依平台分組)
這份報表提供的統計資料,說明連結內容擁有者資產的影片在不同社交媒體平台上分享的頻率。這份報表的id
是 content_owner_asset_sharing_service_a1
。
目錄 | |
---|---|
尺寸: | date、channel_id、video_id、asset_id、claimed_status、uploader_type、live_or_on_demand、subscribed_status、country_code 和 sharing_service |
指標: | 分享次數 |
註解
這份報表會針對與內容擁有者資產連結的影片顯示期間,顯示哪些註解相關統計資料。報告資料可評估個別註解的效能。相較之下,使用者活動報表則會匯總所有影片註解的統計資料。這份報表的id
是 content_owner_asset_annotations_a1
。
卡片
這份報告會針對與資訊卡資產連結的影片顯示資訊卡,提供曝光次數和點閱次數統計資料。報表資料會評估個別資訊卡的成效。相較之下,使用者活動報表則會針對連結資產的所有影片顯示的各項資訊卡統計資料。這份報表的id
是 content_owner_asset_cards_a1
。
片尾
此報表針對影片停止播放後顯示的片尾,提供曝光次數和點閱後統計資料。這份報表含有內容擁有者頻道中已聲明版權影片的統計資料,以及與影片相關的資產。這份報表的id
是 content_owner_asset_end_screens_a1
。
合併
這份報表結合了「播放位置」、「流量來源」和「裝置/作業系統」報表中使用的維度,提供精細的影片統計資料。這份報表的id
是 content_owner_asset_combined_a2
。
這份報表的id
是 content_owner_asset_combined_a2
。這個版本與 a1
版之間有以下差異:
- 新增 red_views 指標
- 新增 red_watch_time_minutes 指標