クリエイター分析機能を使用して、YouTube クリエイターに関する分析情報を取得します。これは、ターゲット オーディエンスに関連するクリエイターを探している代理店や広告主に役立ちます。
この API の主な機能は次の 4 つです。
- クリエイターの見つけやすさ: 特定のトピック、ユーザー属性、オーディエンス、クリエイター属性の上位クリエイターを見つけます。
- クリエイターのブランド分析情報: 特定のブランドに関連するクリエイターに関する分析情報を取得します。
- クリエイター インサイト: 特定の YouTube チャンネルに関するインサイト(チャンネル登録者数、視聴回数、視聴者の属性など)を取得します。
- 急上昇インサイト: 特定のオーディエンスやトピックに基づいて、特定のトレンドに関する分析情報を取得します。
利用資格要件
ContentCreatorInsightsService.GenerateCreatorInsights
は、非独占的なロイヤリティフリーのデータライセンスとともに提供される Google Ads API の非公開コンポーネントです。契約を締結したパートナーは、標準の Google 広告クライアント ライブラリを使用して、YouTube のクリエイターとコンテンツを探索できます。対象となるには、パートナーは以下の条件を満たしている必要があります。
- API を統合する計画ツールまたはユーザー インターフェースが必要です。
- API を使用して、YouTube のコンテンツとクリエイターを調査し、潜在的な広告の機会を探します。
- 資格要件を満たしていることを確認するための事前審査を完了します。
- データ使用要件に準拠し、定期的なデータ監査を受け入れる。
- データ使用要件を法的に適用するデータ ライセンス契約に署名します。
- Google Ads API の利用規約に同意します。
詳しくは、Google 担当者にお問い合わせください。
クリエイターの分析情報を生成する
クリエイターの分析情報を生成するには、ContentCreatorInsightsService.GenerateCreatorInsights
メソッドにリクエストを送信します。このメソッドの 1 秒あたりのクエリ数(QPS)の上限は 5 です。クリエイターの見つけやすさ、クリエイターのブランド インサイト、クリエイターのインサイトの取得のいずれを行うかによって、3 種類の入力が可能です。データを取得する国を指定する必要があります。
- クリエイターの見つけやすさ: 年齢、性別、興味 / 関心など、オーディエンスの属性のリストを指定できます。API は、属性に一致する視聴者を持つクリエイターのリストを返します。クリエイター属性を指定して、入力したクリエイター属性とコンテンツが一致するクリエイターをフィルタすることもできます。
- クリエイター ブランド分析: 人気クリエイターを検索するブランドを指定します。API は、一致するチャンネルに関する分析情報を返します。
- クリエイター インサイト: YouTube チャンネル ID のリストを指定します。API は、特定のチャンネルに関する分析情報を返します。
generateCreatorInsights
メソッドは GenerateCreatorInsightsResponse
オブジェクトを返します。このオブジェクトには、YouTubeCreatorInsights
オブジェクトのリストが含まれています。各 YouTubeCreatorInsights
オブジェクトには、クリエイターに関する次の情報が含まれます。
- クリエイターの名前
- YouTube チャンネル
- クリエイターの合計指標
- YouTube チャンネル インサイトのリスト
YouTubeMetrics
オブジェクトには次の指標が含まれています。
- チャンネル登録者数
- 視聴回数
- 動画数
- アクティブな YouTube ショート クリエイターである
YouTubeChannelInsights
オブジェクトには、YouTube チャンネルに関する次の情報が含まれます。
- チャンネル名
- チャンネル ID
- チャンネル URL
- チャンネルの説明
- チャンネルの指標
- チャンネル オーディエンスの属性(年齢、性別、ユーザーの興味 / 関心の内訳など)
- 人気の動画
- チャネルのタイプ
トレンドに関する分析情報を生成する
急上昇の分析情報を生成するには、ContentCreatorInsightsService.GenerateTrendingInsights
メソッドにリクエストを送信します。このメソッドの 1 秒あたりのクエリ数(QPS)の上限は 5 件で、オーディエンスのトレンドとトピックのトレンドのどちらを取得するかに応じて、2 種類の入力を受け取ります。トレンドを取得する国を指定する必要があります。
- オーディエンスの傾向: 年齢、性別、興味 / 関心など、オーディエンスの属性のリストを指定できます。API は、これらのオーディエンスの急上昇インサイトのリストを返します。
- トピックのトレンド: コンテンツ トピックのリストを指定します。API は、これらのトピックに関する急上昇インサイトのリストを返します。