条件

定位条件可在三个不同级别进行设置：

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

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

按级别支持的条件

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

版本差异

在受支持的 Google Ads API 版本中，有几种条件类型和验证行为存在差异：

• v26 及更高版本：
  • 支持 CampaignCriterion 和 AdGroupCriterion 上的 require_eu_political_advertising_declaration，以确定某个条件是否需要广告系列级欧盟政治广告声明。
  • 在 AdGroupBidModifier 中使用与行业无关的旅行维度，在 CriterionError 中使用与行业无关的错误原因（取代 v25 及更早版本中酒店特有的条件和错误代码）。
• v25 及更高版本：支持在 AdGroupCriterion 上使用 EntityBid (entity_bid) 条件（条件类型为 VERTICAL_ADS_ITEM_BID），以便为 Vertical Ads 中的旅游实体设置商品级出价。
• 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”

使用 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}")

语言定位条件

您可以在广告系列级 (CampaignCriterion.language) 或广告组级 (AdGroupCriterion.language) 使用 LanguageInfo 条件，通过将 language_constant 设置为可定位的 LanguageConstant 资源名称（格式为 languageConstants/{criterion_id}；请参阅支持的语言代码），来定位语言。在 v24 及更高版本中，尝试定位到不允许或无法定位的语言会返回 CriterionError.CANNOT_TARGET_LANGUAGE。

对LanguageInfo的支持取决于广告系列类型：

• 支持的广告系列类型：您可以在符合条件的广告系列类型中定位目标语言，例如展示广告系列、视频广告系列、效果最大化广告系列（广告系列级；适用于非搜索渠道）、应用广告系列（广告系列级）和需求开发广告系列（默认情况下为广告组级，或广告系列级，具体取决于 DemandGenCampaignSettings.upgraded_targeting）。
• 搜索广告系列 (AdvertisingChannelType.SEARCH)、AI Max 搜索广告系列以及在 Google 搜索上投放的效果最大化广告系列：不支持手动语言定位。相反，在 Google 搜索上展示的广告会根据广告素材和着陆页的语言以及用户的语言偏好设置，自动匹配用户：
  • 创建或更新条件：尝试在搜索广告系列中创建或更新 LanguageInfo 条件会失败，并显示 ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT 错误。
  • 查询和移除旧版条件：搜索广告系列中的现有 CampaignCriterion.language 条件仍会在查询响应中返回，即使它们不用于广告投放。虽然 Google Ads 界面不提供搜索广告系列的语言定位字段，但您可以使用 CampaignCriterionService 移除旧版 CampaignCriterion.language 条件。

关键字条件限制和有效字符

创建关键字条件 (AdGroupCriterion.keyword)、广告系列否定关键字 (CampaignCriterion.keyword) 或规划关键字（KeywordPlanAdGroupKeyword、KeywordSeed）时：

• 长度限制：关键字文字不得超过 80 个字符和 255 个 UTF-8 字节。如果超出这些限制，则系统会返回 CriterionError.KEYWORD_TEXT_TOO_LONG 错误。
• 字数：一个关键字词组最多可包含 10 个字词，字词之间用空格分隔。如果超出此限制，则系统会返回 CriterionError.KEYWORD_HAS_TOO_MANY_WORDS 错误。
• 字母和数字：所有受支持语言（包括拉丁语、希腊语、西里尔语、阿拉伯语、希伯来语、中日韩汉字、平假名、片假名和韩文）中的字母、数字、变音符号或重音符号以及连接标点符号 (_) 都是有效的 Unicode 标识符字符，可以使用。
• 允许使用的标点和符号：除了字母数字字符外，还允许使用以下标点和符号：
  • 标准符号：空格、#、$、&、-、"、[、]、'、+、.、/、:、€ 和 £。
  • 全角变体：表意空格 (\u3000)、间隔号 (\u00b7)、片假名间隔号 (\u30fb)、全角和号 (\uff06) 和全角加号 (\uff0b)。
  • 星号 (*) 只能用于否定关键字。
• 不允许使用的字符：标点和符号，例如 @、%、^、!、(、)、=、{、}、;、~、`、<、>、?、\`, and|, mathematical symbols (such as the multiplication sign×), and 4-byte Unicode characters (such as emoji in positive keywords) trigger a [CriterionError.KEYWORD_HAS_INVALID_CHARS`]err-kw-invalid-chars 错误。

如需详细了解 Google Ads 在广告投放期间如何处理特定标点和符号，请参阅在关键字中使用符号帮助中心文章。