AudienceInsightsService を使用すると、Google のオーディエンス分析情報を独自のツールに統合できます。このデータにより、メディア エージェンシーやメディア プランナーは、ターゲット オーディエンスのユーザー属性、興味 / 関心、オンライン行動など、ターゲット オーディエンスをより深く理解できます。
オーディエンス分析では、オーディエンス、カテゴリ、トピック、ブランドの大まかな概要を把握できます。関連トピックについてのユーザー行動を分析することで顧客のブランド連想とブランド認知が浮き彫りになるため、オーディエンスについての新しいインサイトを得ることができます。
この API の主なユースケースは次の 3 つです。
オーディエンスを絞り込み、発掘する: 消費者の独自の興味や行動を把握して、ブランドの新しいオーディエンスを特定し、オーディエンス ペルソナを作成して、オーディエンス セグメンテーション戦略を絞り込みます。
キャンペーン プランニングに役立つ情報: データ出力を YouTube のターゲット ユーザーに変換して、計画に役立てます。ターゲット ユーザーのリーチの可能性を特定し、メディア キャンペーンの計画に役立てることができます。オーディエンス セグメント間の重複を測定して、キャンペーンの潜在的なリーチを最大化できます。
クリエイティブ メッセージを作成する: ターゲット ユーザーが最も関心を持っていることを把握したら、そのユーザーに合わせてクリエイティブ メッセージを調整します。
利用資格要件
AudienceInsightsService の対象となるには、パートナーは次の条件を満たしている必要があります。
- Insights Finder への既存のアクセス権があるか、アクセス権を取得できる。
- API を統合するプランニング ツールまたはユーザー インターフェースがある。
- メディア プランニングの目的またはその他の関連するユースケースで API を使用します。
- 事前スクリーニング評価を完了します。
- データ使用要件を遵守し、定期的なデータ監査を受けることに同意している。
- データ使用要件を法的に強制するデータ ライセンス契約に署名します。
- Google Ads API の利用規約に同意します。
詳しくは、Google 担当者にお問い合わせください。
オーディエンス構成の分析情報を生成する
generateAudienceCompositionInsights メソッドは GenerateAudienceCompositionInsightsResponse を返します。これには、リクエストされた対象ユーザーを表す属性のリストと、各属性の対象ユーザーのシェアをベースライン対象ユーザーのシェアと比較する指標が含まれます。
オーディエンスのターゲット国を指定する必要があります。構成分析情報の取得でサポートされているディメンションのリストは、GenerateAudienceCompositionInsightsRequest の dimensions フィールドの説明に記載されています。
この方法では、「全対象ユーザーと比較して、ターゲット ユーザーが最も関心を持っているアフィニティ カテゴリはどれか？また、全対象ユーザーと比較して、ターゲット ユーザーがそれらのアフィニティ カテゴリに関心を持っている可能性はどの程度高いか？」といった質問に答えることができます。
オーディエンスの重複に関する分析情報を生成する
generateAudienceOverlapInsights メソッドは、GenerateAudienceOverlapInsightsResponse を返します。これには、潜在的な YouTube リーチと指定されたプライマリ属性のリーチの重複の推定値を含むオーディエンス属性のリストが含まれます。
対象国とメイン属性を指定する必要があります。年齢層、性別、アフィニティ セグメント、購買意向の強いセグメントは、オーディエンス ディメンションとしてサポートされています。
この方法を使用すると、「米国でスポーツファンと音楽ファンを両方ターゲットに設定した場合、ユーザーの規模の伸びはどのくらいになるか？」などの質問に答えることができます。
オーディエンスの定義を生成する
generateAudienceDefinition メソッドは、オーディエンスの説明に基づいてオーディエンス属性の候補を返します。
分析情報ファインダー レポートを生成する
generateInsightsFinderReport メソッドは、GenerateInsightsFinderReportRequest で指定された入力に基づいて Insights Finder に保存済みレポートを作成し、そのレポートを Insights Finder ユーザー インターフェースで開くための外部からアクセス可能なリンクを含む GenerateInsightsFinderReportResponse を返します。
ターゲティングに関する分析情報の候補を生成する
generateSuggestedTargetingInsights メソッドは、リクエストされたオーディエンスに関連するターゲティング分析情報（ターゲティング可能なオーディエンスなど）のコレクションを返します。
リクエストされたオーディエンスは、構造化された形式 InsightsAudienceDefinition またはテキストの説明 InsightsAudienceDescription のいずれかの形式で指定できます。
generateAudienceCompositionInsights メソッドは、関連する個々の属性セグメントの分析情報を返します。一方、generateSuggestedTargetingInsights は、ターゲット設定可能な Google オーディエンス セグメントの提案と分析情報を返します。
このメソッドは、「30 代で釣りが好きな父親をターゲットにできるオーディエンスの候補を教えて」といった質問に答えるのに役立ちます。
ターゲティングの候補の指標を生成する
generateTargetingSuggestionMetrics メソッドは、GenerateTargetingSuggestionMetricsRequest でリクエストされた各オーディエンスの定義でリーチできる可能性のある YouTube 人口を含む GenerateTargetingSuggestionMetricsResponse を返します。
この方法を使用すると、「米国でキャンプに興味がある 18 歳以上の男性に YouTube でどのくらいリーチできるか？」といった質問に答えることができます。
オーディエンス分析情報の属性を一覧表示する
listAudienceInsightsAttributes メソッドは、リクエストされたディメンションで使用可能な属性のリストを含む ListAudienceInsightsAttributesResponse を返します。
たとえば、リクエストでディメンションとして「アフィニティ」が選択されている場合、「スポーツファン」や「音楽好き」など、サポートされているアフィニティ ユーザーのリストが返されます。サポートされているその他のユーザーの興味 / 関心ディメンションには、「購買意向の強いオーディエンス」と「ライフイベント」があります。1 つのリクエストに複数のディメンションを設定できます。サポートされているディメンションの完全なリストについては、リファレンス ドキュメントをご覧ください。
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 リファレンス ドキュメントをご覧ください。
分析情報の対象期間を一覧表示する
listInsightsEligibleDates メソッドは、オーディエンス分析データが利用可能な月のリスト（「YYYY-MM」形式）を含む ListInsightsEligibleDatesResponse を返します。
リクエストで date_month が設定されていない場合、レスポンスには generateAudienceCompositionInsights メソッドで使用される「過去 30 日間」を表す実際の日付も含まれます。