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.engine_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.sssss」格式表示。 |
| 類別 | 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 中「已移除」的條件仍可能在使用者介面中顯示為已啟用。舉例來說，根據預設，廣告活動會向所有年齡層的使用者顯示，除非排除排除範圍。使用者介面會將各個年齡層顯示為「已啟用」，因為它們有資格看到廣告；但是，由於未加入任何正面條件，因此 廣告群組條件.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 |
| 欄位說明 | 用於指定網頁的條件或邏輯運算式。系統在評估指定目標時，會將網頁指定條件清單一併納入考量。如果條件清單空白，表示已指定廣告活動網站的所有網頁。這是 CREATE 作業的必填欄位，不得用於 UPDATE 作業。 |
| 類別 | 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 |
| 是否可篩選 | 是 |
| 可選取 | 是 |
| 可排序 | 是 |
| 重複 | 否 |
|
