オーディエンス分析

AudienceInsightsService へのすべてのリクエストにはレート制限が適用されます。generateAudienceCompositionInsights と generateSuggestedTargetingInsights で 1 日に許可されるリクエスト数は、他のオーディエンス分析メソッドよりも少なくなります。詳細については、API の割り当てをご覧ください。

AudienceInsightsService を使用すると、Google のオーディエンス分析データをプランニング ツールに統合できます。このデータは、広告代理店やメディア プランナーが、ユーザー属性、興味 / 関心、オンライン行動など、ターゲット オーディエンスをより深く理解するのに役立ちます。

オーディエンス分析では、オーディエンス、カテゴリ、トピック、ブランドの大まかな概要を把握できます。関連トピックについてのユーザー行動を分析することで、これらのオーディエンス分析を使用して、顧客のブランド連想とブランド認知を明らかにし、新しいオーディエンス セグメントを特定できます。

この API は、主に次の 3 つのユースケースをサポートしています。

  • オーディエンスの絞り込みと発掘: 消費者独自の興味や関心、行動を把握して、ブランドの新しいオーディエンスを特定し、オーディエンス ペルソナを開発して、オーディエンス セグメンテーション戦略を絞り込みます。
  • キャンペーンのプランニングに役立てる: データ出力を YouTube のターゲット オーディエンスに変換してプランニングに活用し、ターゲット オーディエンスのリーチ予測を推定して、オーディエンス セグメント間の重複を測定することで、キャンペーンのリーチを最大化します。
  • クリエイティブ メッセージを作成する: ターゲット ユーザーが最も関心を持っているトピックやアフィニティに基づいて、クリエイティブ メッセージをカスタマイズします。

利用資格要件

AudienceInsightsService の対象となるには、パートナーは次の条件を満たす必要があります。

  • Insights Finder へのアクセス権がある、またはアクセス権の利用要件を満たしている。
  • API を統合した計画ツールまたはユーザー インターフェースがある。
  • メディア プランニングの目的やその他の関連するユースケースで API を使用します。
  • 事前スクリーニング評価を完了する。
  • データ使用要件を遵守し、定期的なデータ監査を受ける。
  • Google Ads API の利用規約と、関連するデータ使用ポリシーに同意します。

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

インサイトの対象期間を一覧表示する

一般的なワークフローは、分析に使用できる暦月と日付ウィンドウを確認することから始まります。listInsightsEligibleDates メソッドは ListInsightsEligibleDatesResponse を返します。この data_months フィールドには、オーディエンス分析データが利用可能な月が YYYY-MM 形式で一覧表示されます。

レスポンスの last_thirty_days フィールドには、リクエストで data_month が設定されていない場合に generateAudienceCompositionInsights が使用する正確な期間が含まれます。

オーディエンス分析の属性を一覧表示する

オーディエンス構成または重複指標をクエリする前に、listAudienceInsightsAttributes を使用して有効な属性 ID を検出します。このメソッドは、リクエストされたディメンションで使用可能な属性を含む ListAudienceInsightsAttributesResponse を返します。

たとえば、リクエストでディメンションとして AFFINITY_USER_INTEREST が選択されている場合、このメソッドは「スポーツファン」や「音楽ファン」などのサポートされているアフィニティ カテゴリを返します。サポートされている他のユーザー インタレスト ディメンションには、IN_MARKET_USER_INTEREST と LIFE_EVENT_USER_INTEREST があります。1 つのリクエストに複数のディメンションを設定できます。サポートされているディメンションの一覧については、dimensions フィールド リファレンスをご覧ください。

KNOWLEDGE_GRAPH ディメンションを使用してナレッジグラフ エンティティ(トピック)を検索する場合は、query_text フィールドに文字列クエリ(例: "football and the World Cup")を指定する必要があります。

必要に応じて knowledge_graph_entity_search_options を含めて、トピック検索をカスタマイズできます。

  • 機能でフィルタする: search_filter を使用して、取得したエンティティを特定の機能をサポートするエンティティのみに絞り込みます。たとえば、entity_capability_filters フィールドに CREATOR_ATTRIBUTE を指定すると、クリエイター属性としてサポートされているトピックをフィルタできます。複数の機能を指定でき、OR ロジックと組み合わせることができます。
  • すべてのクリエイター属性を取得する: get_all_creator_attributes を true に設定して、クリエイター属性としてタグ付けされた、利用可能なすべてのナレッジグラフ エンティティを取得します。このオプションを使用する場合は、KNOWLEDGE_GRAPH ディメンションを選択する必要があります。query_text は空にする必要があります。このオプションを search_filter と組み合わせることはできません。

この検出方法で返される属性は、他の AudienceInsightsService メソッドの入力として使用できます。

ListAudienceInsightsAttributesResponse の各 AudienceInsightsAttributeMetadata オブジェクトは、オーディエンス属性の構造化された表現と、説明プロパティおよびエンゲージメント指標を提供します。これには、属性のプライマリ定義、表示名、ディメンション タイプ、推定ユーザーリーチ率が含まれます。フィールドの定義については、AudienceInsightsAttributeMetadata リファレンスをご覧ください。

オーディエンスの定義を生成する

generateAudienceDefinition メソッドは、オーディエンスの自由形式のテキスト記述を、ダウンストリームの分析情報メソッドに渡すことができる構造化されたオーディエンス属性の候補に変換します。

ターゲティングの提案に関する分析情報を生成する

generateSuggestedTargetingInsights メソッドは、リクエストされたオーディエンスに関連するターゲティング分析情報(ターゲティング可能なオーディエンス セグメントなど)のコレクションを返します。

リクエストされたオーディエンスは、構造化された InsightsAudienceDefinition または InsightsAudienceDescription のテキスト記述として指定できます。

generateAudienceCompositionInsights は個々の属性セグメントの分析情報を返しますが、generateSuggestedTargetingInsights はターゲット設定可能な Google 広告オーディエンス セグメントのバンドルされた候補を返します。このメソッドは、「釣りを楽しむ 30 代の父親をターゲットにできるオーディエンスの候補を教えて」といった質問に答えるのに役立ちます。

ターゲティング候補の指標を生成する

generateTargetingSuggestionMetrics メソッドは GenerateTargetingSuggestionMetricsResponse を返します。これには、GenerateTargetingSuggestionMetricsRequest でリクエストされた各オーディエンスの定義でリーチできる可能性のある YouTube 人口が含まれます。

この方法を使用すると、「米国でキャンプに興味がある 18 歳以上の男性のうち、YouTube でリーチできるのは何人か」といった疑問に答えることができます。

オーディエンス構成の分析情報を生成する

generateAudienceCompositionInsights メソッドは GenerateAudienceCompositionInsightsResponse を返します。これには、リクエストされた関心のあるオーディエンスを表す属性のリストと、各属性のオーディエンスのシェアをベースライン人口と比較するインデックスとシェアの指標が含まれます。

オーディエンスの対象国を指定する必要があります。構成分析情報を取得するためにサポートされているディメンションのリストは、GenerateAudienceCompositionInsightsRequest の dimensions フィールドに記載されています。

この方法を使用すると、「ターゲット ユーザーが関心を持っている上位のアフィニティは、全対象ユーザーと比較してどのようなものか、また、それらのアフィニティに関与する可能性はどの程度高いか」などの質問に答えることができます。

オーディエンスの重複に関する分析情報を生成する

generateAudienceOverlapInsights メソッドは GenerateAudienceOverlapInsightsResponse を返します。これには、オーディエンス属性のリストと、YouTube での潜在的なリーチとプライマリ属性のリーチの重複の推定値が含まれます。

対象国とメイン属性を指定する必要があります。オーディエンス ディメンションとして、年齢層、性別、アフィニティ セグメント、購買意向の強いセグメントがサポートされています。

この方法を使用すると、「米国でスポーツファンと音楽ファンの両方をターゲットに設定した場合、オーディエンスの規模はどの程度増加するか」などの疑問に答えることができます。

Insights Finder レポートを生成する

generateInsightsFinderReport メソッドは、GenerateInsightsFinderReportRequest で指定された入力に基づいて Insights Finder に保存済みレポートを作成し、Insights Finder UI でそのレポートを開くための外部からアクセス可能なリンクを含む GenerateInsightsFinderReportResponse を返します。

Google Issue Tracker

Google Issue Tracker を使用して、サポートに関する質問、バグの報告、機能リクエストの送信を行います。Google は、Issue Tracker でリクエストを直接追跡し、優先順位を付けて、更新情報を投稿します。詳細については、Google Issue Tracker で問題を作成するをご覧ください。

次のいずれかの Issue Tracker テンプレートを使用して問題を作成します。

Google がリクエストを再現して優先順位を付けられるように、テンプレートのすべてのフィールドに詳細な情報を入力します。不完全なレポートはクローズされ、不足している詳細情報を記載した新しい問題を送信するよう求められることがあります。