YouTube 創作者深入分析

使用創作者洞察功能，發掘並取得 YouTube 創作者的洞察資料。如果代理商和廣告主想尋找與目標對象相關的創作者，這項功能就非常實用。

這項 API 主要有四項功能：

  1. 創作者曝光度：根據特定主題、客層、目標對象或創作者屬性，找出頂尖創作者。
  2. 創作者品牌洞察：取得與特定品牌相關的創作者洞察資料。
  3. 創作者洞察：取得特定 YouTube 頻道的洞察資料，例如訂閱人數、觀看次數和觀眾客層。
  4. 熱門洞察：根據特定目標對象或主題，取得特定趨勢的洞察資料。

資格規定

ContentCreatorInsightsService.GenerateCreatorInsights 是 Google Ads API 的私有元件，提供非專屬免權利金的資料授權。簽約合作夥伴可以使用標準的 Google Ads 用戶端程式庫，探索 YouTube 創作者和內容。如要符合資格，合作夥伴必須符合下列條件：

  • 擁有可整合 Google Ads API 的規劃工具或使用者介面。
  • 使用 API 探索 YouTube 內容和創作者，尋找潛在的廣告商機。
  • 完成預先篩選評估，以確保符合資格。
  • 遵守資料使用規定，並願意接受定期資料稽核。
  • 簽署資料授權協議，確保資料使用符合法律規定。
  • 接受 Google Ads API 服務條款。

詳情請洽詢您的 Google 代表。

生成創作者洞察資料

如要產生創作者洞察資料，請向 ContentCreatorInsightsService.GenerateCreatorInsights 方法發出要求。這個方法每秒查詢次數上限為 5 次 (QPS)，並根據您想進行創作者曝光度、創作者品牌深入分析或取得創作者深入分析資料，採用三種輸入內容類型。你必須提供要從中取得資料的國家/地區位置。

  1. 創作者曝光度：您可以提供目標對象屬性清單，例如年齡、性別和使用者興趣 (包括興趣相似目標對象、潛在目標消費者和人生大事目標對象)。API 會傳回目標對象符合這些屬性的創作者清單。您也可以提供創作者屬性，篩選出內容符合輸入創作者屬性的創作者。

    您可以透過 AudienceInsightsService.ListAudienceInsightsAttributes 擷取可用的目標對象屬性，方法是提供您要取得屬性的維度，例如興趣主題的 KNOWLEDGE_GRAPH。

    自 Google Ads API 第 23 版起，您可以使用 audience_combinations 指定複雜的目標對象屬性關係。這個欄位可讓您使用布林邏輯 (AND/OR) 定義目標對象，這是 audience_attributes 無法做到的。

    audience_attributes 適合根據聯集 (以 OR 組合) 屬性清單指定目標 (例如對「運動」或「旅遊」或...感興趣的使用者)，audience_combinations 則提供更精細的控制選項。audience_combinations 中的每個 InsightsAudienceAttributeGroup 都會以邏輯 OR 組合屬性。這些群組隨後會以邏輯 AND 組合。

    舉例來說，如要指定對「護膚」或「護髮」感興趣，且也對「化妝品」感興趣的目標對象，您會在 audience_combinations 中使用兩個 InsightsAudienceAttributeGroup 項目。「護膚」、「護髮」和「化妝品」是興趣主題，以知識圖譜實體表示 (例如化妝品的 /m/014trl)。第一個群組會包含「護膚」和「護髮」的知識圖譜實體屬性，第二個群組則會包含「化妝品」的知識圖譜實體屬性。

    請注意，如果在 audience_attributes 中指定知識圖譜實體、產品和服務類別或使用者興趣，就無法使用 audience_combinations。如果您使用 audience_combinations，就必須在 audience_combinations 中指定這些屬性，而不是在 audience_attributes 中指定；不過，您還是可以將 audience_attributes 用於其他屬性類型，例如與 audience_combinations 搭配使用的人口統計資料。

  2. 創作者品牌洞察：提供品牌名稱，搜尋頂尖創作者。API 會傳回相符頻道的洞察資料。

  3. 創作者洞察：提供 YouTube 頻道 ID 清單。API 會傳回這些特定通路的洞察資料。

generateCreatorInsights 方法會傳回 GenerateCreatorInsightsResponse 物件。這個物件包含 YouTubeCreatorInsights 物件清單。每個 YouTubeCreatorInsights 物件都包含下列有關創作者的資訊：

  • 創作者名稱
  • YouTube 頻道
  • 創作者指標總數
  • YouTube 頻道洞察資料清單

YouTubeMetrics 物件包含下列指標：

  • 訂閱人數
  • 觀看次數
  • 影片數量
  • 是活躍的 Shorts 創作者
  • 合作夥伴商機 (自 23 版起)

YouTubeChannelInsights 物件包含 YouTube 頻道的下列資訊：

  • 頻道名稱
  • 頻道 ID
  • 頻道網址
  • 頻道說明
  • 管道指標

  • 頻道觀眾屬性 (例如年齡、性別和使用者興趣)

    細目)

  • 熱門影片

  • 管道類型

  • 與頻道內容相關聯的語言

  • 關聯分數 (僅限主題趨勢搜尋)

如要生成熱門洞察，請向 ContentCreatorInsightsService.GenerateTrendingInsights 方法發出要求。這個方法的每秒查詢次數 (QPS) 上限為 5 次，並會根據您想取得目標對象趨勢或主題趨勢，採用兩種輸入類型。您必須提供要取得趨勢的特定國家/地區。

  1. 目標對象趨勢：您可以提供目標對象屬性清單，例如年齡、性別和使用者興趣 (包括興趣相似目標對象、潛在目標消費者和人生大事目標對象)。API 會傳回這些目標對象的熱門洞察資料清單，包括趨勢值的百分比變化等指標 (與比較期間相比)。

    您可以透過 AudienceInsightsService.ListAudienceInsightsAttributes 擷取可用的目標對象屬性，方法是提供您要取得屬性的維度，例如興趣主題的 KNOWLEDGE_GRAPH。

    自 Google Ads API 第 23 版起，您可以使用 audience_combinations 指定複雜的目標對象屬性關係。這個欄位可讓您使用布林邏輯 (AND/OR) 定義目標對象，這是 audience_attributes 無法做到的。

    audience_attributes 適合根據聯集 (以 OR 組合) 屬性清單指定目標 (例如對「運動」或「旅遊」或...感興趣的使用者)，audience_combinations 則提供更精細的控制選項。audience_combinations 中的每個 InsightsAudienceAttributeGroup 都會以邏輯 OR 組合屬性。這些群組隨後會以邏輯 AND 組合。

    舉例來說，如要指定對「護膚」或「護髮」感興趣，且也對「化妝品」感興趣的目標對象，您會在 audience_combinations 中使用兩個 InsightsAudienceAttributeGroup 項目。「護膚」、「護髮」和「化妝品」是興趣主題，以知識圖譜實體表示 (例如化妝品的 /m/014trl)。第一個群組會包含「護膚」和「護髮」的知識圖譜實體屬性，第二個群組則會包含「化妝品」的知識圖譜實體屬性。

    請注意，如果在 audience_attributes 中指定知識圖譜實體、產品和服務類別或使用者興趣，就無法使用 audience_combinations。如果您使用 audience_combinations，就必須在 audience_combinations 中指定這些屬性，而不是在 audience_attributes 中指定；不過，您還是可以將 audience_attributes 用於其他屬性類型，例如與 audience_combinations 搭配使用的人口統計資料。

  2. 主題趨勢：提供內容主題清單。API 會傳回這些主題的熱門洞察資料清單，包括趨勢值在比較期間的百分比變化等指標。

上一頁
目標對象深入分析