创建和管理受众群体

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

创建受众群体

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

检查 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添加受众群体广告组条件，以定位目标受众群体或提供受众群体 信号。您可以在广告组一级定位受众群体，方法是使用 AudienceInfo中的 AdGroupCriterion.audience条件，并将 AudienceInfo.audience字段 (ad_group_criterion.audience.audience)设置为受众群体资源名称。

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

在 AdGroup 中启用受众群体定位

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

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

创建 AdGroupCriterion

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

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

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

最佳做法

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

常见错误

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

AudienceError
AUDIENCE_SEGMENT_NOT_FOUND
摘要 请求中的细分受众群未找到。
常见原因 引用不存在或无法访问的细分受众群 ID。
处理方法 在创建或 更新受众群体之前，请确保所有细分受众群 ID 都存在且可访问。
预防建议 在将细分受众群 ID 添加到受众群体之前，请先验证这些 ID。
DIMENSION_INVALID
摘要 受众群体维度无效。
常见原因 在 exclusion_dimension中添加了detailed_demographic。
处理方法 在 exclusion_dimension中排除对象时，只能使用user_list。
预防建议 在创建或更新受众群体时，请确保 user_list 中仅使用 exclusion_dimension。
DUPLICATE_AUDIENCE_SEGMENT
摘要 受众群体包含重复的细分受众群。
常见原因 将同一细分受众群多次添加到同一受众群体。
处理方法 从受众群体定义中移除重复的细分受众群。
预防建议 确保受众群体中的所有细分受众群都是唯一的。
NAME_ALREADY_IN_USE
摘要 受众群体名称已被使用。
常见原因 尝试创建多个同名的受众群体。
处理方法 创建受众群体时，请使用唯一的名称。
预防建议 在创建新的受众群体名称之前，请先检查是否有现有的受众群体名称。
TOO_MANY_DIMENSIONS_OF_SAME_TYPE
摘要 受众群体包含太多相同类型的维度。
常见原因 在一个受众群体中添加了多个相同类型的维度（例如 多个年龄维度）。
处理方法 确保受众群体定义中每种类型的维度只有一个。
预防建议 检查受众群体定义，确保其中不包含重复的维度 类型。
TOO_MANY_SEGMENTS
摘要 受众群体包含太多细分受众群。
常见原因 受众群体中的细分受众群数量超过了允许的上限。
处理方法 减少受众群体定义中的细分受众群数量。
预防建议 查看文档，了解每个 受众群体中细分受众群数量的限制。
上一页
概览
下一页
细分受众群入门指南