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 |
| 是否可篩選 | 是 |
| 可選取 | 是 |
| 可排序 | 是 |
| 重複 | 否 |
|
