- 資源:TargetOption
- DigitalContentLabelTargetingOptionDetails
- SensitiveCategoryTargetingOptionDetails
- AppCategoryTargetingOptionDetails
- OnScreenPositionTargetingOptionDetails
- ContentOutstreamPositionTargetingOptionDetails
- ContentInstreamPositionTargetingOptionDetails
- VideoPlayerSizeTargetingOptionDetails
- AgeRangeTargetingOptionDetails
- ParentalStatusTargetingOptionDetails
- UserRewardedContentTargetingOptionDetails
- HouseholdIncomeTargetingOptionDetails
- GenderTargetingOptionDetails
- DeviceTypeTargetingOptionDetails
- BrowserTargetingOptionDetails
- CarrierAndIspTargetingOptionDetails
- CarrierAndIspType
- EnvironmentTargetingOptionDetails
- OperatingSystemTargetingOptionDetails
- DeviceMakeModelTargetingOptionDetails
- ViewabilityTargetingOptionDetails
- CategoryTargetingOptionDetails
- LanguageTargetingOptionDetails
- AuthorizedSellerStatusTargetingOptionDetails
- GeoRegionTargetingOptionDetails
- ExchangeTargetingOptionDetails
- SubExchangeTargetingOptionDetails
- PoiTargetingOptionDetails
- BusinessChainTargetingOptionDetails
- ContentDurationTargetingOptionDetails
- ContentStreamTypeTargetingOptionDetails
- NativeContentPositionTargetingOptionDetails
- OmidTargetingOptionDetails
- AudioContentTypeTargetingOptionDetails
- ContentGenreTargetingOptionDetails
- 方法
資源:TargetOption
代表單一指定目標選項,這是 DV360 中可供指定的概念。
JSON 表示法 |
---|
{ "name": string, "targetingOptionId": string, "targetingType": enum ( |
欄位 | |
---|---|
name |
僅供輸出。這個指定目標選項的資源名稱。 |
targetingOptionId |
僅供輸出。這個指定目標選項的專屬 ID。元組 { |
targetingType |
僅供輸出。這個指定目標選項的類型。 |
聯集欄位 details 。指定目標選項的詳細資訊。您只能填寫詳細資料中的一個欄位,且這個欄位必須對應 targeting_type 。details 只能採用下列其中一種設定: |
|
digitalContentLabelDetails |
數位內容標籤詳細資料。 |
sensitiveCategoryDetails |
敏感類別詳細資料。 |
appCategoryDetails |
應用程式類別詳細資料。 |
onScreenPositionDetails |
畫面上位置詳細資料。 |
contentOutstreamPositionDetails |
內容串流外位置詳細資料。 |
contentInstreamPositionDetails |
內容串流內廣告位置詳細資料。 |
videoPlayerSizeDetails |
影片播放器大小詳細資料。 |
ageRangeDetails |
年齡層詳細資料。 |
parentalStatusDetails |
家長狀態詳細資料。 |
userRewardedContentDetails |
使用者獎勵內容詳細資料。 |
householdIncomeDetails |
家庭收入詳細資料。 |
genderDetails |
性別詳細資料。 |
deviceTypeDetails |
裝置類型詳細資料。 |
browserDetails |
瀏覽器詳細資料。 |
carrierAndIspDetails |
電信業者和網際網路服務供應商 (ISP) 的詳細資料。 |
environmentDetails |
環境詳細資料。 |
operatingSystemDetails |
作業系統資源詳細資料。 |
deviceMakeModelDetails |
裝置廠牌和型號資源詳細資料。 |
viewabilityDetails |
可視度資源詳細資料。 |
categoryDetails |
類別資源詳細資料。 |
languageDetails |
語言資源詳細資料。 |
authorizedSellerStatusDetails |
授權賣方狀態資源詳細資料。 |
geoRegionDetails |
地理區域資源詳細資料。 |
exchangeDetails |
交換詳細資料。 |
subExchangeDetails |
子廣告交易平台詳細資料。 |
poiDetails |
搜尋點資源詳細資料。 |
businessChainDetails |
業務鏈資源詳細資料。 |
contentDurationDetails |
內容時間長度資源詳細資料。 |
contentStreamTypeDetails |
內容串流類型資源詳細資料。 |
nativeContentPositionDetails |
原生內容位置詳細資料。 |
omidDetails |
已啟用 Open Measurement 的廣告空間詳細資料。 |
audioContentTypeDetails |
音訊內容類型詳細資料。 |
contentGenreDetails |
內容類型資源詳細資料。 |
DigitalContentLabelTargetingOptionDetails
代表可指定的數位內容標籤分級等級。當 targetingType
為 TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
時,系統會在 TargetingOption 的 digitalContentLabelDetails
欄位中填入此資訊。
JSON 表示法 |
---|
{
"contentRatingTier": enum ( |
欄位 | |
---|---|
contentRatingTier |
僅供輸出。內容標籤品牌安全等級的列舉。 |
SensitiveCategoryTargetingOptionDetails
代表可指定的敏感類別。當 targetingType
為 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
時,系統會在 TargetingOption 的 sensitiveCategoryDetails
欄位中填入此資訊。
JSON 表示法 |
---|
{
"sensitiveCategory": enum ( |
欄位 | |
---|---|
sensitiveCategory |
僅供輸出。DV360 敏感類別敏感內容分類的列舉。 |
AppCategoryTargetingOptionDetails
代表一組可指定的應用程式。集合可讓您指定由平台維護的相關動態應用程式群組,例如 All Apps/Google Play/Games
。當 targetingType
為 TARGETING_TYPE_APP_CATEGORY
時,appCategoryDetails
欄位就會填入此欄位。
JSON 表示法 |
---|
{ "displayName": string } |
欄位 | |
---|---|
displayName |
僅供輸出。應用程式集合的名稱。 |
OnScreenPositionTargetingOptionDetails
代表可指定的畫面位置,可由多媒體廣告和影片廣告使用。當 targetingType
為 TARGETING_TYPE_ON_SCREEN_POSITION
時,onScreenPositionDetails
欄位就會填入此欄位。
JSON 表示法 |
---|
{
"onScreenPosition": enum ( |
欄位 | |
---|---|
onScreenPosition |
僅供輸出。螢幕上的位置。 |
ContentOutstreamPositionTargetingOptionDetails
代表可指定內容串流外位置,可用於多媒體廣告和影片廣告。當 targetingType
為 TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
時,contentOutstreamPositionDetails
欄位就會填入此欄位。
JSON 表示法 |
---|
{
"contentOutstreamPosition": enum ( |
欄位 | |
---|---|
contentOutstreamPosition |
僅供輸出。內容串流外位置。 |
ContentInstreamPositionTargetingOptionDetails
代表可指定內容串流內位置,可用於影片和音訊廣告。當 targetingType
為 TARGETING_TYPE_CONTENT_INSTREAM_POSITION
時,contentInstreamPositionDetails
欄位就會填入此欄位。
JSON 表示法 |
---|
{
"contentInstreamPosition": enum ( |
欄位 | |
---|---|
contentInstreamPosition |
僅供輸出。內容串流內位置。 |
VideoPlayerSizeTargetingOptionDetails
代表可指定的影片播放器大小。當 targetingType
為 TARGETING_TYPE_VIDEO_PLAYER_SIZE
時,videoPlayerSizeDetails
欄位就會填入此欄位。
JSON 表示法 |
---|
{
"videoPlayerSize": enum ( |
欄位 | |
---|---|
videoPlayerSize |
僅供輸出。影片播放器的大小。 |
AgeRangeTargetingOptionDetails
代表可指定的年齡層。當 targetingType
為 TARGETING_TYPE_AGE_RANGE
時,ageRangeDetails
欄位就會填入此欄位。
JSON 表示法 |
---|
{
"ageRange": enum ( |
欄位 | |
---|---|
ageRange |
僅供輸出。目標對象的年齡層, |
ParentalStatusTargetingOptionDetails
代表可指定的家長狀態。當 targetingType
為 TARGETING_TYPE_PARENTAL_STATUS
時,系統會在 TargetingOption 的 parentalStatusDetails
欄位中填入這項資訊。
JSON 表示法 |
---|
{
"parentalStatus": enum ( |
欄位 | |
---|---|
parentalStatus |
僅供輸出。目標對象的家長狀態, |
UserRewardedContentTargetingOptionDetails
代表影片廣告的可指定使用者獎勵內容狀態。當 targetingType
為 TARGETING_TYPE_USER_REWARDED_CONTENT
時,userRewardedContentDetails
欄位就會填入此欄位。
JSON 表示法 |
---|
{
"userRewardedContent": enum ( |
欄位 | |
---|---|
userRewardedContent |
僅供輸出。影片廣告的使用者獎勵內容狀態。 |
HouseholdIncomeTargetingOptionDetails
代表可指定的家庭收入。當 targetingType
為 TARGETING_TYPE_HOUSEHOLD_INCOME
時,系統會在 TargetingOption 的 householdIncomeDetails
欄位中填入這項資訊。
JSON 表示法 |
---|
{
"householdIncome": enum ( |
欄位 | |
---|---|
householdIncome |
僅供輸出。目標對象的家庭收入。 |
GenderTargetingOptionDetails
代表可指定的性別。當 targetingType
為 TARGETING_TYPE_GENDER
時,系統會在 TargetingOption 的 genderDetails
欄位中填入這項資訊。
JSON 表示法 |
---|
{
"gender": enum ( |
欄位 | |
---|---|
gender |
僅供輸出。目標對象的性別。 |
DeviceTypeTargetingOptionDetails
代表可指定的裝置類型。當 targetingType
為 TARGETING_TYPE_DEVICE_TYPE
時,系統會在 TargetingOption 的 deviceTypeDetails
欄位中填入這項資訊。
JSON 表示法 |
---|
{
"deviceType": enum ( |
欄位 | |
---|---|
deviceType |
僅供輸出。指定的裝置類型。 |
BrowserTargetingOptionDetails
代表可指定的瀏覽器。當 targetingType
為 TARGETING_TYPE_BROWSER
時,browserDetails
欄位就會填入此欄位。
JSON 表示法 |
---|
{ "displayName": string } |
欄位 | |
---|---|
displayName |
僅供輸出。瀏覽器的顯示名稱。 |
CarrierAndIspTargetingOptionDetails
代表指定的電信業者或網際網路服務供應商 (ISP)。當 targetingType
為 TARGETING_TYPE_CARRIER_AND_ISP
時,系統會在 TargetingOption 的 carrierAndIspDetails
欄位中填入這項資訊。
JSON 表示法 |
---|
{
"displayName": string,
"type": enum ( |
欄位 | |
---|---|
displayName |
僅供輸出。電信業者或網際網路服務供應商 (ISP) 的顯示名稱。 |
type |
僅供輸出。指明為電信業者或網際網路服務供應商 (ISP) 的類型。 |
CarrierAndIspType
CarrierAndIsp 指定目標選項的類型。
列舉 | |
---|---|
CARRIER_AND_ISP_TYPE_UNSPECIFIED |
未指定類型,或此版本不含類型時的預設值。 |
CARRIER_AND_ISP_TYPE_ISP |
表示這項指定資源參照了網際網路服務供應商 (ISP)。 |
CARRIER_AND_ISP_TYPE_CARRIER |
表示這項指定資源參照行動電信業者。 |
EnvironmentTargetingOptionDetails
代表可指定的環境。當 targetingType
為 TARGETING_TYPE_ENVIRONMENT
時,系統會在 TargetingOption 的 environmentDetails
欄位中填入這項資訊。
JSON 表示法 |
---|
{
"environment": enum ( |
欄位 | |
---|---|
environment |
僅供輸出。放送環境。 |
OperatingSystemTargetingOptionDetails
代表可供指定的作業系統。當 targetingType
為 TARGETING_TYPE_OPERATING_SYSTEM
時,系統會在 TargetingOption 的 operatingSystemDetails
欄位中填入這項資訊。
JSON 表示法 |
---|
{ "displayName": string } |
欄位 | |
---|---|
displayName |
僅供輸出。作業系統的顯示名稱。 |
DeviceMakeModelTargetingOptionDetails
代表可供指定的裝置廠牌和型號。當 targetingType
為 TARGETING_TYPE_DEVICE_MAKE_MODEL
時,系統會在 TargetingOption 的 deviceMakeModelDetails
欄位中填入這項資訊。
JSON 表示法 |
---|
{ "displayName": string } |
欄位 | |
---|---|
displayName |
僅供輸出。裝置廠牌和型號的顯示名稱。 |
ViewabilityTargetingOptionDetails
代表可供指定的可視度。當 targetingType
為 TARGETING_TYPE_VIEWABILITY
時,系統會在 TargetingOption 的 viewabilityDetails
欄位中填入這項資訊。
JSON 表示法 |
---|
{
"viewability": enum ( |
欄位 | |
---|---|
viewability |
僅供輸出。預測的可視度百分比。 |
CategoryTargetingOptionDetails
代表可指定的類別。當 targetingType
為 TARGETING_TYPE_CATEGORY
時,系統會在 TargetingOption 的 categoryDetails
欄位中填入這項資訊。
JSON 表示法 |
---|
{ "displayName": string } |
欄位 | |
---|---|
displayName |
僅供輸出。類別的顯示名稱。 |
LanguageTargetingOptionDetails
代表可指定的語言。當 targetingType
為 TARGETING_TYPE_LANGUAGE
時,languageDetails
欄位就會填入此欄位。
JSON 表示法 |
---|
{ "displayName": string } |
欄位 | |
---|---|
displayName |
僅供輸出。語言的顯示名稱 (例如「法文」)。 |
AuthorizedSellerStatusTargetingOptionDetails
代表可指定的授權賣方狀態。當 targetingType
為 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
時,authorizedSellerStatusDetails
欄位就會填入此欄位。
JSON 表示法 |
---|
{
"authorizedSellerStatus": enum ( |
欄位 | |
---|---|
authorizedSellerStatus |
僅供輸出。授權賣方狀態。 |
GeoRegionTargetingOptionDetails
代表可指定的地理區域。當 targetingType
為 TARGETING_TYPE_GEO_REGION
時,geoRegionDetails
欄位就會填入此欄位。
JSON 表示法 |
---|
{
"displayName": string,
"geoRegionType": enum ( |
欄位 | |
---|---|
displayName |
僅供輸出。地理區域的顯示名稱 (例如「加拿大安大略省」)。 |
geoRegionType |
僅供輸出。指定地理區域的類型。 |
ExchangeTargetingOptionDetails
代表可指定的廣告交易平台。當 targetingType
為 TARGETING_TYPE_EXCHANGE
時,系統會在 TargetingOption 的 exchangeDetails
欄位中填入這項資訊。
JSON 表示法 |
---|
{
"exchange": enum ( |
欄位 | |
---|---|
exchange |
僅供輸出。廣告交易平台的類型。 |
SubExchangeTargetingOptionDetails
代表可指定的子廣告交易平台。當 targetingType
為 TARGETING_TYPE_SUB_EXCHANGE
時,系統會在 TargetingOption 的 subExchangeDetails
欄位中填入這項資訊。
JSON 表示法 |
---|
{ "displayName": string } |
欄位 | |
---|---|
displayName |
僅供輸出。子廣告交易平台的顯示名稱。 |
PoiTargetingOptionDetails
代表可指定的搜尋點(POI)。當 targetingType
為 TARGETING_TYPE_POI
時,poiDetails
欄位就會填入此欄位。
JSON 表示法 |
---|
{ "latitude": number, "longitude": number, "displayName": string } |
欄位 | |
---|---|
latitude |
僅供輸出。搜尋點的緯度,四捨五入到小數點第 6 位。 |
longitude |
僅供輸出。搜尋點的經度,四捨五入到小數點後第 6 位數。 |
displayName |
僅供輸出。搜尋點的顯示名稱 (例如「時廣場」、「太空針塔」),後面加上完整地址 (如果有的話)。 |
BusinessChainTargetingOptionDetails
代表某地理區域內可供指定的連鎖店。當 targetingType
為 TARGETING_TYPE_BUSINESS_CHAIN
時,businessChainDetails
欄位就會填入此欄位。
JSON 表示法 |
---|
{
"businessChain": string,
"geoRegion": string,
"geoRegionType": enum ( |
欄位 | |
---|---|
businessChain |
僅供輸出。商家連鎖店的顯示名稱,例如「KFC」、「Chase Bank」。 |
geoRegion |
僅供輸出。地理區域的顯示名稱,例如「加拿大安大略省」。 |
geoRegionType |
僅供輸出。地理區域的類型, |
ContentDurationTargetingOptionDetails
代表可指定的內容時間長度。當 targetingType
為 TARGETING_TYPE_CONTENT_DURATION
時,contentDurationDetails
欄位就會填入此欄位。
JSON 表示法 |
---|
{
"contentDuration": enum ( |
欄位 | |
---|---|
contentDuration |
僅供輸出。內容時間長度。 |
ContentStreamTypeTargetingOptionDetails
代表可指定的內容串流類型。當 targetingType
為 TARGETING_TYPE_CONTENT_STREAM_TYPE
時,contentStreamTypeDetails
欄位就會填入此欄位。
JSON 表示法 |
---|
{
"contentStreamType": enum ( |
欄位 | |
---|---|
contentStreamType |
僅供輸出。內容串流類型。 |
NativeContentPositionTargetingOptionDetails
代表可指定的原生內容位置。當 targetingType
為 TARGETING_TYPE_NATIVE_CONTENT_POSITION
時,nativeContentPositionDetails
欄位就會填入此欄位。
JSON 表示法 |
---|
{
"contentPosition": enum ( |
欄位 | |
---|---|
contentPosition |
僅供輸出。內容位置。 |
OmidTargetingOptionDetails
代表已啟用指定 Open Measurement 的廣告空間類型。當 targetingType
為 TARGETING_TYPE_OMID
時,omidDetails
欄位就會填入此欄位。
JSON 表示法 |
---|
{
"omid": enum ( |
欄位 | |
---|---|
omid |
僅供輸出。已啟用 Open Measurement 的廣告空間類型。 |
AudioContentTypeTargetingOptionDetails
代表可指定的音訊內容類型。當 targetingType
為 TARGETING_TYPE_AUDIO_CONTENT_TYPE
時,audioContentTypeDetails
欄位就會填入此欄位。
JSON 表示法 |
---|
{
"audioContentType": enum ( |
欄位 | |
---|---|
audioContentType |
僅供輸出。音訊內容的類型。 |
ContentGenreTargetingOptionDetails
代表可指定的內容類型。當 targetingType
為 TARGETING_TYPE_CONTENT_GENRE
時,contentGenreDetails
欄位就會填入此欄位。
JSON 表示法 |
---|
{ "displayName": string } |
欄位 | |
---|---|
displayName |
僅供輸出。內容類型的顯示名稱 |
方法 |
|
---|---|
|
取得單一指定選項。 |
|
特定類型的清單指定目標選項。 |
|
根據指定搜尋字詞搜尋指定類型的指定目標選項。 |