CampaignCriterion

廣告活動條件。

JSON 表示法 
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "campaign": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "placement": {
    object (PlacementInfo)
  },
  "mobileAppCategory": {
    object (MobileAppCategoryInfo)
  },
  "mobileApplication": {
    object (MobileApplicationInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "adSchedule": {
    object (AdScheduleInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "incomeRange": {
    object (IncomeRangeInfo)
  },
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "youtubeVideo": {
    object (YouTubeVideoInfo)
  },
  "youtubeChannel": {
    object (YouTubeChannelInfo)
  },
  "proximity": {
    object (ProximityInfo)
  },
  "topic": {
    object (TopicInfo)
  },
  "listingScope": {
    object (ListingScopeInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "ipBlock": {
    object (IpBlockInfo)
  },
  "contentLabel": {
    object (ContentLabelInfo)
  },
  "carrier": {
    object (CarrierInfo)
  },
  "userInterest": {
    object (UserInterestInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "operatingSystemVersion": {
    object (OperatingSystemVersionInfo)
  },
  "mobileDevice": {
    object (MobileDeviceInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  },
  "customAffinity": {
    object (CustomAffinityInfo)
  },
  "customAudience": {
    object (CustomAudienceInfo)
  },
  "combinedAudience": {
    object (CombinedAudienceInfo)
  },
  "keywordTheme": {
    object (KeywordThemeInfo)
  },
  "localServiceId": {
    object (LocalServiceIdInfo)
  },
  "brandList": {
    object (BrandListInfo)
  }
  // End of list of possible types for union field criterion.
}
欄位
resourceName

string

不可變動。廣告活動條件的資源名稱。廣告活動條件資源名稱的格式如下：

customers/{customerId}/campaignCriteria/{campaignId}~{criterionId}
displayName

string

僅供輸出。條件的顯示名稱。

若是變更，系統會忽略此欄位。
type

enum (CriterionType)

僅供輸出。條件的類型。
status

enum (CampaignCriterionStatus)

條件狀態。
campaign

string

不可變動。條件所屬的廣告活動。
criterionId

string (int64 format)

僅供輸出。條件的 ID。

在變更期間，系統會忽略此欄位。
bidModifier

number

符合條件時的出價修飾符。修飾符的範圍必須介於 0.1 至 10.0 之間。大多數可指定的條件類型都支援修飾符。如要停用裝置類型，請輸入 0。
negative

boolean

不可變動。要指定 (false) 或排除 (true) 條件。

聯集欄位 criterion。廣告活動條件。

只能設定一個值。criterion 只能採用下列其中一種設定：
keyword

object (KeywordInfo)

不可變動。關鍵字。
placement

object (PlacementInfo)

不可變動。刊登位置：
mobileAppCategory

object (MobileAppCategoryInfo)

不可變動。行動應用程式類別。
mobileApplication

object (MobileApplicationInfo)

不可變動。行動應用程式。
location

object (LocationInfo)

不可變動。。
device

object (DeviceInfo)

不可變動。
adSchedule

object (AdScheduleInfo)

不可變動。廣告時段。
ageRange

object (AgeRangeInfo)

不可變動。年齡層。
gender

object (GenderInfo)

不可變動。性別。
incomeRange

object (IncomeRangeInfo)

不可變動。收入範圍。
parentalStatus

object (ParentalStatusInfo)

不可變動。家長狀態。
userList

object (UserListInfo)

不可變動。使用者名單。
youtubeVideo

object (YouTubeVideoInfo)

不可變動。YouTube 影片。
youtubeChannel

object (YouTubeChannelInfo)

不可變動。YouTube 頻道。
proximity

object (ProximityInfo)

不可變動。鄰近感應器。
topic

object (TopicInfo)

不可變動。主題。
listingScope

object (ListingScopeInfo)

不可變動。商家資訊範圍。
language

object (LanguageInfo)

不可變動。語言。
ipBlock

object (IpBlockInfo)

不可變動。IpBlock。
contentLabel

object (ContentLabelInfo)

不可變動。內容標籤。
carrier

object (CarrierInfo)

不可變動。電信業者。
userInterest

object (UserInterestInfo)

不可變動。使用者興趣。
webpage

object (WebpageInfo)

不可變動。網頁。
operatingSystemVersion

object (OperatingSystemVersionInfo)

不可變動。那就是作業系統版本
mobileDevice

object (MobileDeviceInfo)

不可變動。行動裝置。
locationGroup

object (LocationGroupInfo)

不可變動。地區群組
customAffinity

object (CustomAffinityInfo)

不可變動。自訂興趣相似目標對象。
customAudience

object (CustomAudienceInfo)

不可變動。自訂目標對象
combinedAudience

object (CombinedAudienceInfo)

不可變動。合併目標對象。
keywordTheme

object (KeywordThemeInfo)

不可變動。智慧廣告活動關鍵字主題。
localServiceId

object (LocalServiceIdInfo)

不可變動。GLS 服務廣告活動條件。
brandList

object (BrandListInfo)

不可變動。品牌清單廣告活動條件。

CampaignCriterionStatus

CampaignCriterion 的可能狀態。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN

這個版本無法得知接收到的值。

這個值僅供回應使用。
ENABLED 廣告活動條件已啟用。
PAUSED 廣告活動條件已暫停。
REMOVED 已移除廣告活動條件。

ListingScopeInfo

商家資訊範圍條件。

JSON 表示法 
{
  "dimensions": [
    {
      object (ListingDimensionInfo)
    }
  ]
}
欄位
dimensions[]

object (ListingDimensionInfo)

廣告活動條件的範圍。

CarrierInfo

代表通訊業者條件。

JSON 表示法 
{
  "carrierConstant": string
}
欄位
carrierConstant

string

電信業者常數資源名稱。

OperatingSystemVersionInfo

代表要指定的作業系統版本。

JSON 表示法 
{
  "operatingSystemVersionConstant": string
}
欄位
operatingSystemVersionConstant

string

作業系統版本常數資源名稱。

MobileDeviceInfo

行動裝置條件。

JSON 表示法 
{
  "mobileDeviceConstant": string
}
欄位
mobileDeviceConstant

string

行動裝置常數資源名稱。

LocationGroupInfo

透過動態饋給或 AssetSet 指定的地點清單周圍的半徑。

JSON 表示法 
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "locationGroupAssetSets": [
    string
  ],
  "feed": string,
  "radius": string,
  "enableCustomerLevelLocationAssetSet": boolean
}
欄位
geoTargetConstants[]

string

指定地理區域常數會限制動態饋給內的地理區域範圍。目前只能使用一個指定地理區域常數。無法對 AssetSet 欄位設定。
radiusUnits

enum (LocationGroupRadiusUnits)

半徑單位。地理目標常數支援英里和公尺。動態饋給項目集和素材資源集支援以毫米和公尺為單位。這是必要項目，必須在 CREATE 作業中設定。
feedItemSets[]

string

已指定 FeedItems 的 FeedItemSets。如果指定多個 ID，系統會指定出現在至少一個組合中的所有項目。這個欄位無法與 GeoTargetConstants 搭配使用。此為選用項目，只能在 CREATE 作業中設定。無法對 AssetSet 欄位設定。
locationGroupAssetSets[]

string

已指定資產的 AssetSet。如果指定多個 ID，系統會指定出現在至少一個組合中的所有項目。這個欄位無法與動態饋給、指定地理區域常數或動態饋給項目集搭配使用。使用素材資源集時，必須指定這個欄位或 enableCustomerLevelLocationAssetSet。兩者無法同時使用。而且只能在 CREATE 作業中設定。
feed

string

指定指定地區的動態饋給。無法對 AssetSet 欄位設定。這是必要項目，必須在 CREATE 作業中設定。
radius

string (int64 format)

指定地區周圍半徑單位的距離。這是必要項目，必須在 CREATE 作業中設定。
enableCustomerLevelLocationAssetSet

boolean

表示使用最新的客戶層級素材資源組合指定目標。與半徑和半徑單位搭配使用。無法與動態饋給、指定地理區域常數或動態饋給項目組合搭配使用。使用素材資源集時，必須指定這個欄位或 locationGroupAssetSet。兩者無法同時使用。而且只能在 CREATE 作業中設定。

LocationGroupRadiusUnits

地區群組中的半徑距離單位 (例如 MILES)

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
METERS 公尺
MILES 英里
MILLI_MILES Milli Miles

LocalServiceIdInfo

在地生活服務廣告服務 ID。代表在地生活服務廣告活動可以指定的服務類型 (例如 install_faucet)。

JSON 表示法 
{
  "serviceId": string
}
欄位
serviceId

string

條件資源名稱。

BrandListInfo

品牌清單條件是用來指定品牌清單。清單會以 SharedSet ID 類型 BRAND_HINT 表示。這種條件可設為指定或排除。

JSON 表示法 
{
  "sharedSet": string
}
欄位
sharedSet

string

品牌清單的共用組合資源名稱。