廣告活動條件

廣告活動條件。

歸因資源
campaign (廣告活動)
carrier_Constant
客戶
動態饋給
language_常數
mobile_app_category_常數
mobile_device_Constant
Operating_system_version_Constant
topic_常數
user_interest
<使用者清單>

系統會選取上述資源中的欄位,以及 SELECT 和 WHERE 子句中的這項資源。這些欄位不會SELECT 子句中區隔指標。

campaign_criterion.ad_Schedule.day_of_week

欄位說明時間表在星期幾。這是 CREATE 作業的必要欄位,無法用於 UPDATE 作業。
類別ATTRIBUTE
資料類型
輸入網址google.ads.googleads.v10.enums.DayOfWeekEnum.DayOfWeek
可篩選正確
可選取正確
可排序正確
重複錯誤

campaign_criterion.ad_Schedule.end_hour

欄位說明24 小時結束,「24 小時」代表一天結束。此欄位的值必須介於 0 到 24 (含 0 和 24)。這是 CREATE 作業的必要欄位,無法用於 UPDATE 作業。
類別ATTRIBUTE
資料類型INT32
輸入網址N/A
可篩選正確
可選取
可排序正確
重複錯誤

campaign_criterion.ad_Schedule.end_minute

欄位說明此時段結束的結束時間 (分鐘)。時間表不受結束時間的影響。這是 CREATE 作業的必要欄位,無法用於 UPDATE 作業。
類別ATTRIBUTE
資料類型
輸入網址google.ads.googleads.v10.enums.MinuteOfHourEnum.MinuteOfHour
可篩選錯誤
可選取正確
可排序錯誤
重複錯誤

campaign_criterion.ad_Schedule.start_hour

欄位說明開始時間:24 小時。這個欄位的值必須介於 0 到 23 (含 0 和 23)。這是 CREATE 作業的必要欄位,無法用於 UPDATE 作業。
類別ATTRIBUTE
資料類型INT32
輸入網址N/A
可篩選正確
可選取正確
可排序正確
重複錯誤

campaign_criterion.ad_Schedule.start_minute

欄位說明此時段開始的開始時間的分鐘數。這是 CREATE 作業的必要欄位,無法用於 UPDATE 作業。
類別ATTRIBUTE
資料類型
輸入網址google.ads.googleads.v10.enums.MinuteOfHourEnum.MinuteOfHour
可篩選錯誤
可選取
可排序錯誤
重複錯誤

campaign_criterion.age_range.type

欄位說明年齡層類型。
類別ATTRIBUTE
資料類型
輸入網址google.ads.googleads.v10.enums.AgeRangeTypeEnum.AgeRangeType
可篩選
可選取
可排序正確
重複錯誤

campaign_criterion.bid_modifier

欄位說明條件比對時使用的出價修飾符。修飾符必須是介於 0.1 到 10.0 之間的範圍。大部分的可指定條件類型都支援修飾符。使用 0 即可停用裝置類型。
類別ATTRIBUTE
資料類型FLOAT
輸入網址N/A
可篩選
可選取正確
可排序正確
重複錯誤

campaign_criterion.campaign

欄位說明不可變更。條件所屬的廣告活動。
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選
可選取
可排序錯誤
重複錯誤

campaign_criterion.carrier.carrier_Constant

欄位說明行動通訊業者常數資源名稱。
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選
可選取
可排序錯誤
重複錯誤

campaign_criterion.combined_audience.combined_audience

欄位說明合併目標對象資源名稱。
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選正確
可選取
可排序
重複錯誤

campaign_criterion.content_label.type

欄位說明內容標籤類型,建立時必須用於 CREATE 作業。
類別ATTRIBUTE
資料類型
輸入網址google.ads.googleads.v10.enums.ContentLabelTypeEnum.ContentLabelType
可篩選正確
可選取正確
可排序
重複錯誤

campaign_criterion.criterion_id

欄位說明僅供輸出。條件的編號。這個欄位在 DAI 期間會忽略。
類別ATTRIBUTE
資料類型INT64
輸入網址N/A
可篩選
可選取
可排序正確
重複錯誤

廣告活動自訂 ID 興趣相似目標對象

欄位說明CustomInterest 資源名稱。
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選
可選取正確
可排序
重複錯誤

campaign_criterion.custom_audience.custom_audience

欄位說明CustomAudience 資源名稱。
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選正確
可選取正確
可排序
重複錯誤

campaign_criterion.device.type

欄位說明裝置的類型。
類別ATTRIBUTE
資料類型
輸入網址google.ads.googleads.v10.enums.DeviceEnum.Device
可篩選正確
可選取正確
可排序錯誤
重複錯誤

campaign_criterion.display_name (廣告活動名稱)

欄位說明僅供輸出。條件的顯示名稱。系統會對 nofollow 在這個欄位中使用。
類別ATTRIBUTE
資料類型STRING
輸入網址N/A
可篩選正確
可選取正確
可排序正確
重複錯誤

campaign_criterion.gender.type

欄位說明性別類型。
類別ATTRIBUTE
資料類型
輸入網址google.ads.googleads.v10.enums.GenderTypeEnum.GenderType
可篩選
可選取正確
可排序
重複錯誤

campaign_criterion.income_range.type

欄位說明收入範圍的類型。
類別ATTRIBUTE
資料類型
輸入網址google.ads.googleads.v10.enums.IncomeRangeTypeEnum.IncomeRangeType
可篩選
可選取正確
可排序正確
重複錯誤

campaign_criterion.ip_block.ip_address

欄位說明這個 IP 區塊的 IP 位址。
類別ATTRIBUTE
資料類型STRING
輸入網址N/A
可篩選正確
可選取正確
可排序正確
重複錯誤

campaign_criterion.keyword.match_type

欄位說明關鍵字的比對類型。
類別ATTRIBUTE
資料類型
輸入網址google.ads.googleads.v10.enums.KeywordMatchTypeEnum.KeywordMatchType
可篩選
可選取正確
可排序正確
重複錯誤

campaign_criterion.keyword.text

欄位說明關鍵字文字 (最多 80 個字元和 10 個字)。
類別ATTRIBUTE
資料類型STRING
輸入網址N/A
可篩選正確
可選取正確
可排序
重複錯誤

campaign_criterion.keyword_theme.free_form_keyword_theme

欄位說明系統會盡可能將任意形式的文字與智慧廣告活動關鍵字主題保持一致。
類別ATTRIBUTE
資料類型STRING
輸入網址N/A
可篩選
可選取正確
可排序
重複錯誤

campaign_criterion.keyword_theme.keyword_theme_Constant

欄位說明智慧廣告活動關鍵字主題常數資源名稱。keywordThemeConstants/{keyword_theme_id}~{sub_keyword_theme_id}
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選
可選取正確
可排序錯誤
重複錯誤

campaign_criterion.language.language_常數

欄位說明語言常數資源名稱。
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選
可選取
可排序錯誤
重複錯誤

campaign_criterion.listing_scope.dimensions

欄位說明廣告活動條件的範圍。
類別ATTRIBUTE
資料類型MESSAGE
輸入網址google.ads.googleads.v10.common.ListingDimensionInfo
可篩選錯誤
可選取正確
可排序錯誤
重複正確

campaign_criterion.listing_scope.dimensions.hotel_city.city_criterion

欄位說明地理目標常數資源名稱。
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選正確
可選取錯誤
可排序錯誤
重複錯誤

campaign_criterion.listing_scope.dimensions.hotel_country_region.country_region_criterion

欄位說明地理目標常數資源名稱。
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選正確
可選取錯誤
可排序錯誤
重複錯誤

campaign_criterion.listing_scope.dimensions.hotel_state.state_criterion

欄位說明地理目標常數資源名稱。
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選正確
可選取錯誤
可排序錯誤
重複錯誤

campaign_criterion.location.geo_target_常數

欄位說明指定地理區域常數資源名稱。
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選正確
可選取正確
可排序錯誤
重複錯誤

campaign_criterion.location_group

欄位說明不可變更。地區群組
類別ATTRIBUTE
資料類型MESSAGE
輸入網址google.ads.googleads.v10.common.LocationGroupInfo
可篩選錯誤
可選取
可排序錯誤
重複錯誤

campaign_criterion.location_group.feed

欄位說明指定指定地區的動態饋給。此為必要步驟,且必須在 CREATE 作業中設定。
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選正確
可選取正確
可排序錯誤
重複錯誤

campaign_criterion.location_group.geo_target_Constants

欄位說明用來限制動態饋給中地理位置範圍的指定地理區域常數。目前只允許一個地理定位常數。
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選正確
可選取錯誤
可排序錯誤
重複

campaign_criterion.mobile_app_category.mobile_app_category_常數

欄位說明行動應用程式類別常數資源名稱。
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選
可選取正確
可排序錯誤
重複錯誤

campaign_criterion.mobile_application.app_id

欄位說明這個字串可明確識別 Google Ads API 的行動應用程式。這個字串的格式為「{platform}-{platform_native_id}」,其中平台為「1」代表 iOS 應用程式;「2」表示 Android 應用程式;platform_native_id 則是原生平台原生行動應用程式 ID。在 iOS 上,這個原生 ID 是 9 位數字的字串,會顯示在 App Store 網址尾端 (例如““486943146”;用於“Flood-It!2”App Store 連結為「http://itunes.apple.com/tw/app/flood-it!-2/id476943146"」)。在 Android 上,這個原生 ID 是應用程式的套件名稱 (例如「quot;com.labpixies.colordrips"」「Google 連結」的 Google Play 連結「https://play.google.com/store/apps/details?id=com.labpixies.colordrips"」。因此,Google Ads API 格式正確的應用程式編號會是「1-476943146」,適用於 iOS 和「2-com.labpixies.colordrips」(適用於 Android)。此為必填欄位,且必須在 CREATE 作業中設定。
類別ATTRIBUTE
資料類型STRING
輸入網址N/A
可篩選正確
可選取
可排序
重複錯誤

campaign_criterion.mobile_application.name

欄位說明這個行動應用程式的名稱。
類別ATTRIBUTE
資料類型STRING
輸入網址N/A
可篩選正確
可選取
可排序正確
重複錯誤

campaign_criterion.mobile_device.mobile_device_Constant

欄位說明行動裝置的資源名稱。
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選
可選取正確
可排序錯誤
重複錯誤

campaign_criterion.negative

欄位說明不可變更。決定要指定 (false) 還是排除 (true) 條件。
類別ATTRIBUTE
資料類型BOOLEAN
輸入網址N/A
可篩選正確
可選取正確
可排序正確
重複錯誤

廣告活動條件類型

欄位說明作業系統版本常數資源名稱。
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選正確
可選取
可排序錯誤
重複錯誤

campaign_criterion.parental_status.type

欄位說明家長狀態類型。
類別ATTRIBUTE
資料類型
輸入網址google.ads.googleads.v10.enums.ParentalStatusTypeEnum.ParentalStatusType
可篩選正確
可選取
可排序
重複錯誤

campaign_criterion.placement.url

欄位說明刊登位置網址。例如:「http://www.domain.com"」。
類別ATTRIBUTE
資料類型STRING
輸入網址N/A
可篩選正確
可選取
可排序
重複錯誤

campaign_criterion.鄰近.address.city_name

欄位說明市區鄉鎮名稱。
類別ATTRIBUTE
資料類型STRING
輸入網址N/A
可篩選
可選取
可排序
重複錯誤

campaign_criterion.鄰近.address.country_code

欄位說明國家/地區代碼。
類別ATTRIBUTE
資料類型STRING
輸入網址N/A
可篩選
可選取正確
可排序
重複錯誤

campaign_criterion.鄰近.address.postal_code

欄位說明郵遞區號。
類別ATTRIBUTE
資料類型STRING
輸入網址N/A
可篩選正確
可選取正確
可排序正確
重複錯誤

campaign_criterion.鄰近.address.vin_code

欄位說明省或州/省代碼。
類別ATTRIBUTE
資料類型STRING
輸入網址N/A
可篩選正確
可選取
可排序
重複錯誤

campaign_criterion.鄰近.address.vin_name

欄位說明州/省名稱。
類別ATTRIBUTE
資料類型STRING
輸入網址N/A
可篩選
可選取正確
可排序正確
重複錯誤

campaign_criterion.鄰近.address.street_address

欄位說明街道地址第 1 行。
類別ATTRIBUTE
資料類型STRING
輸入網址N/A
可篩選
可選取正確
可排序正確
重複錯誤

廣告活動條件 - 鄰近目標地理區域

欄位說明緯度為微度。
類別ATTRIBUTE
資料類型INT32
輸入網址N/A
可篩選正確
可選取正確
可排序正確
重複錯誤

廣告活動條件 - 鄰近目標地理區域

欄位說明經度 (以度為單位)。
類別ATTRIBUTE
資料類型INT32
輸入網址N/A
可篩選
可選取
可排序正確
重複錯誤

campaign_criterion.鄰近.radius

欄位說明鄰近地區半徑。
類別ATTRIBUTE
資料類型DOUBLE
輸入網址N/A
可篩選正確
可選取
可排序正確
重複錯誤

campaign_criterion.鄰近.radius_units

欄位說明半徑測量單位。預設值為「KILOMETERS」。
類別ATTRIBUTE
資料類型
輸入網址google.ads.googleads.v10.enums.ProximityRadiusUnitsEnum.ProximityRadiusUnits
可篩選正確
可選取正確
可排序
重複錯誤

campaign_criterion.resource_name

欄位說明不可變更。廣告活動條件的資源名稱。廣告活動條件資源名稱的格式如下:customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選正確
可選取
可排序錯誤
重複錯誤

campaign_criterion.status

欄位說明條件的狀態。
類別ATTRIBUTE
資料類型
輸入網址google.ads.googleads.v10.enums.CampaignCriterionStatusEnum.CampaignCriterionStatus
可篩選正確
可選取
可排序正確
重複錯誤

campaign_criterion.topic.path

欄位說明要指定或排除的類別。陣列中的每個後續元素都描述了更明確的子類別。例如,「寵物與動物」、「寵物」、「狗」代表「寵物和動物」/「動物/寵物/狗」類別。
類別ATTRIBUTE
資料類型STRING
輸入網址N/A
可篩選
可選取
可排序錯誤
重複

campaign_criterion.topic.topic_Constant

欄位說明主題常數資源名稱。
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選
可選取正確
可排序錯誤
重複錯誤

campaign_criterion.type

欄位說明僅供輸出。條件的類型。
類別ATTRIBUTE
資料類型
輸入網址google.ads.googleads.v10.enums.CriterionTypeEnum.CriterionType
可篩選正確
可選取
可排序
重複錯誤

campaign_criterion.user_interest.user_interest_category

欄位說明UserInterest 資源名稱。
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選
可選取
可排序錯誤
重複錯誤

campaign_criterion.user_list.user_list

欄位說明使用者名單清單資源名稱。
類別ATTRIBUTE
資料類型RESOURCE_NAME
輸入網址N/A
可篩選正確
可選取正確
可排序錯誤
重複錯誤

campaign_criterion.webpage.conditions

欄位說明網頁指定的條件或邏輯運算式。評估指定條件時,系統會一併列出網頁指定條件的條件清單。這是 CREATE 作業的必要欄位,無法用於 UPDATE 作業。
類別ATTRIBUTE
資料類型MESSAGE
輸入網址google.ads.googleads.v10.common.WebpageConditionInfo
可篩選錯誤
可選取正確
可排序錯誤
重複

campaign_criterion.webpage.coverage_percentage

欄位說明網站標準涵蓋範圍百分比。這是根據網站指定目標、排除網站目標,以及廣告群組和廣告活動中網站排除關鍵字計算而得的網站涵蓋率百分比。舉例來說,當涵蓋範圍傳回 1 時,表示其涵蓋率為 100%。這是唯讀欄位。
類別ATTRIBUTE
資料類型DOUBLE
輸入網址N/A
可篩選
可選取
可排序正確
重複錯誤

campaign_criterion.webpage.criterion_name

欄位說明這項參數所定義的條件名稱。名稱值將用於識別、排序及篩選這類參數的條件。這是 CREATE 作業的必要欄位,無法用於 UPDATE 作業。
類別ATTRIBUTE
資料類型STRING
輸入網址N/A
可篩選
可選取正確
可排序
重複錯誤

campaign_criterion.webpage.sample.sample_urls

欄位說明網頁樣本網址
類別ATTRIBUTE
資料類型STRING
輸入網址N/A
可篩選正確
可選取
可排序錯誤
重複正確

campaign_criterion.youtube_channel.channel_id

欄位說明YouTube 上傳者頻道 ID 或 YouTube 頻道的頻道代碼。
類別ATTRIBUTE
資料類型STRING
輸入網址N/A
可篩選
可選取正確
可排序
重複錯誤

campaign_criterion.youtube_video.video_id

欄位說明YouTube 影片 ID (如 YouTube 觀賞頁面上顯示的 ID)。
類別ATTRIBUTE
資料類型STRING
輸入網址N/A
可篩選
可選取
可排序正確
重複錯誤