條件

指定條件可設在三種不同的層級：

• 在廣告活動層級。
• 廣告群組層級。
• 客戶層級。

並非所有條件類型都可以在所有層級設定，例如部分條件只能在廣告活動層級設定。此外，部分條件只能用於排除指定目標，部分則只能用於指定目標。

各層級支援的條件

下表說明所有條件類型的允許用途：

版本差異

支援的 Google Ads API 版本之間，有幾種條件類型和驗證行為不同：

• 第 25 版和後續版本：支援 EntityBid (entity_bid) AdGroupCriterion 上的條件，並使用條件類型 VERTICAL_ADS_ITEM_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 。

指定目標對象資訊的條件

您可以在廣告群組層級使用 AudienceInfo 條件指定目標對象 AdGroupCriterion.audience。將 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}")