Audience 是可重复使用的集合，其中包含有针对性的细分受众群、受众特征定位和排除对象。效果最大化广告系列、需求开发广告系列和应用广告系列均支持受众群体定位。如果您想在展示广告系列、搜索广告系列、视频广告系列、酒店广告系列或标准购物广告系列中直接定位细分受众群，请前往细分受众群。
创建受众群体
使用 AudienceService 创建和更新受众群体。每个 Audience 都必须具有唯一的名称。这种可重复使用的受众群体允许组合多个受众群体维度：
- 细分受众群
- 年龄：
AgeDimension - 性别：
GenderDimension - 家庭收入：
HouseholdIncomeDimension - 育儿状况：
ParentalStatusDimension
检查 MutateAudienceResult 中的 audience_id
使用 AudienceService.MutateAudiences 创建受众群体时，每个操作都会返回一个 MutateAudienceResult。您可以检查 MutateAudienceResult 以获取 audience_id，方法是解析返回的 resource_name 或在 response_content_type 设置为 MUTABLE_RESOURCE 时检查可变 audience 对象：
# Inspect MutateAudienceResult to get audience_id
for result in response.results:
resource_name = result.resource_name
# Format: customers/{customer_id}/audiences/{audience_id}
audience_id = resource_name.split("/")[-1]
print(f"Created audience with resource_name '{resource_name}' and audience_id '{audience_id}'.")
# If response_content_type is MUTABLE_RESOURCE, you can access result.audience.id directly:
if result.audience and result.audience.id:
print(f"Audience ID from mutable resource: {result.audience.id}")
您可以使用 AudienceInfo 条件，通过将 AdGroupCriterion 上的 audience 字段设置为受众群体资源名称，在广告组一级定位受众群体。
检索受众群体
与其他资源一样，您可以使用 GoogleAdsService.SearchStream 来检索受众群体的属性。
SELECT
audience.id,
audience.resource_name,
audience.name,
audience.status,
audience.description,
audience.dimensions,
audience.exclusion_dimension
FROM audience
定位受众群体
根据广告系列类型的不同，您可以通过多种方式定位受众群体。
素材资源组信号
效果最大化广告系列使用AssetGroupSignal来定位受众群体。如需了解如何使用素材资源组信号定位受众群体，请参阅素材资源组指南。
广告组条件
需求开发广告系列和应用广告系列支持使用 AdGroupCriterion 添加受众群体广告组条件，以定位受众群体或提供受众群体信号。
以下是设置受众群体定位的步骤：
在 AdGroup 中启用受众群体定位
您必须在创建广告组时通过将 use_audience_grouped 设置为 true，在 AdGroup 中启用受众群体定位。
这样，您就可以添加包含受众群体的 AdGroupCriterion。如果此值未设置为 true，则您后续针对相应受众群体发出的请求将会失败。
创建 AdGroupCriterion
创建 AdGroupCriterion，并将 audience 字段设置为本指南前面部分中创建的受众群体的资源名称。
可选：在广告系列中启用受众群体定位
您可以在创建广告系列时选择将 use_audience_grouped 设置为 true。如果使用此设置，当您尝试添加会在广告系列一级排除细分受众群和受众特征的条件时，系统会显示错误。
最佳做法
- 使用受众群体来构建用户角色。如果您想叠加多个细分受众群和人口统计标准来定位特定买家角色，最好在效果最大化广告系列、需求开发广告系列和应用广告系列中使用受众群体。
- 使用细分受众群进行直接定位。对于展示广告系列、搜索广告系列、视频广告系列、酒店广告系列和标准购物广告系列，或者当您只需要定位单个细分受众群（例如再营销名单）时，请使用细分受众群，而不是受众群体。
常见错误
创建或更新 Audience 时，Google Ads API 会验证请求，如果验证失败，则会返回 AudienceError 枚举中的错误。
AudienceError |
|||||||||
|---|---|---|---|---|---|---|---|---|---|
AUDIENCE_SEGMENT_NOT_FOUND
|
|
||||||||
DIMENSION_INVALID
|
|
||||||||
DUPLICATE_AUDIENCE_SEGMENT
|
|
||||||||
NAME_ALREADY_IN_USE
|
|
||||||||
TOO_MANY_DIMENSIONS_OF_SAME_TYPE
|
|
||||||||
TOO_MANY_SEGMENTS
|
|
||||||||