條件

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

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

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

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

各層級支援的條件

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

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

類型	正面？	排除？	可用的等級	附註
廣告時段	是	否	廣告活動
年齡層	是	是	廣告活動 廣告群組
應用程式付款模式	是	否	廣告群組
觀眾	是	否	廣告群組	請參閱需求開發廣告活動指定目標對象指南。
品牌清單	是	是	廣告活動 廣告群組	在廣告群組層級，系統只支援指定目標。
電信業者	是	否	廣告活動
合併目標對象	是	否	廣告活動 廣告群組	請參閱 合併目標對象說明中心文章。
內容標籤	否	是	廣告活動 客戶
自訂興趣相似目標對象	是	否	廣告活動 廣告群組	由 CustomInterest 資源定義。如要結合關鍵字、網址和應用程式來建立目標對象區隔，請使用 CustomAudienceInfo，詳情請參閱 自訂目標對象指南。
自訂目標對象	是	否	廣告活動 廣告群組	由 CustomAudience 資源定義。請參閱 自訂目標對象指南。
自訂意願	是	否	廣告群組	由 CustomInterest 資源定義。如要建立結合關鍵字、網址和應用程式的目標對象區隔，請使用 CustomAudienceInfo，詳情請參閱 自訂目標對象指南。
裝置	是	否	廣告活動	將 bid_modifier 設為 0.0，即可選擇不採用裝置類型。用於廣告群組層級的裝置出價調整幅度；請參閱出價調節係數指南。 AdGroupBidModifier
實體出價	是	否	廣告群組	在第 25 版和後續版本中，使用 VERTICAL_ADS_ITEM_BID 條件類型，為垂直廣告中的旅遊實體 (例如飯店、活動或行程) 設定項目層級出價 (item_code)。
延伸客層	是	是	廣告活動 廣告群組
性別	是	是	廣告活動 廣告群組	最高成效廣告活動也支援廣告活動層級的性別排除條件 (negative = true)。如果嘗試在客層維度中只指定 UNDETERMINED 類別，系統會傳回 CriterionError.CANNOT_TARGET_ONLY_UNDETERMINED。如要瞭解 v24 以上版本的人口統計資料驗證規則，請參閱「版本差異」。
收入範圍	是	是	廣告活動 廣告群組
IP 封鎖	否	是	廣告活動 客戶
關鍵字	是	是	廣告活動 廣告群組	在廣告活動層級，您只能排除關鍵字。
關鍵字主題	是	是	廣告活動
語言	是	否	廣告活動 廣告群組	在第 24 版和後續版本中，嘗試指定不允許的語言會傳回 CriterionError.CANNOT_TARGET_LANGUAGE。
人生大事	是	是	廣告活動 廣告群組
商家資訊群組	是	否	廣告群組	飯店廣告和購物廣告活動的樹狀結構。請參閱購物商家資訊群組指南。
商家資訊範圍	是	否	廣告活動
在地生活服務 ID	是	否	廣告活動	代表在地生活服務廣告活動的服務類型。在 v24 以上版本中，您也可以使用 AssetGroupSignal.local_services_id，在最高成效廣告活動素材資源群組中設定在地生活服務 ID 信號。
位置	是	是	廣告活動 廣告群組	請參閱指定地區指南。在第 24 版和後續版本中，從在地生活服務最高成效廣告活動中移除所有地點，會傳回 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 以上版本：
  • 支援 require_eu_political_advertising_declarationCampaignCriterion 和 AdGroupCriterion，判斷條件是否需要廣告活動層級的歐盟政治廣告聲明。
  • 在 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}")