クリエイター分析機能を使用すると、YouTube クリエイターに関する分析情報を検出して取得できます。この機能は、ターゲット オーディエンスに関連するクリエイターを見つけたい代理店や広告主にとって便利です。
この API には主に 4 つの機能があります。
- クリエイターの見つけやすさ: 指定したトピック、ユーザー属性、オーディエンス、クリエイター属性の上位クリエイターを見つけます。
- クリエイターのブランドに関するインサイト: 特定のブランドに関連するクリエイターに関するインサイトを取得します。
- クリエイター分析: 特定の YouTube チャンネルに関する分析情報（チャンネル登録者数、視聴回数、オーディエンスのユーザー属性など）を取得します。
- トレンド分析: 特定のオーディエンスまたはトピックに基づいて、特定のトレンドに関する分析情報を取得します。
利用資格要件
ContentCreatorInsightsService.GenerateCreatorInsights
は、非独占的かつロイヤリティ フリーのデータ ライセンスで提供される Google Ads API の非公開コンポーネントです。契約済みのパートナー様は、標準の
Google 広告クライアント ライブラリを使用して YouTube クリエイターとコンテンツを探索できます。利用資格を得るには、パートナー様は次の条件を満たす必要があります。
- Google Ads API を統合するプランニング ツールまたはユーザー インターフェースを用意している。
- API を使用して、広告掲載の可能性がある YouTube コンテンツとクリエイターを探索している。
- 利用資格を確認するための事前スクリーニングを完了している。
- データ使用要件を遵守し、定期的なデータ監査を受けることに同意している。
- データ使用要件を法的に強制するデータ ライセンス契約に署名している。
- Google Ads API 利用規約に同意している。
詳しくは、Google 担当者にお問い合わせください。
クリエイター分析情報を生成する
クリエイター分析情報を生成するには、
ContentCreatorInsightsService.GenerateCreatorInsights
メソッドにリクエストを送信します。このメソッドの秒間クエリ数（QPS）の上限は 5 です。クリエイターの見つけやすさ、クリエイターのブランド分析情報、クリエイター分析情報の取得のいずれを行うかによって、3 種類の入力を使用します。データを取得する国の場所を指定する必要があります。
クリエイターの見つけやすさ: 年齢、性別、ユーザーの興味 / 関心（アフィニティ、購買意向強、ライフイベントのオーディエンスなど）などのオーディエンス属性のリストを指定できます。API は、オーディエンスがこれらの属性に一致するクリエイターのリストを返します。クリエイター属性を指定して、入力したクリエイター属性にコンテンツが特に一致するクリエイターをフィルタすることもできます。
利用可能なオーディエンス属性を取得するには、属性を取得するディメンション（興味 / 関心のトピックの場合は
KNOWLEDGE_GRAPHなど）を指定して、AudienceInsightsService.ListAudienceInsightsAttributesを使用します。Google Ads API v23 以降では、
audience_combinationsを使用して複雑なオーディエンス属性の関係を指定できます。このフィールドを使用すると、audience_attributesでは不可能なブール論理（AND/OR）でオーディエンスを定義できます。audience_attributesは、結合された（OR で結合された）属性のリストに基づくターゲティングに適していますが（例: 「スポーツ」または「旅行」または...に関心のあるユーザー）、audience_combinationsを使用すると、より詳細な制御が可能になります。audience_combinations内の各InsightsAudienceAttributeGroupは、属性を論理 OR で結合します。これらのグループは、論理 AND で結合されます。たとえば、「スキンケア」または「ヘアケア」に関心があり、かつ「化粧品」にも関心のあるオーディエンスをターゲットにするには、
audience_combinationsで 2 つのInsightsAudienceAttributeGroupアイテムを使用します。「スキンケア」、「ヘアケア」、「化粧品」は興味 / 関心のトピックであり、ナレッジグラフ エンティティ（化粧品の場合は/m/014trlなど）で表されます。最初のグループには、「スキンケア」と「ヘアケア」のナレッジグラフ エンティティ属性が含まれ、2 番目のグループには「化粧品」のナレッジグラフ エンティティ属性が含まれます。ナレッジグラフ エンティティ、商品とサービスのカテゴリ、またはユーザーの興味 / 関心を
audience_attributesで指定した場合、audience_combinationsは使用できません。audience_combinationsを使用する場合は、これらの属性をaudience_attributesではなくaudience_combinationsで指定する必要があります。ただし、audience_combinationsと組み合わせて、ユーザー属性などの他の属性タイプにaudience_attributesを使用することはできます。クリエイターのブランド分析情報: ブランドを指定して、上位クリエイターを検索します。API は、一致するチャンネルに関する分析情報を返します。
クリエイター分析情報: YouTube チャンネル ID のリストを指定します。API は、それらの特定のチャンネルに関する分析情報を返します。
generateCreatorInsights メソッドは、GenerateCreatorInsightsResponse オブジェクトを返します。このオブジェクトには、YouTubeCreatorInsights
オブジェクトのリストが含まれています。各 YouTubeCreatorInsights オブジェクトには、クリエイターに関する次の情報が含まれています。
- クリエイターの名前
- YouTube チャンネル
- クリエイターの指標の合計
- YouTube チャンネルの分析情報のリスト
YouTubeMetrics オブジェクトには、
次の指標が含まれています。
- チャンネル登録者数
- 視聴回数
- 動画数
- YouTube ショート クリエイターとして活動しているかどうか
- パートナーシップの機会（ v23 以降）
YouTubeChannelInsights オブジェクトには、YouTube チャンネルに関する次の情報が含まれています。
- チャンネル名
- チャンネル ID
- チャンネル URL
- チャンネルの説明
- チャンネルの指標
チャンネルのオーディエンス属性（年齢、性別、ユーザーの興味 / 関心など
の内訳）
人気の動画
チャネルのタイプ
チャンネル コンテンツに関連付けられている言語
関連性スコア（トピックのトレンド検索の場合のみ）
トレンド分析情報を生成する
トレンド分析情報を生成するには、
ContentCreatorInsightsService.GenerateTrendingInsights
メソッドにリクエストを送信します。このメソッドの秒間クエリ数（QPS）の上限は 5 です。オーディエンスのトレンドを取得するか、トピックのトレンドを取得するかによって、2 種類の入力を使用します。トレンドを取得する特定の国の場所を指定する必要があります。
オーディエンスのトレンド: 年齢、性別、ユーザーの興味 / 関心（アフィニティ、購買意向強、ライフイベントのオーディエンスなど）などのオーディエンス属性のリストを指定できます。API は、これらのオーディエンスのトレンド分析情報のリストを返します。これには、比較期間におけるトレンド値の変化率などの指標が含まれます。
利用可能なオーディエンス属性を取得するには、属性を取得するディメンション（興味 / 関心のトピックの場合は
KNOWLEDGE_GRAPHなど）を指定して、AudienceInsightsService.ListAudienceInsightsAttributesを使用します。Google Ads API v23 以降では、
audience_combinationsを使用して複雑なオーディエンス属性の関係を指定できます。このフィールドを使用すると、audience_attributesでは不可能なブール論理（AND/OR）でオーディエンスを定義できます。audience_attributesは、結合された（OR で結合された）属性のリストに基づくターゲティングに適していますが（例: 「スポーツ」または「旅行」または...に関心のあるユーザー）、audience_combinationsを使用すると、より詳細な制御が可能になります。audience_combinations内の各InsightsAudienceAttributeGroupは、属性を論理 OR で結合します。これらのグループは、論理 AND で結合されます。たとえば、「スキンケア」または「ヘアケア」に関心があり、かつ「化粧品」にも関心のあるオーディエンスをターゲットにするには、
audience_combinationsで 2 つのInsightsAudienceAttributeGroupアイテムを使用します。「スキンケア」、「ヘアケア」、「化粧品」は興味 / 関心のトピックであり、ナレッジグラフ エンティティ（化粧品の場合は/m/014trlなど）で表されます。最初のグループには、「スキンケア」と「ヘアケア」のナレッジグラフ エンティティ属性が含まれ、2 番目のグループには「化粧品」のナレッジグラフ エンティティ属性が含まれます。ナレッジグラフ エンティティ、商品とサービスのカテゴリ、またはユーザーの興味 / 関心を
audience_attributesで指定した場合、audience_combinationsは使用できません。audience_combinationsを使用する場合は、これらの属性をaudience_attributesではなくaudience_combinationsで指定する必要があります。ただし、audience_combinationsと組み合わせて、ユーザー属性などの他の属性タイプにaudience_attributesを使用することはできます。トピックのトレンド: コンテンツ トピックのリストを指定します。API は、これらのトピックのトレンド分析情報のリストを返します。これには、比較期間におけるトレンド値の変化率などの指標が含まれます。