クリエイターのインサイト機能を使用すると、YouTube クリエイターに関するインサイトを見つけて取得できます。この機能は、ターゲット ユーザーに関連するクリエイターを見つけたい代理店や広告主にとって便利です。
この API には主に 4 つの機能があります。
- クリエイターの検出可能性: 指定したトピック、ユーザー属性、オーディエンス、クリエイター属性の上位クリエイターを見つけます。
- クリエイター ブランド分析情報: 特定のブランドに関連するクリエイターに関する分析情報を取得します。
- クリエイター分析情報: チャンネル登録者数、視聴回数、視聴者のユーザー属性など、特定の YouTube チャンネルに関する分析情報を取得します。
- トレンドの分析情報: 特定のオーディエンスやトピックに基づいて、特定のトレンドに関する分析情報を取得します。
利用資格要件
ContentCreatorInsightsService.GenerateCreatorInsights
は、非独占的でロイヤリティ フリーのデータ ライセンスで提供される Google Ads API の非公開コンポーネントです。契約済みのパートナーは、標準の Google 広告クライアント ライブラリを使用して、YouTube クリエイターとコンテンツを検索できます。対象となるには、以下の条件を満たしている必要があります。
- API を統合するプランニング ツールまたはユーザー インターフェースがある。
- API を使用して、YouTube のコンテンツやクリエイターを調べ、広告掲載の機会を探します。
- 事前スクリーニング評価を完了して、利用資格を確認します。
- データ使用に関する要件を遵守し、定期的なデータ監査を受けることに同意している。
- データ使用要件を法的に強制するデータ ライセンス契約に署名します。
- Google Ads API の利用規約に同意します。
詳しくは、Google 担当者にお問い合わせください。
クリエイターの分析情報を生成する
クリエイターの分析情報を生成するには、ContentCreatorInsightsService.GenerateCreatorInsights メソッドにリクエストを送信します。このメソッドには 1 秒あたり 5 件のクエリ数（QPS）の制限があり、クリエイターの検出可能性、クリエイターのブランド分析、クリエイターの分析情報の取得のいずれを行うかによって、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 は、これらのトピックのトレンドの分析情報のリストを返します。これには、比較期間におけるトレンド値の変化率などの指標が含まれます。