对 AudienceInsightsService 的所有请求都受到速率限制。与其他受众群体分析方法相比，generateAudienceCompositionInsights 和 generateSuggestedTargetingInsights 每天允许的请求次数更少。如需了解详情，请参阅 API 配额。
AudienceInsightsService 可让您将 Google 受众群体分析数据集成到规划工具中。这些数据有助于媒体代理机构和媒体规划人员更深入地了解其目标受众群体，包括受众特征、兴趣和在线行为。
受众群体分析可提供概略信息，帮助您了解受众群体、类别、主题或品牌。通过分析与相关主题有关的用户行为，您可以利用这些受众群体分析数据来揭示消费者之间的关联和他们的看法，并确定新的细分受众群。
该 API 支持三种主要应用场景：
- 细化和发掘受众群体：了解消费者的独特兴趣和行为，为品牌识别新的受众群体、制定受众群体角色并优化细分受众群策略。
- 为广告系列策划提供依据：将数据输出转化为 YouTube 目标受众群体，以便据此进行策划、估算目标受众群体的潜在覆盖面，并衡量细分受众群之间的重叠情况，从而最大限度地扩大广告系列覆盖面。
- 制作广告内容：根据目标受众群体最常互动的主题和兴趣，为其量身定制广告内容。
资格要求
如要获得 AudienceInsightsService 资格，合作伙伴必须满足以下条件：
- 目前有权访问 Insights Finder，或符合访问条件。
- 拥有集成该 API 的规划工具或界面。
- 将该 API 用于媒体规划或其他相关应用场景。
- 完成预筛查评估。
- 遵守数据使用要求，并定期接受数据审核。
- 接受 Google Ads API 服务条款和相关数据使用政策。
如需了解详情，请与您的 Google 代表联系。
列出符合数据分析条件的日期
典型工作流首先会检查哪些日历月份和日期窗口可供分析。listInsightsEligibleDates 方法会返回 ListInsightsEligibleDatesResponse，其 data_months 字段会列出有受众群体分析数据的月份（采用 YYYY-MM 格式）。
如果请求中未设置 data_month，则响应的 last_thirty_days 字段包含 generateAudienceCompositionInsights 使用的确切日期范围。
列出受众群体分析属性
在查询受众群体构成或重叠指标之前，请使用 listAudienceInsightsAttributes 发现有效的属性 ID。此方法会返回一个 ListAudienceInsightsAttributesResponse，其中包含所请求维度的可用属性。
例如，如果在请求中选择 AFFINITY_USER_INTEREST 作为维度，该方法会返回支持的兴趣相似的受众群体，例如“体育迷”或“音乐爱好者”。其他受支持的用户兴趣维度包括 IN_MARKET_USER_INTEREST 和 LIFE_EVENT_USER_INTEREST。您可以在单个请求中设置多个维度。如需查看受支持维度的完整列表，请参阅 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 Ads 细分受众群的捆绑建议。此方法有助于回答诸如“请为我提供针对 30 多岁、喜欢钓鱼的父亲的可定位受众群体建议”之类的问题。
生成定位建议指标
generateTargetingSuggestionMetrics 方法会返回一个 GenerateTargetingSuggestionMetricsResponse，其中包含 GenerateTargetingSuggestionMetricsRequest 中请求的每个受众群体定义可覆盖的潜在 YouTube 人口。
此方法有助于回答诸如“在 YouTube 上可以覆盖多少年满 18 周岁且对露营感兴趣的美国男性？”之类的问题。
生成受众群体构成分析数据
generateAudienceCompositionInsights 方法会返回一个 GenerateAudienceCompositionInsightsResponse，其中包含一系列属性，这些属性代表所请求的感兴趣受众群体，以及将每个属性的受众群体份额与基准人口进行比较的指数和份额指标。
您必须为受众群体提供目标国家/地区。GenerateAudienceCompositionInsightsRequest 的 dimensions 字段中记录了用于检索构成数据分析的受支持维度列表。
此方法有助于回答以下问题：“与总体人群相比，我的目标受众群体最感兴趣的兴趣相似类别是什么？他们与这些兴趣相似类别互动的可能性有多大？”
生成受众群体重复分析洞见
generateAudienceOverlapInsights 方法会返回一个 GenerateAudienceOverlapInsightsResponse，其中包含受众群体属性列表，以及这些属性的潜在 YouTube 覆盖面与主要属性的潜在 YouTube 覆盖面之间的重叠估算值。
您必须提供目标国家/地区和主要属性。支持将年龄段、性别、兴趣相似的细分受众群和有购买意向的细分受众群作为受众群体维度。
此方法有助于回答诸如“当我们在美国同时定位到体育迷和音乐爱好者时，增量受众群体规模有多大？”之类的问题。
生成 Insights Finder 报告
generateInsightsFinderReport 方法会根据 GenerateInsightsFinderReportRequest 中指定的输入在 Insights Finder 中创建已保存的报告，并返回一个 GenerateInsightsFinderReportResponse，其中包含一个可从外部访问的链接，用于在 Insights Finder 界面中打开该报告。