本頁列出內容擁有者可透過 YouTube Reporting API 擷取的報表。API 的 reportTypes.list
方法傳回的每個報表 id
,都會顯示在報表名稱旁的括號中。
影片報表
影片報表會提供與頻道影片或內容擁有者影片相關的所有使用者活動統計資料。舉例來說,這些報表會顯示影片的觀看次數。
使用者活動
這份報表提供與內容擁有者頻道和這些頻道影片相關的使用者活動統計資料。
這份報表的 id
為 content_owner_basic_a4
。
使用者活動 (依省分組)
這份報表提供美國各州和哥倫比亞特區的使用者活動統計資料。
這份報表的 id
為
content_owner_province_a3
。
播放位置
這份報表提供影片播放次數的統計資料,並依據播放影片的頁面或應用程式類型分類。
這份報表的 id
為
content_owner_playback_location_a3
。
流量來源
這份報表會根據觀眾在內容擁有者頻道上觀看影片的方式,匯總觀看統計資料。 舉例來說,這項指標會指出 Google 搜尋或相關影片連結帶來的觀看次數。
這份報表的 id
為
content_owner_traffic_source_a3
。
裝置類型和作業系統
這份報表會根據觀眾的作業系統和裝置類型,匯總影片觀看統計資料。舉例來說,這項指標會指出在 Android 平板電腦或 Windows 桌機上發生的觀看次數。
這份報表的 id
為
content_owner_device_os_a3
。
觀眾客層
這份報表會根據觀眾的年齡層和性別匯總觀看統計資料。
這份報表的 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 |
指標: | views_percentage |
內容共享 (依平台分組)
這份報表會提供統計資料,顯示內容擁有者頻道上的影片在不同社群平台上的分享頻率。
這份報表的 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_a3
。
合併
這份報表會結合「播放位置」、「流量來源」和「裝置/作業系統」報表所用的維度,提供精細的影片統計資料。
這份報表的 id
為 content_owner_combined_a3
。
播放清單報表
播放清單報表會提供與播放清單中影片觀看次數相關的統計資料。
使用者活動
這份報表提供與使用者在內容擁有者頻道上與播放清單互動相關的統計資料。
這份報表的 id
為 content_owner_playlist_basic_a2
。
使用者活動 (依省分組)
這份報表提供美國各州和哥倫比亞特區使用者與內容擁有者頻道播放清單互動的使用者活動統計資料。報表會經過篩選,只納入 country_code 維度的值為 US
的資料。
這份報表的 id
為 content_owner_playlist_province_a2
。
播放位置
這份報表會提供播放清單播放次數的統計資料,並依發生播放次數的頁面或應用程式類型分類。
這份報表的 id
為
content_owner_playlist_playback_location_a2
。
流量來源
這份報表會根據觀眾在內容擁有者頻道上觀看播放清單影片的方式,匯總觀看統計資料。舉例來說,這份報表會指出 Google 搜尋或相關影片連結帶來的觀看次數。
這份報表的 id
為 content_owner_playlist_traffic_source_a2
。
裝置類型和作業系統
這份報表會根據觀眾的作業系統和裝置類型,匯總播放清單觀看統計資料。舉例來說,這項指標會指出在 Android 平板電腦或 Windows 桌機上發生的觀看次數。
這份報表的 id
為
content_owner_playlist_device_os_a2
。
合併
這份報表會結合「播放位置」、「流量來源」和「裝置/作業系統」報表使用的維度,提供精細的播放清單統計資料。
這份報表的 id
為 content_owner_playlist_combined_a2
。
廣告費率報表
廣告費率報表會提供影片播放期間放送廣告的曝光次數指標。這些指標會計算每次廣告曝光,而每次播放影片可能會產生多次曝光。
這個 API 支援下列廣告費率報表,提供內容擁有者影片的廣告費率指標。
這份報表的 id
為 content_owner_ad_rates_a1
。
這份報表的舊版 ID 為 content_owner_ad_performance_a1
,現已全面淘汰。
這個版本與上一個版本的唯一差異在於,這個版本將報表名稱中的「performance
」改為「rates
」。因此,報表本身的版本編號 (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_a2
。
估算的資產收益
這份報表會列出內容擁有者所有資產透過 Google 銷售的廣告來源和非廣告來源賺取的總收益。當中也包含部分廣告成效指標。請注意,channel_id 維度會識別上傳 video_id 的頻道,並提供相關指標。
這份報表的 id
為 content_owner_asset_estimated_revenue_a2
。
- 新增 estimated_partner_red_revenue 指標
- 新增 estimated_partner_transaction_revenue 指標
- 將「預估合作夥伴 AdSense 收益」estimated_partner_ad_sense_revenue指標重新命名為「預估合作夥伴廣告競價收益」estimated_partner_ad_auction_revenue
- 將「estimated_partner_double_click_revenue」estimated_partner_double_click_revenue指標重新命名為「estimated_partner_ad_reserved_revenue」estimated_partner_ad_reserved_revenue
- 更新報表名稱,改用「
revenue
」一詞,而非「earnings
」。因此,報表本身的版本編號 (a1
) 與先前版本相同,但report ID
不同。
資產報表
資產報表會提供與連結至內容擁有者資產的影片相關的使用者活動指標。如果內容擁有者聲明影片與其資產相符,該影片就會納入內容擁有者的報表。影片可能是由內容擁有者或其他 YouTube 使用者上傳。
在資產報表中,channel_id 維度會識別上傳 video_id 的頻道,並提供相關指標。
舉例來說,假設某部影片在特定一天內獲得 10 次觀看,隨後遭到著作權聲明,之後又獲得 10 次觀看。即使只有 10 次觀看是在聲明著作權後發生,當天的資產報表仍會顯示影片觀看次數為 20 次。所有後續日期的指標都應準確反映與已聲明著作權影片相關的使用者活動。
使用者活動
這份報表提供與使用者對連結至內容擁有者資產的影片所採取的動作相關的統計資料。
這份報表這個版本的 id
為 content_owner_asset_basic_a3
。
使用者活動 (依省分組)
這份報表提供美國各州和哥倫比亞特區的使用者活動統計資料。這表示報表會經過篩選,只納入 country_code 維度的值為 US
的資料。這份報表的 id
為 content_owner_asset_province_a3
。
這份報表這個版本的 id
為 content_owner_asset_province_a3
。
影片播放位置
這份報表提供影片播放次數的統計資料,並依據播放影片的頁面或應用程式類型分類。
這份報表這個版本的 id
為 content_owner_asset_playback_location_a3
。
流量來源
這份報表會根據觀眾觀看與內容擁有者資產連結的影片內容時,所採用的方式彙整觀看統計資料。舉例來說,這項指標會指出 Google 搜尋或相關影片連結帶來的觀看次數。
這份報表這個版本的 id
為 content_owner_asset_traffic_source_a3
。
裝置類型和作業系統
這份報表會根據觀眾的作業系統和裝置類型,匯總影片觀看統計資料。舉例來說,這項指標會指出在 Android 平板電腦或 Windows 桌機上發生的觀看次數。
這份報表這個版本的 id
為 content_owner_asset_device_os_a3
。
觀眾客層
這份報表會根據觀眾的年齡層和性別匯總觀看統計資料。這份報表的 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、gender |
指標: | views_percentage |
內容共享 (依平台分組)
這份報表會顯示與內容擁有者資產連結的影片,在不同社群平台上的分享頻率統計資料。這份報表的 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_a3
。