创建和管理受众群体

Audience 是可重复使用的集合，其中包含有针对性的细分受众群、受众特征定位和排除对象。效果最大化广告系列、需求开发广告系列和应用广告系列支持受众群体定位。如果您想在展示广告系列、搜索广告系列、视频广告系列、酒店广告系列或标准购物广告系列中直接定位细分受众群，请参阅细分受众群。

创建受众群体

使用 AudienceService 创建和更新受众群体。 每个 Audience 都必须具有唯一的名称。这种可重复使用的受众群体允许组合多个受众群体维度：

• 细分受众群
  • 用户名单细分受众群
  • 兴趣相似的细分受众群或有购买意向的细分受众群
  • 人生大事细分受众群
  • 详细受众特征细分受众群
  • 自定义细分受众群 (CustomAudienceSegment)
• 年龄：AgeDimension
• 性别：GenderDimension
• 家庭收入：HouseholdIncomeDimension
• 育儿状况：ParentalStatusDimension

检查 MutateAudienceResult 中的 audience_id

使用 AudienceService.MutateAudiences 创建受众群体时，每个操作都会返回一个 MutateAudienceResult。您可以检查 MutateAudienceResult，通过解析返回的 resource_name 来获取 audience_id；当 response_content_type 设置为 MUTABLE_RESOURCE 时，您可以检查返回的 audience 对象上的可变字段（例如 name）：

# Configure the request to return the mutable resource in the response.
request = googleads_client.get_type("MutateAudiencesRequest")
request.customer_id = customer_id
request.operations = [operation]
request.response_content_type = (
    googleads_client.enums.ResponseContentTypeEnum.MUTABLE_RESOURCE
)

response = audience_service.mutate_audiences(request=request)

for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = audience_service.parse_audience_path(resource_name)[
        "audience_id"
    ]
    print(f"Created audience '{resource_name}' with ID '{audience_id}'.")

    # Access mutable fields on result.audience when MUTABLE_RESOURCE is requested.
    if result.audience.resource_name:
        print(f"Audience name from mutable resource: {result.audience.name}")

检索受众群体

与其他资源一样，您可以使用 GoogleAdsService.SearchStream 检索受众群体的属性。

SELECT
  audience.id,
  audience.resource_name,
  audience.name,
  audience.status,
  audience.description,
  audience.dimensions,
  audience.exclusion_dimension
FROM audience

定位受众群体

根据广告系列类型的不同，可以通过多种方式定位受众群体。

素材资源组信号

效果最大化广告系列使用 AssetGroupSignal 来定位受众群体。请参阅素材资源组信号指南，了解如何使用素材资源组信号定位受众群体。

广告组条件

需求开发广告系列和应用广告系列支持使用 AdGroupCriterion 添加受众群体广告组条件，以定位受众群体或提供受众群体信号。您可以通过在 AdGroupCriterion.audience 上使用 AudienceInfo 条件，将 AudienceInfo.audience 字段 (ad_group_criterion.audience.audience) 设置为受众群体资源名称，在广告组一级定位受众群体。

以下是设置受众群体定位的步骤：

在 AdGroup 中启用受众群体定位

您必须在创建广告组时，通过将 use_audience_grouped 设置为 true，在 AdGroup 中启用受众群体定位。创建广告组后，此设置便无法更改。

这样，您就可以添加包含受众群体的 AdGroupCriterion 了。如果此值未设置为 true，则您后续定位相应受众群体的请求将会失败。

创建 AdGroupCriterion

创建一个 AdGroupCriterion，并将 AdGroupCriterion.audience 中的 AudienceInfo.audience 字段设置为在创建受众群体中创建的受众群体的资源名称。

可选：在 Campaign 中启用受众群体定位

您也可以在创建广告系列时将 use_audience_grouped 设置为 true。如果使用此设置，当您尝试添加会在广告系列一级排除细分受众群和受众特征的条件时，系统会显示错误。

最佳做法

• 使用受众群体来构建角色。如果您想叠加多个细分受众群和人口统计条件来定位特定买家角色，最好在效果最大化广告系列、需求开发广告系列和应用广告系列中使用受众群体。
• 使用细分受众群进行直接定位。对于展示广告系列、搜索广告系列、视频广告系列、酒店广告系列和标准购物广告系列，或者当您只需要定位单个细分受众群（例如再营销名单）时，请使用细分受众群，而不是受众群体。

常见错误

创建或更新 Audience 时，Google Ads API 会验证请求，如果验证失败，则会返回 AudienceError 枚举中的错误。