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

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

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

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

利用資格要件

ContentCreatorInsightsService.GenerateCreatorInsights は、非独占的でロイヤリティ フリーのデータ ライセンスで提供される Google Ads API のプライベート コンポーネントです。契約済みのパートナー様は、標準の Google Ads クライアント ライブラリを使用して YouTube のクリエイターとコンテンツを探索できます。 ご利用いただくには、パートナー様は次の条件を満たす必要があります。

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

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

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

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

  1. クリエイターの見つけやすさ: 年齢、性別、ユーザーの興味関心（アフィニティ、購買意向強、ライフイベントのオーディエンスなど）などのオーディエンス属性のリストを指定できます。API は、オーディエンスがこれらの属性に一致するクリエイターのリストを返します。クリエイター属性を指定して、入力したクリエイター属性にコンテンツが一致するクリエイターをフィルタすることもできます。

    利用可能なオーディエンス属性を取得するには、 AudienceInsightsService.ListAudienceInsightsAttributesを使用します。属性を取得するディメンション（興味関心のあるトピックの KNOWLEDGE_GRAPHなど）を指定します。

    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 を使用することはできます。

  2. クリエイターのブランド分析情報: ブランドを指定して、人気のクリエイターを検索します。API は、一致するチャンネルに関する分析情報を返します。

  3. クリエイター分析情報: YouTube チャンネル ID のリストを指定します。API は、それらの特定のチャンネルに関する分析情報を返します。

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

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

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

クリエイターがオリジナル ブランド コンテンツのパートナーシップの対象となるかどうかを確認するには、 チェック partnership_opportunities。 リストに CREATOR_PARTNERSHIPS 値が含まれている場合、クリエイターは対象となります。

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

  • チャンネル名
  • チャンネル ID
  • チャンネル URL
  • チャンネルの説明
  • チャンネルの指標

  • チャンネルのオーディエンス属性（年齢、性別、ユーザーの興味関心など

    の内訳）

  • 人気の動画

  • チャネルのタイプ

  • チャンネル コンテンツに関連付けられた言語

  • 関連性スコア（トピックのトレンド検索のみ）

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

  1. オーディエンスのトレンド: 年齢、性別、ユーザーの興味関心（アフィニティ、購買意向強、ライフイベントのオーディエンスなど）などのオーディエンス属性のリストを指定できます。API は、これらのオーディエンスのトレンド分析情報のリストを返します。これには、比較期間におけるトレンド値の変化率などの指標が含まれます。

    利用可能なオーディエンス属性を取得するには、 AudienceInsightsService.ListAudienceInsightsAttributesを使用します。属性を取得するディメンション（興味関心のあるトピックの KNOWLEDGE_GRAPHなど）を指定します。

    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 を使用することはできます。

  2. トピックのトレンド: コンテンツ トピックのリストを指定します。API は、これらのトピックのトレンド分析情報のリストを返します。これには、比較期間におけるトレンド値の変化率などの指標が含まれます。

前へ
オーディエンス分析