透過創作者洞察功能,發掘並擷取 YouTube 創作者的洞察資料。這項功能對希望尋找與目標對象相關創作者的代理商和廣告主來說相當實用。
這個 API 有四個主要功能:
- 創作者的曝光度:針對特定主題、客層、目標對象或創作者屬性,找出熱門創作者。
- 創作者品牌洞察資料:擷取與特定品牌相關的創作者洞察資料。
- 創作者洞察:擷取特定 YouTube 頻道的洞察資料,例如訂閱人數、觀看次數和觀眾客層。
- 趨勢洞察:根據特定目標對象或主題,擷取特定趨勢的洞察資料。
資格規定
ContentCreatorInsightsService.GenerateCreatorInsights
是 Google Ads API 的私人元件,提供非專屬、免版稅的資料授權。簽約合作夥伴可以使用標準 Google Ads 用戶端程式庫,探索 YouTube 創作者和內容。合作夥伴必須符合下列條件,才能符合資格:
- 擁有可整合 API 的規劃工具或使用者介面。
- 使用 API 探索 YouTube 內容和創作者,尋找潛在的廣告商機。
- 完成初步篩選評估,確認是否符合資格。
- 遵守資料使用規定,並願意定期接受資料稽核。
- 簽署資料授權協議,以便依法強制執行資料使用規定。
- 接受 Google Ads API 服務條款。
詳情請洽詢您的 Google 代表。
產生創作者洞察
如要產生創作者洞察資料,請向 ContentCreatorInsightsService.GenerateCreatorInsights
方法傳送要求。這個方法的限制為每秒 5 次查詢 (QPS),並採用三種輸入類型,取決於你想進行創作者可探索度、創作者品牌洞察或取得創作者洞察。您必須提供要擷取資料的國家/地區。
- 創作者的曝光度:您可以提供目標對象屬性清單,例如年齡、性別和興趣。API 會傳回創作者清單,其中的創作者目標對象符合這些屬性。您也可以提供創作者屬性,篩選出內容與您輸入的創作者屬性完全相符的創作者。
- 創作者品牌洞察:提供品牌名稱,即可搜尋頂尖創作者。API 會傳回符合條件的頻道洞察資料。
- 創作者洞察:提供 YouTube 頻道 ID 清單。API 會傳回這些特定管道的洞察資料。
generateCreatorInsights
方法會傳回 GenerateCreatorInsightsResponse
物件。這個物件包含 YouTubeCreatorInsights
物件的清單。每個 YouTubeCreatorInsights
物件都包含創作者的下列資訊:
- 創作者名稱
- YouTube 頻道
- 創作者指標總數
- YouTube 頻道深入分析清單
YouTubeMetrics
物件包含下列指標:
- 訂閱人數
- 觀看次數
- 影片數量
- 是活躍的 Shorts 創作者
YouTubeChannelInsights
物件包含 YouTube 頻道的下列資訊:
- 頻道名稱
- 頻道 ID
- 頻道網址
- 頻道說明
- 管道指標
- 頻道觀眾屬性 (例如年齡、性別和使用者興趣細目)
- 熱門影片
- 管道類型
產生趨勢洞察資料
如要產生趨勢深入分析資料,請向 ContentCreatorInsightsService.GenerateTrendingInsights
方法傳送要求。這個方法的限制為每秒 5 次查詢 (QPS),並根據您要取得的目標對象趨勢或主題趨勢,採用兩種輸入類型。您必須提供要取得趨勢資料的特定國家/地區。
- 目標對象趨勢:您可以提供目標對象屬性清單,例如年齡、性別和興趣。API 會傳回這些目標對象的趨勢洞察清單。
- 主題趨勢:提供內容主題清單。API 會傳回這些主題的趨勢洞察資料清單。