本頁列出內容擁有者可透過 YouTube Reporting API 擷取的報表。每份報表的 id
(由 API 的 reportTypes.list
方法傳回) 會顯示在報表名稱旁的括號內。
影片報表
影片報表會提供與頻道影片或內容擁有者影片相關的所有使用者活動統計資料。舉例來說,這些報表會顯示影片的觀看次數。
使用者活動
這份報表提供了與內容擁有者頻道和這些頻道影片相關的使用者活動統計資料。這份報表目前版本的 id
為 content_owner_basic_a3
。
這份報表的 id
為 content_owner_basic_a3
。與 a2
版本相比,它有以下差異:
- 新增 red_views 指標
- 新增 red_watch_time_minutes 指標
注意: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 搜尋或相關影片連結產生的觀看次數。這份報表的 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 |
指標: | 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 |
指標: | shares |
註解
這份報表提供內容擁有者頻道影片中顯示的註解統計資料。
報表資料會評估每部影片的個別註解成效。相較之下,使用者活動報表會匯總所有影片註解的統計資料。
這份報表的 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 搜尋或相關影片連結產生的觀看次數。這份報表的 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_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_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 使用者上傳。
在資產報表中,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 指標
使用者活動 (依省分組)
這份報表提供美國各州和哥倫比亞特區的使用者活動統計資料。這意味著報表會過濾,只納入 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 搜尋或相關影片連結產生的觀看次數。這份報表的 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、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 |
指標: | shares |
註解
這份報表會提供與內容擁有者資產相關聯的影片中顯示的註解統計資料。報表資料會評估個別註解的成效。相較之下,使用者活動報表會匯總所有影片註解的統計資料。這份報表的 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 指標