受众群体分析
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
借助 AudienceInsightsService
,用户可以将 Google 受众群体数据洞见集成到其专有工具中。借助这些数据,媒体代理机构和媒体策划人员可以更深入地了解目标受众群体,包括其人口统计学特征、兴趣和线上行为。
通过受众群体分析,用户可以快速概略了解受众群体、类别、主题或品牌。通过分析与相关主题有关的用户行为,客户可以利用这些受众群体数据分析来揭示消费者之间的关联和他们的看法,从新的角度深入了解自己的受众群体。
该 API 有三个主要用例:
优化和发掘受众群体:了解消费者的独特兴趣和行为,为品牌发掘新的受众群体,制定受众群体角色,并优化受众群体细分策略。
为广告系列规划提供信息:将数据输出转化为 YouTube 目标受众群体,以便进行规划。允许客户确定目标受众群的潜在覆盖面,以帮助他们规划媒体广告系列。使客户能够衡量细分受众群之间的重叠情况,从而最大限度地扩大广告系列的潜在覆盖面。
制作广告内容:了解目标受众群体最关心什么,然后根据这些信息量身定制广告内容。
资格要求
合作伙伴必须满足以下条件,才有资格使用 AudienceInsightsService
:
- 已获得或符合条件可获得数据洞察查找工具的使用权限。
- 拥有将集成该 API 的规划工具或用户界面。
- 将该 API 用于媒体规划目的或其他相关使用情形。
- 完成预筛查评估。
- 遵守数据使用要求,并愿意接受定期数据审核。
- 签署数据许可协议,以从法律上强制执行数据使用要求。
- 接受 Google Ads API 服务条款。
如需了解详情,请与您的 Google 代表联系。
生成受众群体构成分析洞见
generateAudienceCompositionInsights
方法会返回一个 GenerateAudienceCompositionInsightsResponse
,其中包含一个属性列表,这些属性表示所请求的兴趣受众群体,并包含一些指标,用于比较每个属性在受众群体中所占的份额与在基准受众群体中所占的份额。
您必须为受众群体提供目标国家/地区。GenerateAudienceCompositionInsightsRequest
的 dimensions
字段说明中列出了用于检索组成分析信息的支持维度。
此方法可帮助回答以下问题:“与一般人群相比,我的目标受众群体对哪些兴趣相似的受众群体最感兴趣?与一般人群相比,他们对这些兴趣相似的受众群体感兴趣的可能性高出多少?”
生成受众群体重叠分析
generateAudienceOverlapInsights
方法会返回一个 GenerateAudienceOverlapInsightsResponse
,其中包含一系列具有估计重叠率的受众群体属性,这些重叠率是指这些属性的潜在 YouTube 覆盖面与给定主要属性的潜在 YouTube 覆盖面之间的重叠率。
您必须提供目标国家/地区和主要属性。支持将年龄段、性别、兴趣相似的细分受众群和有购买意向的细分受众群用作受众群体维度。
此方法可帮助回答以下问题:“如果我们同时定位美国境内的体育迷和音乐爱好者,增量受众群体规模有多大?”
生成“数据分析查找工具”报告
generateInsightsFinderReport
方法会根据 GenerateInsightsFinderReportRequest
中指定的给定输入在数据洞见发现工具中创建已保存的报告,并返回一个 GenerateInsightsFinderReportResponse
,其中包含可在数据洞见发现工具界面中打开相应报告的外部可访问链接。
生成建议的定位数据分析
generateSuggestedTargetingInsights
方法会返回与所请求的受众群体相关的一组定位分析数据(例如可定位的受众群体)。
所请求的受众群体可以采用结构化格式 InsightsAudienceDefinition
或文本说明 InsightsAudienceDescription
的形式。
generateAudienceCompositionInsights
方法会返回相关单个属性细分的分析洞见,而 generateSuggestedTargetingInsights
方法会返回可定位的 Google 细分受众群的建议和分析洞见。
此方法有助于回答以下问题:“为 30 多岁且喜欢钓鱼的父亲提供可定位的受众群体建议。”
生成定位建议指标
generateTargetingSuggestionMetrics
方法会返回一个 GenerateTargetingSuggestionMetricsResponse
,其中包含 GenerateTargetingSuggestionMetricsRequest
中请求的每个受众群体定义可能覆盖的 YouTube 人口。
此方法可帮助回答诸如“YouTube 上有多少年满 18 周岁且对美国露营感兴趣的男性?”之类的问题。
列出受众群体分析属性
listAudienceInsightsAttributes
方法会返回一个 ListAudienceInsightsAttributesResponse
,其中包含所请求维度的可用属性列表。
例如,如果在请求中选择“兴趣相似的受众群体”作为维度,系统将返回受支持的兴趣相似的受众群体列表,例如“体育迷”或“音乐爱好者”。您可以为单个请求设置多个维度。
此可发现性功能返回的属性可用作其他 AudienceInsightsService
功能的输入。
列出符合条件的数据分析日期
listInsightsEligibleDates
方法会返回一个 ListInsightsEligibleDatesResponse
,其中包含以“YYYY-MM”形式表示的月份列表,这些月份都有受众群体洞见数据。
响应还包含表示“过去 30 天”的实际日期,当请求中未设置 date_month
时,这些日期将用于 generateAudienceCompositionInsights
方法。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-27。
[null,null,["最后更新时间 (UTC):2025-08-27。"],[],[],null,["# Audience insights\n\n| **Important:** This feature is only available to accounts on an allowlist. Contact your Google representative if you need access to this feature.\n|\n| All requests to\n| [`AudienceInsightsService`](/google-ads/api/reference/rpc/v21/AudienceInsightsService) are\n| rate-limited. However, fewer requests are allowed per day for\n| [`generateAudienceCompositionInsights`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/GenerateAudienceCompositionInsights)\n| and\n| [`generateSuggestedTargetingInsights`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/GenerateSuggestedTargetingInsights)\n| than for other Audience Insights methods. See documentation on\n| [Quota](/google-ads/api/docs/best-practices/quotas) for more details.\n\n[`AudienceInsightsService`](/google-ads/api/reference/rpc/v21/AudienceInsightsService) allows users\nto integrate Google audience insights data into their proprietary tools. The\ndata allows media agencies and media planners to gain a deeper understanding of\ntheir target audience, including demographics, interests, and online behavior.\n\nAudience insights allow users to quickly understand an audience, a category, a\ntopic or a brand by providing a high-level overview. By analyzing user\nbehaviors on related topics, customers can use these audience insights to\nilluminate the associations and perceptions that consumers have, to arrive at\nnew insights about their audiences.\n\nThe API has three main use cases:\n\n- **Refine and Uncover Audiences:** Understand consumers' unique interests and\n behaviors to identify new audiences for the brand, develop audience personas,\n and refine audience segmentation strategies.\n\n- **Inform Campaign Planning:** Translate data outputs into Youtube target\n audiences to plan against. Allows customers to identify potential reach of their\n targeted audiences to help them plan media campaigns. Enables customers to\n measure the overlap between audience segments to maximize the potential reach of\n their campaigns.\n\n- **Develop Creative Messages:** Tailor creative messages to your target\n audience after learning what they care about most.\n\nEligibility requirements\n------------------------\n\nTo be eligible for\n[`AudienceInsightsService`](/google-ads/api/reference/rpc/v21/AudienceInsightsService), partners\nmust satisfy the following conditions:\n\n- Existing access, or eligible for access, to [Insights Finder](https://ads.google.com/intl/en_us/home/tools/insights-finder/).\n- Have a planning tool or user interface that will integrate the API.\n- Use the API for media planning purposes, or for other relevant use cases.\n- Complete a pre-screen assessment.\n- Follow data usage requirements and be willing to undergo periodic data audits.\n- Sign a data-licensing agreement that legally enforces data usage requirements.\n- Accept the Google Ads API [terms of service](../../terms).\n\nContact your Google representative for more information.\n\nGenerate audience composition insights\n--------------------------------------\n\nThe\n[`generateAudienceCompositionInsights`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/GenerateAudienceCompositionInsights)\nmethod returns a\n[`GenerateAudienceCompositionInsightsResponse`](/google-ads/api/reference/rpc/v21/GenerateAudienceCompositionInsightsResponse),\nwhich contains a list of attributes that represent the requested audience of\ninterest, with metrics that compare each attribute's share of the audience with\nits share of a baseline audience.\n\nYou must provide a target country for the audience. The list of supported\ndimensions for retrieving composition insights is enumerated at the `dimensions`\nfield description of the\n[`GenerateAudienceCompositionInsightsRequest`](/google-ads/api/reference/rpc/v21/GenerateAudienceCompositionInsightsRequest).\n\nThis method can help answer questions such as \"What are the top affinities my\ntarget audience is interested in compared to the general population and how\nmuch more likely are they interested in those affinities compared to the general\npopulation?\"\n\nGenerate audience overlap insights\n----------------------------------\n\nThe\n[`generateAudienceOverlapInsights`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/generateAudienceOverlapInsights)\nmethod returns a\n[`GenerateAudienceOverlapInsightsResponse`](/google-ads/api/reference/rpc/v21/GenerateAudienceOverlapInsightsResponse)\nwhich contains a list\nof audience attributes with estimates of the overlap between their potential\nYoutube reach and that of a given primary attribute.\n\nYou must provide a target country and a primary attribute. Age range, gender,\naffinity segments, and in-market segments are supported as audience dimensions.\n\nThis method can help answer questions such as \"How large is the incremental\naudience size when we target both Sports Fans and Music Lovers in the United\nStates?\"\n\nGenerate insights finder report\n-------------------------------\n\nThe\n[`generateInsightsFinderReport`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/GenerateInsightsFinderReport)\nmethod creates a saved report in\n[Insights Finder](https://ads.google.com/intl/en_us/home/tools/insights-finder/)\nbased on the given inputs specified in the\n[`GenerateInsightsFinderReportRequest`](/google-ads/api/reference/rpc/v21/GenerateInsightsFinderReportRequest)\nand returns a\n[`GenerateInsightsFinderReportResponse`](/google-ads/api/reference/rpc/v21/GenerateInsightsFinderReportResponse)\ncontaining an externally accessible link to open that report in the Insights\nFinder User Interface.\n\nGenerate suggested targeting insights\n-------------------------------------\n\nThe\n[`generateSuggestedTargetingInsights`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/GenerateSuggestedTargetingInsights)\nmethod returns a collection of targeting insights (e.g. targetable audiences)\nthat is relevant to the requested audience.\n\nThe requested audience may be in the form of either a structured format\n[`InsightsAudienceDefinition`](/google-ads/api/reference/rpc/v21/InsightsAudienceDefinition) or as a\ntext description\n[`InsightsAudienceDescription`](/google-ads/api/reference/rpc/v21/InsightsAudienceDescription).\n\nThe\n[`generateAudienceCompositionInsights`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/GenerateAudienceCompositionInsights)\nmethod returns insights for relevant individual attribute segments while the\n[`generateSuggestedTargetingInsights`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/GenerateSuggestedTargetingInsights)\nreturns suggestions and insights of targetable Google audience segments.\n\nThis method helps answer questions such as \"Give me targetable audience\nsuggestions for fathers in their 30s who enjoy fishing.\"\n\nGenerate targeting suggestion metrics\n-------------------------------------\n\nThe\n[`generateTargetingSuggestionMetrics`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/GenerateTargetingSuggestionMetrics)\nmethod returns a\n[`GenerateTargetingSuggestionMetricsResponse`](/google-ads/api/reference/rpc/v21/GenerateTargetingSuggestionMetricsResponse)\n, which contains the potential YouTube population that may be reached for each\naudience definition requested in the\n[`GenerateTargetingSuggestionMetricsRequest`](/google-ads/api/reference/rpc/v21/GenerateTargetingSuggestionMetricsRequest).\n\nThis method can help answer questions such as \"How many Men aged 18+ interested\nin Camping in the United States can be reached on YouTube?\"\n\nList audience insights attributes\n---------------------------------\n\nThe\n[`listAudienceInsightsAttributes`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/ListAudienceInsightsAttributes)\nmethod returns a\n[`ListAudienceInsightsAttributesResponse`](/google-ads/api/reference/rpc/v21/ListAudienceInsightsAttributesResponse)\nthat contains the list of available attributes for the requested dimensions.\n\nFor example, if Affinity User Interest is selected as a dimension in the\nrequest, it will give back a list of supported affinities such as \"Sports Fans\"\nor \"Music Lovers.\" You may set multiple dimensions for a single request.\n\nThe attributes returned by this discoverability feature can be used as inputs\nfor other [`AudienceInsightsService`](/google-ads/api/reference/rpc/v21/AudienceInsightsService)\nfeatures.\n\nList insights eligible dates\n----------------------------\n\nThe\n[`listInsightsEligibleDates`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/ListInsightsEligibleDates)\nmethod returns a\n[`ListInsightsEligibleDatesResponse`](/google-ads/api/reference/rpc/v21/ListInsightsEligibleDatesResponse)\n, which contains a list of months in the form \"YYYY-MM\", for which audience\ninsights data is available.\n\nThe response also contains the actual dates representing the \"last 30 days\"\nthat will be used for the\n[`generateAudienceCompositionInsights`](/google-ads/api/reference/rpc/v21/AudienceInsightsService/GenerateAudienceCompositionInsights)\nmethod, when the `date_month` is not set in the request."]]