受众群体定位

需求开发广告系列提供其他广告系列类型不支持的独特受众群体定位功能。

例如,您可以使用相似细分受众群来定位与现有客户具有相同特征的用户。如需详细了解相似细分受众群,请参阅帮助中心文章使用相似细分受众群来扩大受众群体。

此外,您还可以使用 AdGroupCriterion在广告组级配置受众群体定位。

AudienceInfo 定位条件

在需求开发广告组中定位受众群体需要执行以下步骤:

  1. 创建目标 AdGroup 时,请将 audience_setting.use_audience_grouped 设置为 true(创建广告组后,此设置将不可变)。您还可以在创建广告系列时选择性地将 campaign.audience_setting.use_audience_grouped 设置为 true,以防止在广告系列一级排除细分和受众特征。
  2. 使用 AudienceService 创建或检索 Audience 资源,并获取其资源名称或 ID。
  3. 创建一个 AdGroupCriterion,其中包含一个 AudienceInfo 条件,该条件的 audience 字段设置为受众群体的资源名称。

检查 MutateAudienceResult 并附加 AudienceInfo

使用 AudienceService.MutateAudiences 创建受众群体时,每个操作都会返回一个 MutateAudienceResult。您可以通过解析返回的 resource_name 来获取 audience_id,并且当 response_content_type 设置为 MUTABLE_RESOURCE 时,您可以检查返回的 audience 对象上的可变字段(例如 name)。然后,将 resource_name 分配给使用 audience_setting.use_audience_grouped 设置为 true 创建的 AdGroup 上的 AdGroupCriterion,并将 AdGroupCriterion 封装在传递给 AdGroupCriterionService.MutateAdGroupCriteria 的 AdGroupCriterionOperation 中:

# Step 1: Inspect MutateAudienceResult to get resource_name and audience_id.
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 with resource_name '{resource_name}' "
        f"and audience_id '{audience_id}'."
    )

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

    # Step 2: Target the audience at the ad group level with AdGroupCriterion.
    # The target AdGroup must have audience_setting.use_audience_grouped = True
    # set when the ad group is created.
    ad_group_criterion_operation = client.get_type("AdGroupCriterionOperation")
    ad_group_criterion = ad_group_criterion_operation.create
    ad_group_criterion.ad_group = ad_group_resource_name
    ad_group_criterion.audience.audience = resource_name

    ad_group_criterion_service = client.get_service("AdGroupCriterionService")
    ad_group_criterion_service.mutate_ad_group_criteria(
        customer_id=customer_id,
        operations=[ad_group_criterion_operation],
    )