Introduction

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

本文件將說明 YouTube Analytics API 和 YouTube Reporting API 存取 YouTube 數據分析資料的方式,存在差異和差異。這份文件旨在協助您為應用程式選擇合適的 API。

開發人員可以透過這兩種 API 擷取 YouTube 數據分析資料。此外,這兩個 API 都支援 YouTube 頻道擁有者和 YouTube 內容擁有者,每種 API 都可以存取一組特定的報表:

  • 管道報表包含指定管道的使用者活動指標。

  • 「內容擁有者」報表會針對所有與指定 YouTube 內容擁有者相連結的頻道匯總指標。例如,唱片公司可能會擷取一份報表,內含唱片公司所有演出者 YouTube 頻道的合併統計資料。部分內容擁有者報表包含使用者活動指標,有些則包含收益和廣告成效相關指標。

一些內容擁有者也能透過 Reporting API 存取系統管理的廣告收益報表。系統管理報表中的資料只能透過 Reporting API 擷取。

所有 YouTube Analytics (分析) 和 YouTube Reporting API 要求都必須獲得擁有必要資料的頻道或內容擁有者授權。

檢舉內容

API 擷取的報表包含兩種類型的資料:

  • 維度是一種常見的資料匯總條件,例如使用者活動發生的日期,或是使用者所在的國家/地區。

    在報表中,每一列都有不重複的維度值組合。因此,每一列的維度值組合會成為該列的主鍵。

  • 指標則是評估使用者活動、廣告成效或預估收益的個別指標。使用者活動指標包括影片觀看次數和評分 (喜歡與不喜歡的人數) 等。

為您的應用程式選擇合適的 API

YouTube Analytics API
YouTube Analytics API 支援即時指定查詢,用於產生自訂 YouTube 數據分析報表。API 提供篩選和排序參數,因此呼叫應用程式不需要原生支援這些函式。

每個 API 要求都會指定資料傳回的日期範圍。這個 API 也能讓您擷取每週和每月的資料集。因此,呼叫應用程式不需要儲存擷取的資料集或不同日期範圍內的匯總統計資料。
YouTube Reporting API
YouTube Reporting API 擷取大量報表,內含頻道或內容擁有者的 YouTube 數據分析資料。適用於可匯入大型資料集的應用程式,以及提供篩選、排序及挖掘資料的工具。

每份報表都包含一組預先定義的欄位。開發人員利用這個 API 安排報表工作時間,每個工作都可用來找出 YouTube 應該產生的報表。接著,YouTube 會產生可非同步下載的每日報表。每份報表都包含特定 24 小時期間的資料。

此外,YouTube 會自動為擁有在 YouTube 創作者工作室中存取相應報表的內容擁有者管理一組系統報表。這些報表可透過程式存取廣告收益資料。

受支援的報表

下表說明可透過 API 擷取的不同報表類型。您可以透過 YouTube Analytics API 存取指定的查詢,也可透過 YouTube Reporting API 取得大量報表。

您可能無法利用其中一個 API 取得資料。舉例來說,YouTube Analytics API 可讓您每週或每月擷取使用者活動指標,但 YouTube Reporting API 會要求您自行匯總資料。另一方面,YouTube Reporting API 也支援內容擁有者的資產報表,但 YouTube Analytics API 並不會提供這些資料。

報表類型
影片報表 支援頻道 (查詢大量) 和內容擁有者 (查詢大量)。

「影片」報告會針對頻道或內容擁有者的影片,提供所有使用者相關活動的統計資料。舉例來說,這些報表包含您的影片獲得的觀看次數。在 YouTube Analytics API 中,部分內容擁有者的影片報表也會提供預估收益和廣告成效成效指標。
播放清單報表 支援頻道 (查詢大量) 和內容擁有者 (查詢大量)。

「播放清單」報表提供與播放清單相關的影片觀看次數相關的統計資料。YouTube Reporting API 支援播放清單的觀眾續看率報表,但 YouTube Analytics API 不支援類似的報表。
廣告成效報表 適用於內容擁有者 (查詢大量)

廣告成效報表會針對影片播放期間放送的廣告,提供曝光次數指標。這些指標會計入每次廣告曝光,且每次影片播放都會帶來多次曝光。
估算的收益報表 適用於內容擁有者 (大量)。

透過收益報表,您可以得知 Google 銷售的廣告來源和非廣告來源的影片帶來的總收益。這類報表也包含一些廣告成效成效指標。請注意,系統管理報表包含實際收益資料。
資產報表 適用於內容擁有者 (大量)。

資產報表可提供與內容擁有者資產連結影片相關的使用者活動指標。內容擁有者在 YouTube 的內容擁有者報表中,發現某部影片符合某項內容擁有者的某項資產。影片可能是由內容擁有者或其他 YouTube 使用者所上傳。
系統管理報表 在 YouTube 創作者工作室的「報表」專區中,有權存取相關報表的內容擁有者。

系統管理報表提供資產和影片實際收益資料。另一份報表會列出已聲明版權影片,以及與這些影片相符的資產。請注意,並非所有的創作者工作室報表都可在 API 使用。

注意:YouTube 會自動為擁有相應存取權的內容擁有者產生系統管理的報表,因此,擷取這些報表的程序與此名單中其他類型的報表不同。詳情請參閱系統管理報表的說明文件。

主要差異

下表列出了 YouTube 數據分析和 Reporting API 之間的重要差異。

功能 YouTube Analytics API YouTube Reporting API
擷取資料的處理程序 每個 API 要求都會指定要傳回的維度和指標,以及資料傳回的時間範圍。 應用程式會安排報表工作的時間。YouTube 會針對每項工作產生可非同步下載的每日報表。
日期範圍 部分 API 報表會指定使用者活動發生的日期。其中部分報表支援按月匯總使用者活動指標的維度。 所有 API 報表都會指定使用者活動發生的日期。使用 API 的應用程式可實作定期匯總資料的功能。
篩選資料 您可以篩選報表,只納入維度具有特定值的列。這個 API 也支援某些僅做為篩選器的維度,例如「洲別」和「子洲」。 這個 API 支援大量下載完整的資料集。但不支援篩選或篩選僅限篩選維度的資料。用戶端應用程式會儲存已下載的資料,並實作自己的功能來篩選資料。
排序 報表可以根據傳回的指標值排序。部分報表僅支援部分結果。舉例來說,報表列出頻道觀看次數最多的影片,最多會傳回 200 列。 這個 API 支援大量下載完整的資料集。用戶端應用程式可以實作自己的功能,對下載的資料進行排序。
列舉 API 報表含有文字值 (例如「ANDROID」或「CHANNEL」),用於識別列舉的維度值。 API 報表含有可對應至文字值的整數。
配額 API 伺服器會評估每項查詢,以判斷配額費用。配額用量文件詳細說明瞭此方法。 配額用量不是問題,因為系統只擷取一次資料,然後在應用程式中加以篩選、排序及查詢。
不重複報表
  • 與字幕相關的使用者活動
  • 播放清單的觀眾續看率資料
  • 內容擁有者的收益報表 (有 2 份不同的報表)
  • 適用於內容擁有者的資產報表 (有 11 種不同的報告)
不重複的維度 group (僅限篩選器維度)
洲別 (僅限篩選器的維度)
SubContinent (僅限篩選器維度)
is
isCurated==1 (僅限篩選器維度)
viewsPerPlaylistStart
averageTimeInPlaylist
annotation_id
annotation_type
asset_id
card_id
card_type
live_or_on_demand
subscribed_status
subtitle_language
不重複指標 不重複
relativetainPerformance
viewsPerPlaylistStart
averageTimeInPlaylist
card_click_rate
card_clicks
card_impressions
card_前請思考點擊次數

API 命名差異

這兩個 API 目前使用不同的命名慣例來識別維度和指標。目前 YouTube 數據分析的 API 名稱採用 camelCase,YouTube Reporting API 名稱則會使用以底線分隔的名稱。

下表說明這兩個 API 用來辨識相同指標和維度的不同名稱。在某些情況下,這兩個名稱之間的差距大於將名稱從駝峰式大小寫轉換為底線後產生的結果。例如,YouTube 數據分析 API 中的 video 維度在 YouTube Reporting API 中會命名為 video_id

尺寸

YouTube Analytics API 名稱 YouTube Reporting API 名稱
廣告類型 ad_type [廣告類型]
年齡層 年齡層
資產 asset_id [資產 ID]
audienceType audience_retention_type [目標對象類型]
頻道 channel_id
claimedStatus claimed_status
內容擁有者 content_owner_id [內容擁有者 ID]
country 國家/地區代碼
日期
裝置類型 裝置類型
eeddVideoTimeRatio 耗時_影片_時間百分比
性別 性別
insightplayLocationDetails playback_location_detail [播放地點詳細資料]
insightplayLocationType playback_location_type
insightTrafficSourceDetail traffic_source_detail [流量來源詳細資料]
insight TrafficSourceType traffic_source_type [流量來源類型]
liveOrOnDemand live_or_on_demand
作業系統 operating_system
播放清單 playlist_id [播放清單 ID]
province vintcode [省代碼]
共享服務 資料分割服務
subscriptiondStatus subscribed_status
subtitleLanguage subtitle_language
uploaderType uploader_type
影片 video_id [影片 ID]

指標

YouTube Analytics API 名稱 YouTube Reporting API 名稱
廣告收益 estimated_partner_ad_revenue
annotationImpression annotation_impressions
annotationClickableImpression annotation_clickable_impressions
annotationClicks annotation_clicks
annotationClickThroughRate annotation_click_through_rate
annotationClosableImpression annotation_closable_impressions
annotationCloses annotation_closes
annotationCloseRate annotation_close_rate [註解關閉率]
audienceWatchRatio audience_retention_percentage
平均觀看時長 average_view_duration_seconds
平均觀看百分比 平均觀看時間百分比
資訊卡點擊率 資訊卡點擊率
資訊卡點擊次數 card_clicks
卡片曝光次數 card_impressions
cardTeaserClickRate card_前導廣告點擊率
cardTeaserClicks card_前導廣告點擊次數
cardTeaserImpression card_前導廣告曝光率
備註 備註
不喜歡 不喜歡
收益 estimated_partner_revenue
estimatedMinutesWatched watch_time_minutes
預估合作夥伴 AdSense 收益 estimated_partner_adsense_revenue
預估合作夥伴 DoubleClick 收益 estimated_partner_doubleclick_revenue
總收益 estimated_youtube_ad_revenue
曝光次數 (以分鐘為單位) 預估千次曝光出價
曝光 廣告曝光次數
喜歡次數 喜歡次數
營利播放 estimated_monetized_playback
PlaybackBasedCpm estimated_playback_Based_cpm
playlistStarts playlist_starts
savesAdded playlist_saves_added
savesRemoved playlist_saves_removed
分享次數 分享次數
訂閱人數 subscribers_gained
訂閱人數流失 subscribers_lost
videosAddedTo 播放清單 videos_added_to_playlists
videosRemovedFrom 播放清單 videos_removed_from_playlist
檢視者百分比 觀看次數百分比
觀看次數 觀看次數