提供意見
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
欄位說明 單次點擊出價。 類別 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_mobile_urls
欄位說明 所有跨網域重新導向後，可能的最終行動版網址清單。 類別 ATTRIBUTE資料類型 STRING輸入網址 N/A是否可篩選 是 可選取 是 可排序 否 重複 是
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 移除條件，該條件在使用者介面中仍可能顯示為已啟用。舉例來說，廣告活動預設會向所有年齡層的使用者放送，除非您排除特定年齡層。由於這些年齡層符合廣告放送資格，因此使用者介面會將每個年齡範圍顯示為「已啟用」；但由於未新增任何正向條件，因此 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.url_custom_parameters
欄位說明 用於取代 tracking_url_template、final_urls 或 mobile_final_urls 中自訂參數標記的對應清單。 類別 ATTRIBUTE資料類型 MESSAGE輸入網址 google.ads.searchads360.v0.common.CustomParameter是否可篩選 否 可選取 是 可排序 否 重複 是
ad_group_criterion.user_list.user_list
欄位說明 使用者名單資源名稱。 類別 ATTRIBUTE資料類型 RESOURCE_NAME輸入網址 N/A是否可篩選 是 可選取 是 可排序 否 重複 否
ad_group_criterion.webpage.conditions
欄位說明 網頁指定目標的條件或邏輯運算式。評估網頁指定目標時，系統會將網頁指定目標條件清單以 AND 運算子合併。如果條件清單為空白，表示廣告活動網站的所有網頁都會成為指定目標。建立作業必須填寫這個欄位，更新作業則不得填寫。 類別 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
欄位說明 這個參數定義的條件名稱。系統會使用名稱值，識別、排序及篩選這類參數的條件。建立作業必須填寫這個欄位，更新作業則不得填寫。 類別 ATTRIBUTE資料類型 STRING輸入網址 N/A是否可篩選 是 可選取 是 可排序 是 重複 否
提供意見
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權 ，程式碼範例則為阿帕契 2.0 授權 。詳情請參閱《Google Developers 網站政策 》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-11-12 (世界標準時間)。
想進一步說明嗎？
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-11-12 (世界標準時間)。"],[],["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"]]
