YouTube クリエイター インサイト

クリエイター分析情報機能を使用して、YouTube クリエイターに関する分析情報を検出して取得します。この機能は、ターゲット ユーザーに関連性の高いクリエイターを見つけたい代理店や広告主にとって便利です。

この API には主に 4 つの機能があります。

  1. クリエイターの検出可能性: 指定したトピック、ユーザー属性、オーディエンス、クリエイター属性の上位クリエイターを見つけます。
  2. クリエイター ブランド分析情報: 特定のブランドに関連するクリエイターに関する分析情報を取得します。
  3. クリエイター分析情報: チャンネル登録者数、視聴回数、視聴者のユーザー属性など、特定の YouTube チャンネルに関する分析情報を取得します。
  4. トレンドの分析情報: 特定のオーディエンスやトピックに基づいて、特定のトレンドに関する分析情報を取得します。

利用資格要件

ContentCreatorInsightsService.GenerateCreatorInsights は、非独占的でロイヤリティ フリーのデータ ライセンスで提供される Google Ads API の非公開コンポーネントです。契約済みのパートナーは、標準の Google 広告クライアント ライブラリを使用して、YouTube クリエイターとコンテンツを検索できます。対象となるには、パートナーは以下の条件を満たしている必要があります。

  • API を統合するプランニング ツールまたはユーザー インターフェースがある。
  • API を使用して、YouTube のコンテンツやクリエイターを調べ、広告掲載の機会を探します。
  • 事前スクリーニングの評価を完了して、利用資格を確認します。
  • データ使用要件を遵守し、定期的なデータ監査を受けることに同意している。
  • データ使用要件を法的に強制するデータ ライセンス契約に署名します。
  • Google Ads API の利用規約に同意します。

詳しくは、Google 担当者にお問い合わせください。

クリエイターの分析情報を生成する

クリエイターの分析情報を生成するには、ContentCreatorInsightsService.GenerateCreatorInsights メソッドにリクエストを送信します。このメソッドには 1 秒あたり 5 件のクエリ数（QPS）の制限があり、クリエイターの検出可能性、クリエイターのブランド分析、クリエイターの分析情報の取得のいずれを行うかによって、3 種類の入力を使用します。データを取得する国の所在地を指定する必要があります。

  1. クリエイターの検出可能性: 年齢、性別、興味 / 関心などのオーディエンス属性のリストを提供できます。API は、オーディエンスがこれらの属性と一致するクリエイターのリストを返します。クリエイター属性を指定して、入力したクリエイター属性とコンテンツが一致するクリエイターをフィルタすることもできます。
  2. クリエイター ブランド分析情報: ブランドを指定して、人気クリエイターを検索します。API は、一致するチャネルに関する分析情報を返します。
  3. クリエイター分析情報: YouTube チャンネル ID のリストを提供します。API は、これらの特定のチャネルに関する分析情報を返します。

generateCreatorInsights メソッドは GenerateCreatorInsightsResponse オブジェクトを返します。このオブジェクトには、YouTubeCreatorInsights オブジェクトのリストが含まれています。各 YouTubeCreatorInsights オブジェクトには、クリエイターに関する次の情報が含まれています。

  • クリエイターの名前
  • YouTube チャンネル
  • クリエイターの合計指標
  • YouTube チャンネルの分析情報のリスト

YouTubeMetrics オブジェクトには次の指標が含まれています。

  • チャンネル登録者数
  • 視聴回数
  • 動画数
  • Is Active Shorts Creator

YouTubeChannelInsights オブジェクトには、YouTube チャンネルに関する次の情報が含まれます。

  • チャンネル名
  • チャンネル ID
  • チャンネル URL
  • チャンネルの説明
  • チャンネルの指標
  • チャンネルの視聴者の属性（年齢、性別、ユーザーの興味 / 関心の内訳など）
  • 人気の動画
  • チャネルのタイプ

トレンドの分析情報を生成するには、ContentCreatorInsightsService.GenerateTrendingInsights メソッドにリクエストを送信します。このメソッドには 1 秒あたりのクエリ数（QPS）が 5 件という制限があり、オーディエンスのトレンドを取得するか、トピックのトレンドを取得するかによって 2 種類の入力を使用します。トレンドを取得する国を指定する必要があります。

  1. オーディエンスの傾向: 年齢、性別、興味 / 関心などのオーディエンス属性のリストを指定できます。API は、これらのオーディエンスのトレンドの分析情報のリストを返します。
  2. トピックのトレンド: コンテンツ トピックのリストを提供します。API は、これらのトピックのトレンドの分析情報のリストを返します。
前へ
オーディエンス分析