条件

定位条件可以在三个不同的级别上设置：

• 在广告系列级别。
• 在广告组级别。
• 在客户级别。

并非所有条件类型都可以在所有层级设置；例如，有些条件类型只能在广告系列层级设置。此外，某些条件只能用于排除性定位，而某些条件只能用于肯定定位。

按级别支持的条件

下表介绍了所有条件类型的允许使用情况：

版本差异

在支持的 Google Ads API 版本中，多种条件类型和验证行为有所不同：

• v25 及更高版本：支持 AdGroupCriterion 上具有条件类型 VERTICAL_ADS_ITEM_BID 的 EntityBid (entity_bid) 条件，以便为垂直广告中的旅游实体设置商品级出价。
• v24 及更高版本：
  • 支持 RetailFilterBundle（AdGroupCriterion.retail_filter_bundle 和 AssetGroupListingGroupFilter.Dimension.retail_filter_bundle）和 RetailFilter (SharedCriterion.retail_filter)，用于基于标记过滤产品（仅限已列入许可名单的账号）。
  • 支持 SharedCriterion 中 VerticalAdsItemGroupRuleInfo 上的 user_rating、venue 和 event_participant_display_name 规则维度。
  • 支持效果最大化广告系列素材资源组信号的 AssetGroupSignal.local_services_id 和 AssetGroupSignal.vertical_ads_item_group_rule_list（已列入许可名单）。
  • 尝试排除受众特征维度（AgeRangeInfo、GenderInfo、IncomeRangeInfo 或 ParentalStatusInfo）中的所有目标时，返回 CriterionError.CANNOT_EXCLUDE_ALL_TARGETS。
  • 尝试定位到不允许的语言时，返回 CriterionError.CANNOT_TARGET_LANGUAGE。
  • 尝试从本地生活服务效果最大化广告系列中移除所有地点时返回。 CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN

受众群体信息定位条件

您可以使用 AdGroupCriterion.audience 上的 AudienceInfo 条件在广告组级定位受众群体。将 ad_group_criterion.audience.audience 设置为要定位的 Audience 的资源名称。如需在 AdGroupCriterion 上使用 AudienceInfo 条件，您必须在创建广告组时设置 ad_group.audience_setting.use_audience_grouped = true（此设置一经创建便无法更改）。您还可以在创建广告系列时选择性地设置 campaign.audience_setting.use_audience_grouped = true，以防止在广告系列一级排除细分和受众特征。

检查 MutateAudienceResult 是否存在 audience_id

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

# 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 = 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}")