对 AudienceInsightsService 的所有请求都受速率限制。与受众群体洞察的其他方法相比，generateAudienceCompositionInsights 和 generateSuggestedTargetingInsights 每天允许的请求次数更少。如需了解详情，请参阅 API 配额。
AudienceInsightsService 可让您将 Google 受众群体数据分析洞见集成到规划工具中。这些数据有助于媒体代理机构和媒体策划人员更深入地了解目标受众群体，包括其人口统计学特征、兴趣和线上行为。
受众群体分析可提供概略信息，帮助您了解受众群体、类别、主题或品牌。通过分析与相关主题有关的用户行为，您可以利用这些受众群体分析数据来揭示消费者之间的关联和他们的看法，并确定新的细分受众群。
该 API 支持以下三个主要用例：
- 优化和发掘受众群体：了解消费者的独特兴趣和行为，为品牌发掘新的受众群体，制定受众群体角色，并优化受众群体细分策略。
- 为广告系列规划提供信息：将数据输出转化为 YouTube 目标受众群体，以便进行规划；估算目标受众群体的潜在覆盖面；衡量细分受众群之间的重叠情况，以便最大限度地扩大广告系列覆盖面。
- 制作广告素材信息：根据目标受众最常互动的主题和兴趣，为他们量身定制广告素材信息。
资格要求
如要符合 AudienceInsightsService 的条件，合作伙伴必须满足以下条件：
- 已获得或符合获得 Insights Finder 使用权限的条件。
- 拥有集成该 API 的规划工具或用户界面。
- 将该 API 用于媒体规划目的或其他相关使用情形。
- 完成初步筛选评估。
- 遵循数据使用要求并接受定期数据审核。
- 接受 Google Ads API 服务条款和相关的数据使用政策。
如需了解详情，请与您的 Google 代表联系。
列出符合条件的数据分析日期
典型的工作流程首先会检查哪些日历月和日期窗口可用于分析。listInsightsEligibleDates 方法会返回一个 ListInsightsEligibleDatesResponse，其 data_months 字段会列出提供受众群体洞见数据的月份（采用 YYYY-MM 格式）。
响应的 last_thirty_days 字段包含 generateAudienceCompositionInsights 在请求中未设置 data_month 时使用的确切日期范围。
列出受众群体分析属性
在查询受众群体构成或重叠指标之前，请使用 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 界面中打开该报告。