ad_group_criterion
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
廣告群組條件。ad_group_criterion 報表只會傳回明確新增至廣告群組的條件。
您可以在 SELECT 和 WHERE 子句中，選取上述資源和這項資源的欄位。這些欄位不會區隔 SELECT 子句中的指標。
ad_group_criterion.ad_group
欄位說明 條件所屬的廣告群組。 類別 ATTRIBUTE資料類型 RESOURCE_NAME輸入網址 N/A是否可篩選 是 可選取 是 可排序 否 重複 否
ad_group_criterion.age_range.type
欄位說明 年齡層類型。 類別 ATTRIBUTE資料類型
ENUM
AGE_RANGE_18_24
AGE_RANGE_25_34
AGE_RANGE_35_44
AGE_RANGE_45_54
AGE_RANGE_55_64
AGE_RANGE_65_UP
AGE_RANGE_UNDETERMINED
UNKNOWN
UNSPECIFIED
輸入網址 google.ads.searchads360.v0.enums.AgeRangeTypeEnum.AgeRangeType是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.bid_modifier
欄位說明 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定的條件類型都支援調節項。 類別 ATTRIBUTE資料類型 DOUBLE輸入網址 N/A是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.cpc_bid_micros
欄位說明 單次點擊出價 (CPC)。 類別 ATTRIBUTE資料類型 INT64輸入網址 N/A是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.creation_time
欄位說明 這個廣告群組條件建立時的時間戳記。時間戳記以客戶的時區和「yyyy-MM-dd HH:mm:ss」格式表示。 類別 ATTRIBUTE資料類型 DATE輸入網址 N/A是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.criterion_id
欄位說明 指定條件的 ID。 類別 ATTRIBUTE資料類型 INT64輸入網址 N/A是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.effective_cpc_bid_micros
欄位說明 有效單次點擊出價。 類別 ATTRIBUTE資料類型 INT64輸入網址 N/A是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.effective_labels
欄位說明 附加至此廣告群組條件的有效標籤資源名稱。有效標籤是指沿用或直接指派給這項廣告群組條件的標籤。 類別 ATTRIBUTE資料類型 RESOURCE_NAME輸入網址 N/A是否可篩選 是 可選取 是 可排序 否 重複 是
ad_group_criterion.engine_id
欄位說明 外部引擎帳戶中的廣告群組條件 ID。這個欄位僅適用於非 Google Ads 帳戶，例如 Yahoo! Japan、Microsoft、百度等。如果是 Google Ads 實體，請改用「ad_group_criterion.criterion_id」。 類別 ATTRIBUTE資料類型 STRING輸入網址 N/A是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.engine_status
欄位說明 廣告群組條件的引擎狀態。 類別 ATTRIBUTE資料類型
ENUM
AD_GROUP_CRITERION_ACCOUNT_PAUSED
AD_GROUP_CRITERION_APPROVED
AD_GROUP_CRITERION_DISAPPROVED
AD_GROUP_CRITERION_ELIGIBLE
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN
AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH
AD_GROUP_CRITERION_INVALID_PC_SEARCH
AD_GROUP_CRITERION_INVALID_SEARCH
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW
AD_GROUP_CRITERION_NOT_REVIEWED
AD_GROUP_CRITERION_ON_HOLD
AD_GROUP_CRITERION_PARTIALLY_INVALID
AD_GROUP_CRITERION_PAUSED
AD_GROUP_CRITERION_PENDING_REVIEW
AD_GROUP_CRITERION_REMOVED
AD_GROUP_CRITERION_SERVING
AD_GROUP_CRITERION_TO_BE_ACTIVATED
AD_GROUP_CRITERION_UNDER_REVIEW
UNKNOWN
UNSPECIFIED
輸入網址 google.ads.searchads360.v0.enums.AdGroupCriterionEngineStatusEnum.AdGroupCriterionEngineStatus是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.final_url_suffix
欄位說明 用於在最終到達網址中附加參數的網址範本。 類別 ATTRIBUTE資料類型 STRING輸入網址 N/A是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.final_urls
欄位說明 廣告完成所有跨網域重新導向後，可能會導向的最終到達網址清單。 類別 ATTRIBUTE資料類型 STRING輸入網址 N/A是否可篩選 是 可選取 是 可排序 否 重複 是
ad_group_criterion.gender.type
欄位說明 性別類型。 類別 ATTRIBUTE資料類型
ENUM
FEMALE
MALE
UNDETERMINED
UNKNOWN
UNSPECIFIED
輸入網址 google.ads.searchads360.v0.enums.GenderTypeEnum.GenderType是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.keyword.match_type
欄位說明 關鍵字的比對類型。 類別 ATTRIBUTE資料類型
ENUM
BROAD
EXACT
PHRASE
UNKNOWN
UNSPECIFIED
輸入網址 google.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchType是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.keyword.text
欄位說明 關鍵字文字 (最多 80 個字元，最多 10 個字詞)。 類別 ATTRIBUTE資料類型 STRING輸入網址 N/A是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.labels
欄位說明 附加至這個廣告群組條件的標籤資源名稱。 類別 ATTRIBUTE資料類型 RESOURCE_NAME輸入網址 N/A是否可篩選 是 可選取 是 可排序 否 重複 是
ad_group_criterion.last_modified_time
欄位說明 上次修改此廣告群組條件的日期。日期時間以客戶的時區和「yyyy-MM-dd HH:mm:ss.ssssss」格式表示。 類別 ATTRIBUTE資料類型 DATE輸入網址 N/A是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.listing_group.type
欄位說明 商家資訊群組的類型。 類別 ATTRIBUTE資料類型
ENUM
SUBDIVISION
UNIT
UNKNOWN
UNSPECIFIED
輸入網址 google.ads.searchads360.v0.enums.ListingGroupTypeEnum.ListingGroupType是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.location.geo_target_constant
欄位說明 地理區域目標常數資源名稱。 類別 ATTRIBUTE資料類型 RESOURCE_NAME輸入網址 N/A是否可篩選 是 可選取 是 可排序 否 重複 否
ad_group_criterion.negative
欄位說明 要指定 (false) 或排除 (true) 條件。這個欄位無法變更。如要將準則從正面轉為反面，請先移除再重新新增。 類別 ATTRIBUTE資料類型 BOOLEAN輸入網址 N/A是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.position_estimates.top_of_page_cpc_micros
欄位說明 預估單次點擊出價，可讓廣告顯示在搜尋結果第一頁的頂端。 類別 ATTRIBUTE資料類型 INT64輸入網址 N/A是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.quality_info.quality_score
欄位說明 品質分數。如果 Google 沒有足夠的資訊來判斷值，就不會填入這個欄位。 類別 ATTRIBUTE資料類型 INT32輸入網址 N/A是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.resource_name
欄位說明 廣告群組條件的資源名稱。廣告群組條件資源名稱的格式為：customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id} 類別 ATTRIBUTE資料類型 RESOURCE_NAME輸入網址 N/A是否可篩選 是 可選取 是 可排序 否 重複 否
ad_group_criterion.status
欄位說明 條件的狀態。這是由客戶設定的廣告群組條件實體狀態。注意：使用者介面報表可能會納入額外資訊，影響條件是否符合執行資格。在某些情況下，API 中已移除的條件仍可能會在 UI 中顯示為已啟用。舉例來說，廣告活動預設會向所有年齡層的使用者放送，除非您排除特定年齡層。在使用者介面上，每個年齡層都會顯示為「已啟用」，因為他們有資格看到廣告；但 AdGroupCriterion.status 則會顯示「已移除」，因為未加入任何正面條件。 類別 ATTRIBUTE資料類型
ENUM
ENABLED
PAUSED
REMOVED
UNKNOWN
UNSPECIFIED
輸入網址 google.ads.searchads360.v0.enums.AdGroupCriterionStatusEnum.AdGroupCriterionStatus是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.tracking_url_template
欄位說明 用於建構追蹤網址的網址範本。 類別 ATTRIBUTE資料類型 STRING輸入網址 N/A是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.type
欄位說明 條件類型。 類別 ATTRIBUTE資料類型
ENUM
AD_SCHEDULE
AGE_RANGE
APP_PAYMENT_MODEL
AUDIENCE
BRAND
BRAND_LIST
CARRIER
COMBINED_AUDIENCE
CONTENT_LABEL
CUSTOM_AFFINITY
CUSTOM_AUDIENCE
CUSTOM_INTENT
DEVICE
GENDER
INCOME_RANGE
IP_BLOCK
KEYWORD
KEYWORD_THEME
LANGUAGE
LIFE_EVENT
LISTING_GROUP
LISTING_SCOPE
LOCAL_SERVICE_ID
LOCATION
LOCATION_GROUP
MOBILE_APPLICATION
MOBILE_APP_CATEGORY
MOBILE_DEVICE
OPERATING_SYSTEM_VERSION
PARENTAL_STATUS
PLACEMENT
PROXIMITY
TOPIC
UNKNOWN
UNSPECIFIED
USER_INTEREST
USER_LIST
WEBPAGE
YOUTUBE_CHANNEL
YOUTUBE_VIDEO
輸入網址 google.ads.searchads360.v0.enums.CriterionTypeEnum.CriterionType是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.user_list.user_list
欄位說明 使用者清單資源名稱。 類別 ATTRIBUTE資料類型 RESOURCE_NAME輸入網址 N/A是否可篩選 是 可選取 是 可排序 否 重複 否
ad_group_criterion.webpage.conditions
欄位說明 指定網頁的條件或邏輯運算式。評估指定目標時，系統會將網頁指定條件清單以「且」運算結合。如果條件清單為空白，表示系統會指定廣告活動網站的所有網頁。這個欄位是建立作業的必要欄位，但禁止在更新作業中使用。 類別 ATTRIBUTE資料類型 MESSAGE輸入網址 google.ads.searchads360.v0.common.WebpageConditionInfo是否可篩選 否 可選取 是 可排序 否 重複 是
ad_group_criterion.webpage.coverage_percentage
欄位說明 網站條件涵蓋率百分比。根據廣告群組和廣告活動中的網站指定目標、排除網站目標和排除關鍵字，計算出的網站涵蓋範圍所佔的百分比。舉例來說，如果涵蓋率傳回值為 1，表示涵蓋率為 100%。這是唯讀欄位。 類別 ATTRIBUTE資料類型 DOUBLE輸入網址 N/A是否可篩選 是 可選取 是 可排序 是 重複 否
ad_group_criterion.webpage.criterion_name
欄位說明 由此參數定義的條件名稱。名稱值會用於識別、排序及篩選這類參數的條件。這個欄位必須用於 CREATE 作業，而且無法用於 UPDATE 作業。 類別 ATTRIBUTE資料類型 STRING輸入網址 N/A是否可篩選 是 可選取 是 可排序 是 重複 否
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權 ，程式碼範例則為阿帕契 2.0 授權 。詳情請參閱《Google Developers 網站政策 》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-08-29 (世界標準時間)。
[null,null,["上次更新時間：2025-08-29 (世界標準時間)。"],[[["\u003cp\u003eThe Ad Group Criterion report provides insights into the performance, targeting settings, and status of explicitly added criteria within ad groups.\u003c/p\u003e\n"],["\u003cp\u003eIt covers a wide range of criterion types, including age range, gender, keywords, locations, and more, each with specific attributes.\u003c/p\u003e\n"],["\u003cp\u003eThe report includes fields for bidding, performance metrics, URLs, tracking, status, and relationships to other resources like the ad group and campaign.\u003c/p\u003e\n"],["\u003cp\u003eIt's important to note that the report only includes explicitly added criteria and might not reflect all information available in the UI.\u003c/p\u003e\n"],["\u003cp\u003eAdvertisers can utilize the report's data structure and field descriptions to analyze and optimize ad group criteria for improved campaign performance.\u003c/p\u003e\n"]]],["Ad group criteria are targeting methods added to ad groups, with attributes like `ad_group`, `campaign`, and `customer`. Key actions include defining conditions, setting `bid_modifier` and `cpc_bid_micros`, and specifying criteria types like `AGE_RANGE` or `KEYWORD`. Attributes define criterion details, like match types, text, status, and URLs. The data allows for filtering, selecting, and sorting across various fields and can specify if criteria target or exclude. Additional elements include the `user_list` and webpage targeting information.\n"],null,[]]
