條件

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

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

注意： 客戶層級條件只能是排除條件。

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

各層級支援的條件

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

所有等級 廣告活動 廣告群組 客戶

類型	Positive?	排除？	可用的層級	附註
廣告時段	是	否	廣告活動
年齡層	是	是	廣告活動 廣告群組
應用程式付款模式	是	否	廣告群組
觀眾	是	否	廣告群組	請參閱需求開發廣告活動指定目標對象指南。
品牌清單	是	是	廣告活動 廣告群組	在廣告群組層級，只能設定正面指定目標。
電信業者	是	否	廣告活動
合併目標對象	是	否	廣告活動 廣告群組	請參閱 合併目標對象說明中心文章。
內容標籤	否	是	廣告活動 客戶
自訂興趣相似目標對象	是	否	廣告活動 廣告群組	由 CustomInterest 資源定義。如要結合關鍵字、網址和應用程式來建立目標對象區隔，請使用 CustomAudienceInfo，詳情請參閱 自訂目標對象指南。
自訂目標對象	是	否	廣告活動 廣告群組	由 CustomAudience 資源定義。請參閱 自訂目標對象指南。
自訂意願	是	否	廣告群組	由 CustomInterest 資源定義。如要結合關鍵字、網址和應用程式來建立目標對象區隔，請使用 CustomAudienceInfo，詳情請參閱 自訂目標對象指南。
裝置	是	否	廣告活動	將 bid_modifier 設為 0.0，即可選擇不採用裝置類型。如要設定廣告群組層級的裝置出價調整幅度，請使用 AdGroupBidModifier；詳情請參閱出價調節係數指南。
實體出價	是	否	廣告群組	在 v25 以上版本中，使用 VERTICAL_ADS_ITEM_BID 標準類型，為垂直廣告中的旅遊實體 (例如飯店、觀光景點或活動) 設定項目層級出價 (item_code)。
延伸客層	是	是	廣告活動 廣告群組
性別	是	是	廣告活動 廣告群組	最高成效廣告活動也支援廣告活動層級的性別排除條件 (negative = true)。如果嘗試只指定客層維度中的 UNDETERMINED 類別，則會傳回 CriterionError.CANNOT_TARGET_ONLY_UNDETERMINED。如要瞭解 v24 以上版本的人口統計資料驗證規則，請參閱「版本差異」。
收入範圍	是	是	廣告活動 廣告群組
IP 封鎖	否	是	廣告活動 客戶
關鍵字	是	是	廣告活動 廣告群組	在廣告活動層級，您只能排除關鍵字。
關鍵字主題	是	是	廣告活動
語言	是	否	廣告活動 廣告群組	搜尋廣告活動不支援新增或更新語言條件，但可移除現有的廣告活動層級語言條件。詳情請參閱「指定語言條件」。在 v24 以上版本中，嘗試指定不允許的語言會傳回 CriterionError.CANNOT_TARGET_LANGUAGE。
人生大事	是	是	廣告活動 廣告群組
商家資訊群組	是	否	廣告群組	飯店廣告和購物廣告活動的樹狀結構。請參閱購物商家資訊群組指南。
商家資訊範圍	是	否	廣告活動
在地生活服務 ID	是	否	廣告活動	代表在地生活服務廣告活動的服務類型。在 v24 以上版本中，您也可以使用 AssetGroupSignal.local_services_id，在最高成效廣告活動素材資源群組中設定在地生活服務 ID 信號。
位置	是	是	廣告活動 廣告群組	請參閱指定地區指南。在 v24 和更新版本中，從在地生活服務最高成效廣告活動中移除所有地區，會傳回 CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN。
地區群組	是	否	廣告活動	使用距離半徑指定多個地理區域。請參閱指定地區指南。
行動應用程式類別	是	是	廣告活動 廣告群組 客戶
行動應用程式	是	是	廣告活動 廣告群組 客戶
行動裝置	是	否	廣告活動
排除關鍵字清單	否	是	客戶	將ACCOUNT_LEVEL_NEGATIVE_KEYWORDS 共用組合連結至帳戶 (每個帳戶最多一個)。
作業系統版本	是	否	廣告活動
家長狀態	是	是	廣告活動 廣告群組	在廣告活動層級，僅支援排除指定目標。
刊登位置	是	是	廣告活動 廣告群組 客戶	您可以在廣告活動和廣告群組層級，使用自選刊登位置指定目標，並在所有層級排除指定。網址長度 (250 個字元) 和深度 (2 個層級) 限制；不允許使用 adsenseformobileapps.com。
刊登位置清單	否	是	客戶	將NEGATIVE_PLACEMENTS 共用組合連結至帳戶，以便在廣告活動中排除刊登位置。
接近法則	是	否	廣告活動	使用地址或經緯度和半徑建立。請參閱指定地區指南。
零售篩選條件套裝組合	是	是	廣告群組	在 v24 和更新版本 (僅限許可清單帳戶) 中，將RETAIL_FILTER 共用組合連結至廣告群組 (或最高成效廣告活動中的 AssetGroupListingGroupFilter)，以便根據動態代碼篩選產品。
主題	是	是	廣告活動 廣告群組
使用者興趣	是	是	廣告活動 廣告群組	確認 供應情形與廣告活動類型相容。部分使用者興趣選項僅適用於特定廣告活動類型。
使用者名單	是	是	廣告活動 廣告群組	請使用使用者名單的 ID。
產業廣告商品群組規則清單	是	是	廣告群組	將VERTICAL_ADS_ITEM_GROUP_RULE_LIST 共用組合連結至搜尋廣告活動中的廣告群組，並加入旅遊動態饋給 (v24 以上版本中，許可清單帳戶的最高成效廣告活動也支援AssetGroupSignal)。
影片首選頻道	是	是	廣告活動 廣告群組	如果指定無效的首選頻道 ID，系統會傳回 CampaignCriterionError.INVALID_VIDEO_LINEUP_ID。
網頁	是	是	廣告活動 廣告群組	用於根據條件指定或排除廣告主網站上的特定網頁。將 Webpage 條件設為排除，即可用來實作網址排除條件。
網頁清單	否	是	廣告活動	連結WEBPAGES 共用組合，在廣告活動層級排除網頁清單 (不公開)。
YouTube 頻道	是	是	廣告活動 廣告群組 客戶
YouTube 影片	是	是	廣告活動 廣告群組 客戶

版本差異

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

• v26 以上版本：
  • 支援 CampaignCriterion 和 AdGroupCriterion 的 require_eu_political_advertising_declaration，用於判斷條件是否需要廣告活動層級的歐盟政治廣告聲明。
  • 在 AdGroupBidModifier 中使用不限產業的旅遊維度，並在 CriterionError 中使用不限產業的錯誤原因 (取代第 25 版及更早版本中飯店專用的條件和錯誤代碼)。
• v25 以上版本：支援 AdGroupCriterion 的 EntityBid (entity_bid) 條件，條件類型為 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。

目標對象資訊指定條件

您可以使用 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 條件。