REST Resource: targetingTypes.targetingOptions

資源:TargetOption

代表單一指定目標選項,這是 DV360 中可供指定的概念。

JSON 表示法
{
  "name": string,
  "targetingOptionId": string,
  "targetingType": enum (TargetingType),

  // Union field details can be only one of the following:
  "digitalContentLabelDetails": {
    object (DigitalContentLabelTargetingOptionDetails)
  },
  "sensitiveCategoryDetails": {
    object (SensitiveCategoryTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
欄位
name

string

僅供輸出。這個指定目標選項的資源名稱。

targetingOptionId

string

僅供輸出。這個指定目標選項的專屬 ID。元組 {targetingTypetargetingOptionId} 不得重複。

targetingType

enum (TargetingType)

僅供輸出。這個指定目標選項的類型。

聯集欄位 details。指定目標選項的詳細資訊。您只能填寫詳細資料中的一個欄位,且這個欄位必須對應 targeting_typedetails 只能採用下列其中一種設定:
digitalContentLabelDetails

object (DigitalContentLabelTargetingOptionDetails)

數位內容標籤詳細資料。

sensitiveCategoryDetails

object (SensitiveCategoryTargetingOptionDetails)

敏感類別詳細資料。

appCategoryDetails

object (AppCategoryTargetingOptionDetails)

應用程式類別詳細資料。

onScreenPositionDetails

object (OnScreenPositionTargetingOptionDetails)

畫面上位置詳細資料。

contentOutstreamPositionDetails

object (ContentOutstreamPositionTargetingOptionDetails)

內容串流外位置詳細資料。

contentInstreamPositionDetails

object (ContentInstreamPositionTargetingOptionDetails)

內容串流內廣告位置詳細資料。

videoPlayerSizeDetails

object (VideoPlayerSizeTargetingOptionDetails)

影片播放器大小詳細資料。

ageRangeDetails

object (AgeRangeTargetingOptionDetails)

年齡層詳細資料。

parentalStatusDetails

object (ParentalStatusTargetingOptionDetails)

家長狀態詳細資料。

userRewardedContentDetails

object (UserRewardedContentTargetingOptionDetails)

使用者獎勵內容詳細資料。

householdIncomeDetails

object (HouseholdIncomeTargetingOptionDetails)

家庭收入詳細資料。

genderDetails

object (GenderTargetingOptionDetails)

性別詳細資料。

deviceTypeDetails

object (DeviceTypeTargetingOptionDetails)

裝置類型詳細資料。

browserDetails

object (BrowserTargetingOptionDetails)

瀏覽器詳細資料。

carrierAndIspDetails

object (CarrierAndIspTargetingOptionDetails)

電信業者和網際網路服務供應商 (ISP) 的詳細資料。

environmentDetails

object (EnvironmentTargetingOptionDetails)

環境詳細資料。

operatingSystemDetails

object (OperatingSystemTargetingOptionDetails)

作業系統資源詳細資料。

deviceMakeModelDetails

object (DeviceMakeModelTargetingOptionDetails)

裝置廠牌和型號資源詳細資料。

viewabilityDetails

object (ViewabilityTargetingOptionDetails)

可視度資源詳細資料。

categoryDetails

object (CategoryTargetingOptionDetails)

類別資源詳細資料。

languageDetails

object (LanguageTargetingOptionDetails)

語言資源詳細資料。

authorizedSellerStatusDetails

object (AuthorizedSellerStatusTargetingOptionDetails)

授權賣方狀態資源詳細資料。

geoRegionDetails

object (GeoRegionTargetingOptionDetails)

地理區域資源詳細資料。

exchangeDetails

object (ExchangeTargetingOptionDetails)

交換詳細資料。

subExchangeDetails

object (SubExchangeTargetingOptionDetails)

子廣告交易平台詳細資料。

poiDetails

object (PoiTargetingOptionDetails)

搜尋點資源詳細資料。

businessChainDetails

object (BusinessChainTargetingOptionDetails)

業務鏈資源詳細資料。

contentDurationDetails

object (ContentDurationTargetingOptionDetails)

內容時間長度資源詳細資料。

contentStreamTypeDetails

object (ContentStreamTypeTargetingOptionDetails)

內容串流類型資源詳細資料。

nativeContentPositionDetails

object (NativeContentPositionTargetingOptionDetails)

原生內容位置詳細資料。

omidDetails

object (OmidTargetingOptionDetails)

已啟用 Open Measurement 的廣告空間詳細資料。

audioContentTypeDetails

object (AudioContentTypeTargetingOptionDetails)

音訊內容類型詳細資料。

contentGenreDetails

object (ContentGenreTargetingOptionDetails)

內容類型資源詳細資料。

DigitalContentLabelTargetingOptionDetails

代表可指定的數位內容標籤分級等級。當 targetingTypeTARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION 時,系統會在 TargetingOption 的 digitalContentLabelDetails 欄位中填入此資訊。

JSON 表示法
{
  "contentRatingTier": enum (ContentRatingTier)
}
欄位
contentRatingTier

enum (ContentRatingTier)

僅供輸出。內容標籤品牌安全等級的列舉。

SensitiveCategoryTargetingOptionDetails

代表可指定的敏感類別。當 targetingTypeTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION 時,系統會在 TargetingOption 的 sensitiveCategoryDetails 欄位中填入此資訊。

JSON 表示法
{
  "sensitiveCategory": enum (SensitiveCategory)
}
欄位
sensitiveCategory

enum (SensitiveCategory)

僅供輸出。DV360 敏感類別敏感內容分類的列舉。

AppCategoryTargetingOptionDetails

代表一組可指定的應用程式。集合可讓您指定由平台維護的相關動態應用程式群組,例如 All Apps/Google Play/Games。當 targetingTypeTARGETING_TYPE_APP_CATEGORY 時,appCategoryDetails 欄位就會填入此欄位。

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

string

僅供輸出。應用程式集合的名稱。

OnScreenPositionTargetingOptionDetails

代表可指定的畫面位置,可由多媒體廣告和影片廣告使用。當 targetingTypeTARGETING_TYPE_ON_SCREEN_POSITION 時,onScreenPositionDetails 欄位就會填入此欄位。

JSON 表示法
{
  "onScreenPosition": enum (OnScreenPosition)
}
欄位
onScreenPosition

enum (OnScreenPosition)

僅供輸出。螢幕上的位置。

ContentOutstreamPositionTargetingOptionDetails

代表可指定內容串流外位置,可用於多媒體廣告和影片廣告。當 targetingTypeTARGETING_TYPE_CONTENT_OUTSTREAM_POSITION 時,contentOutstreamPositionDetails 欄位就會填入此欄位。

JSON 表示法
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition)
}
欄位
contentOutstreamPosition

enum (ContentOutstreamPosition)

僅供輸出。內容串流外位置。

ContentInstreamPositionTargetingOptionDetails

代表可指定內容串流內位置,可用於影片和音訊廣告。當 targetingTypeTARGETING_TYPE_CONTENT_INSTREAM_POSITION 時,contentInstreamPositionDetails 欄位就會填入此欄位。

JSON 表示法
{
  "contentInstreamPosition": enum (ContentInstreamPosition)
}
欄位
contentInstreamPosition

enum (ContentInstreamPosition)

僅供輸出。內容串流內位置。

VideoPlayerSizeTargetingOptionDetails

代表可指定的影片播放器大小。當 targetingTypeTARGETING_TYPE_VIDEO_PLAYER_SIZE 時,videoPlayerSizeDetails 欄位就會填入此欄位。

JSON 表示法
{
  "videoPlayerSize": enum (VideoPlayerSize)
}
欄位
videoPlayerSize

enum (VideoPlayerSize)

僅供輸出。影片播放器的大小。

AgeRangeTargetingOptionDetails

代表可指定的年齡層。當 targetingTypeTARGETING_TYPE_AGE_RANGE 時,ageRangeDetails 欄位就會填入此欄位。

JSON 表示法
{
  "ageRange": enum (AgeRange)
}
欄位
ageRange

enum (AgeRange)

僅供輸出。目標對象的年齡層,

ParentalStatusTargetingOptionDetails

代表可指定的家長狀態。當 targetingTypeTARGETING_TYPE_PARENTAL_STATUS 時,系統會在 TargetingOption 的 parentalStatusDetails 欄位中填入這項資訊。

JSON 表示法
{
  "parentalStatus": enum (ParentalStatus)
}
欄位
parentalStatus

enum (ParentalStatus)

僅供輸出。目標對象的家長狀態,

UserRewardedContentTargetingOptionDetails

代表影片廣告的可指定使用者獎勵內容狀態。當 targetingTypeTARGETING_TYPE_USER_REWARDED_CONTENT 時,userRewardedContentDetails 欄位就會填入此欄位。

JSON 表示法
{
  "userRewardedContent": enum (UserRewardedContent)
}
欄位
userRewardedContent

enum (UserRewardedContent)

僅供輸出。影片廣告的使用者獎勵內容狀態。

HouseholdIncomeTargetingOptionDetails

代表可指定的家庭收入。當 targetingTypeTARGETING_TYPE_HOUSEHOLD_INCOME 時,系統會在 TargetingOption 的 householdIncomeDetails 欄位中填入這項資訊。

JSON 表示法
{
  "householdIncome": enum (HouseholdIncome)
}
欄位
householdIncome

enum (HouseholdIncome)

僅供輸出。目標對象的家庭收入。

GenderTargetingOptionDetails

代表可指定的性別。當 targetingTypeTARGETING_TYPE_GENDER 時,系統會在 TargetingOption 的 genderDetails 欄位中填入這項資訊。

JSON 表示法
{
  "gender": enum (Gender)
}
欄位
gender

enum (Gender)

僅供輸出。目標對象的性別。

DeviceTypeTargetingOptionDetails

代表可指定的裝置類型。當 targetingTypeTARGETING_TYPE_DEVICE_TYPE 時,系統會在 TargetingOption 的 deviceTypeDetails 欄位中填入這項資訊。

JSON 表示法
{
  "deviceType": enum (DeviceType)
}
欄位
deviceType

enum (DeviceType)

僅供輸出。指定的裝置類型。

BrowserTargetingOptionDetails

代表可指定的瀏覽器。當 targetingTypeTARGETING_TYPE_BROWSER 時,browserDetails 欄位就會填入此欄位。

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

string

僅供輸出。瀏覽器的顯示名稱。

CarrierAndIspTargetingOptionDetails

代表指定的電信業者或網際網路服務供應商 (ISP)。當 targetingTypeTARGETING_TYPE_CARRIER_AND_ISP 時,系統會在 TargetingOption 的 carrierAndIspDetails 欄位中填入這項資訊。

JSON 表示法
{
  "displayName": string,
  "type": enum (CarrierAndIspType)
}
欄位
displayName

string

僅供輸出。電信業者或網際網路服務供應商 (ISP) 的顯示名稱。

type

enum (CarrierAndIspType)

僅供輸出。指明為電信業者或網際網路服務供應商 (ISP) 的類型。

CarrierAndIspType

CarrierAndIsp 指定目標選項的類型。

列舉
CARRIER_AND_ISP_TYPE_UNSPECIFIED 未指定類型,或此版本不含類型時的預設值。
CARRIER_AND_ISP_TYPE_ISP 表示這項指定資源參照了網際網路服務供應商 (ISP)。
CARRIER_AND_ISP_TYPE_CARRIER 表示這項指定資源參照行動電信業者。

EnvironmentTargetingOptionDetails

代表可指定的環境。當 targetingTypeTARGETING_TYPE_ENVIRONMENT 時,系統會在 TargetingOption 的 environmentDetails 欄位中填入這項資訊。

JSON 表示法
{
  "environment": enum (Environment)
}
欄位
environment

enum (Environment)

僅供輸出。放送環境。

OperatingSystemTargetingOptionDetails

代表可供指定的作業系統。當 targetingTypeTARGETING_TYPE_OPERATING_SYSTEM 時,系統會在 TargetingOption 的 operatingSystemDetails 欄位中填入這項資訊。

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

string

僅供輸出。作業系統的顯示名稱。

DeviceMakeModelTargetingOptionDetails

代表可供指定的裝置廠牌和型號。當 targetingTypeTARGETING_TYPE_DEVICE_MAKE_MODEL 時,系統會在 TargetingOption 的 deviceMakeModelDetails 欄位中填入這項資訊。

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

string

僅供輸出。裝置廠牌和型號的顯示名稱。

ViewabilityTargetingOptionDetails

代表可供指定的可視度。當 targetingTypeTARGETING_TYPE_VIEWABILITY 時,系統會在 TargetingOption 的 viewabilityDetails 欄位中填入這項資訊。

JSON 表示法
{
  "viewability": enum (Viewability)
}
欄位
viewability

enum (Viewability)

僅供輸出。預測的可視度百分比。

CategoryTargetingOptionDetails

代表可指定的類別。當 targetingTypeTARGETING_TYPE_CATEGORY 時,系統會在 TargetingOption 的 categoryDetails 欄位中填入這項資訊。

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

string

僅供輸出。類別的顯示名稱。

LanguageTargetingOptionDetails

代表可指定的語言。當 targetingTypeTARGETING_TYPE_LANGUAGE 時,languageDetails 欄位就會填入此欄位。

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

string

僅供輸出。語言的顯示名稱 (例如「法文」)。

AuthorizedSellerStatusTargetingOptionDetails

代表可指定的授權賣方狀態。當 targetingTypeTARGETING_TYPE_AUTHORIZED_SELLER_STATUS 時,authorizedSellerStatusDetails 欄位就會填入此欄位。

JSON 表示法
{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus)
}
欄位
authorizedSellerStatus

enum (AuthorizedSellerStatus)

僅供輸出。授權賣方狀態。

GeoRegionTargetingOptionDetails

代表可指定的地理區域。當 targetingTypeTARGETING_TYPE_GEO_REGION 時,geoRegionDetails 欄位就會填入此欄位。

JSON 表示法
{
  "displayName": string,
  "geoRegionType": enum (GeoRegionType)
}
欄位
displayName

string

僅供輸出。地理區域的顯示名稱 (例如「加拿大安大略省」)。

geoRegionType

enum (GeoRegionType)

僅供輸出。指定地理區域的類型。

ExchangeTargetingOptionDetails

代表可指定的廣告交易平台。當 targetingTypeTARGETING_TYPE_EXCHANGE 時,系統會在 TargetingOption 的 exchangeDetails 欄位中填入這項資訊。

JSON 表示法
{
  "exchange": enum (Exchange)
}
欄位
exchange

enum (Exchange)

僅供輸出。廣告交易平台的類型。

SubExchangeTargetingOptionDetails

代表可指定的子廣告交易平台。當 targetingTypeTARGETING_TYPE_SUB_EXCHANGE 時,系統會在 TargetingOption 的 subExchangeDetails 欄位中填入這項資訊。

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

string

僅供輸出。子廣告交易平台的顯示名稱。

PoiTargetingOptionDetails

代表可指定的搜尋點(POI)。當 targetingTypeTARGETING_TYPE_POI 時,poiDetails 欄位就會填入此欄位。

JSON 表示法
{
  "latitude": number,
  "longitude": number,
  "displayName": string
}
欄位
latitude

number

僅供輸出。搜尋點的緯度,四捨五入到小數點第 6 位。

longitude

number

僅供輸出。搜尋點的經度,四捨五入到小數點後第 6 位數。

displayName

string

僅供輸出。搜尋點的顯示名稱 (例如「時廣場」、「太空針塔」),後面加上完整地址 (如果有的話)。

BusinessChainTargetingOptionDetails

代表某地理區域內可供指定的連鎖店。當 targetingTypeTARGETING_TYPE_BUSINESS_CHAIN 時,businessChainDetails 欄位就會填入此欄位。

JSON 表示法
{
  "businessChain": string,
  "geoRegion": string,
  "geoRegionType": enum (GeoRegionType)
}
欄位
businessChain

string

僅供輸出。商家連鎖店的顯示名稱,例如「KFC」、「Chase Bank」。

geoRegion

string

僅供輸出。地理區域的顯示名稱,例如「加拿大安大略省」。

geoRegionType

enum (GeoRegionType)

僅供輸出。地理區域的類型,

ContentDurationTargetingOptionDetails

代表可指定的內容時間長度。當 targetingTypeTARGETING_TYPE_CONTENT_DURATION 時,contentDurationDetails 欄位就會填入此欄位。

JSON 表示法
{
  "contentDuration": enum (ContentDuration)
}
欄位
contentDuration

enum (ContentDuration)

僅供輸出。內容時間長度。

ContentStreamTypeTargetingOptionDetails

代表可指定的內容串流類型。當 targetingTypeTARGETING_TYPE_CONTENT_STREAM_TYPE 時,contentStreamTypeDetails 欄位就會填入此欄位。

JSON 表示法
{
  "contentStreamType": enum (ContentStreamType)
}
欄位
contentStreamType

enum (ContentStreamType)

僅供輸出。內容串流類型。

NativeContentPositionTargetingOptionDetails

代表可指定的原生內容位置。當 targetingTypeTARGETING_TYPE_NATIVE_CONTENT_POSITION 時,nativeContentPositionDetails 欄位就會填入此欄位。

JSON 表示法
{
  "contentPosition": enum (NativeContentPosition)
}
欄位
contentPosition

enum (NativeContentPosition)

僅供輸出。內容位置。

OmidTargetingOptionDetails

代表已啟用指定 Open Measurement 的廣告空間類型。當 targetingTypeTARGETING_TYPE_OMID 時,omidDetails 欄位就會填入此欄位。

JSON 表示法
{
  "omid": enum (Omid)
}
欄位
omid

enum (Omid)

僅供輸出。已啟用 Open Measurement 的廣告空間類型。

AudioContentTypeTargetingOptionDetails

代表可指定的音訊內容類型。當 targetingTypeTARGETING_TYPE_AUDIO_CONTENT_TYPE 時,audioContentTypeDetails 欄位就會填入此欄位。

JSON 表示法
{
  "audioContentType": enum (AudioContentType)
}
欄位
audioContentType

enum (AudioContentType)

僅供輸出。音訊內容的類型。

ContentGenreTargetingOptionDetails

代表可指定的內容類型。當 targetingTypeTARGETING_TYPE_CONTENT_GENRE 時,contentGenreDetails 欄位就會填入此欄位。

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

string

僅供輸出。內容類型的顯示名稱

方法

get

取得單一指定選項。

list

特定類型的清單指定目標選項。
根據指定搜尋字詞搜尋指定類型的指定目標選項。