クリエイター分析機能を使用して、YouTube クリエイターに関する分析情報を取得します。これは、ターゲット オーディエンスに関連するクリエイターを探している代理店や広告主に役立ちます。
この API の主な機能は次の 2 つです。
- クリエイターの見つけやすさ: 特定のトピック、ユーザー属性、オーディエンスの上位クリエイターを見つけます。
- クリエイター インサイト: 特定の YouTube チャンネルに関する分析情報を取得します。 チャンネル登録者数、視聴回数、視聴者層などです。
利用資格要件
ContentCreatorInsightsService.GenerateCreatorInsights
は、非独占的なロイヤリティフリーのデータライセンスとともに提供される Google Ads API の非公開コンポーネントです。署名済みのパートナーは、
Google 広告クライアント ライブラリ: YouTube クリエイターと
説明します。対象となるには、パートナーは以下の条件を満たしている必要があります。
- API を統合する計画ツールまたはユーザー インターフェースが必要です。
- API を使用して、YouTube のコンテンツとクリエイターを調査し、潜在的な広告の機会を探します。
- 事前スクリーン評価を実施して、適格性を確認します。
- データ使用要件を遵守し、定期的なデータ監査に前向きである。
- データの使用を法的に強制するデータ ライセンス契約に署名する 提供します。
- Google Ads API の利用規約に同意します。
詳しくは、Google 担当者にお問い合わせください。
クリエイターの分析情報を生成する
クリエイターの分析情報を生成するには、ContentCreatorInsightsService.GenerateCreatorInsights
メソッドにリクエストを送信します。この方法では、秒間クエリ数(QPS)が 5 に制限されており、
表示される情報の種類は、クリエイターに見つけてもらうか、
クリエイターのインサイト
- クリエイターの見つけやすさ: 次のような視聴者属性のリストを指定します。 年齢、性別、インタレスト カテゴリが含まれます。API は、属性に一致する視聴者を持つクリエイターのリストを返します。
- クリエイター インサイト: YouTube チャンネル ID のリスト。API が返す 分析できます
generateCreatorInsights
メソッドは GenerateCreatorInsightsResponse
オブジェクトを返します。このオブジェクトには、YouTubeCreatorInsights
オブジェクトのリストが含まれます。各
YouTubeCreatorInsights
オブジェクトには、インスタンスに関する次の情報が格納されています。
クリエイター:
- クリエイターの名前
- YouTube チャンネル
- クリエイター指標の合計
- YouTube チャンネル インサイトのリスト
YouTubeMetrics
オブジェクトには次の指標が含まれています。
- チャンネル登録者数
- 視聴回数
YouTubeChannelInsights
オブジェクトには、インスタンスに関する次の情報が含まれます。
YouTube チャンネル:
- チャンネル名
- チャンネル ID
- チャンネルの指標
- チャンネルのオーディエンスの属性(年齢や性別の内訳など)
- チャネルのタイプ