REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

資源:Assign TargetingOption

一個指派的指定目標選項,針對採用指定目標設定的實體定義指定目標選項的狀態。

JSON 表示法
{
  "name": string,
  "assignedTargetingOptionId": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // Union field details can be only one of the following:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
欄位
name

string

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

assignedTargetingOptionId

string

僅供輸出。指定指定目標選項的專屬 ID。此 ID 只在特定資源和指定類型中是唯一的。它可在其他情況下重複使用。

targetingType

enum (TargetingType)

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

inheritance

enum (Inheritance)

僅供輸出。指定指定目標選項的沿用狀態。

聯集欄位 details。指定指定目標選項的詳細資訊。詳細資料中只能填寫一個欄位,且必須與 targeting_type 對應;details 只能設為下列其中一個欄位:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

頻道詳細資料。當 targetingTypeTARGETING_TYPE_CHANNEL 時,系統就會填入此欄位。

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

應用程式類別詳細資料。當 targetingTypeTARGETING_TYPE_APP_CATEGORY 時,系統就會填入此欄位。

appDetails

object (AppAssignedTargetingOptionDetails)

應用程式詳細資料。當 targetingTypeTARGETING_TYPE_APP 時,系統就會填入此欄位。

urlDetails

object (UrlAssignedTargetingOptionDetails)

網址詳細資料。當 targetingTypeTARGETING_TYPE_URL 時,系統就會填入此欄位。

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

日期和時間詳細資料。當 targetingTypeTARGETING_TYPE_DAY_AND_TIME 時,系統就會填入此欄位。

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

年齡層詳細資料。當 targetingTypeTARGETING_TYPE_AGE_RANGE 時,系統就會填入此欄位。

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

區域位置清單詳細資料。當 targetingTypeTARGETING_TYPE_REGIONAL_LOCATION_LIST 時,系統就會填入此欄位。

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

鄰近位置清單詳細資料。當 targetingTypeTARGETING_TYPE_PROXIMITY_LOCATION_LIST 時,系統就會填入此欄位。

genderDetails

object (GenderAssignedTargetingOptionDetails)

性別詳細資料。當 targetingTypeTARGETING_TYPE_GENDER 時,系統就會填入此欄位。

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

影片播放器大小詳細資料。當 targetingTypeTARGETING_TYPE_VIDEO_PLAYER_SIZE 時,系統就會填入此欄位。

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

使用者獎勵內容詳細資料。當 targetingTypeTARGETING_TYPE_USER_REWARDED_CONTENT 時,系統就會填入此欄位。

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

家長狀態詳細資料。當 targetingTypeTARGETING_TYPE_PARENTAL_STATUS 時,系統就會填入此欄位。

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

內容串流內位置詳細資料。當 targetingTypeTARGETING_TYPE_CONTENT_INSTREAM_POSITION 時,系統就會填入此欄位。

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

內容串流外位置詳細資料。當 targetingTypeTARGETING_TYPE_CONTENT_OUTSTREAM_POSITION 時,系統就會填入此欄位。

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

裝置類型詳細資料。當 targetingTypeTARGETING_TYPE_DEVICE_TYPE 時,系統就會填入此欄位。

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

指定目標對象詳情。當 targetingTypeTARGETING_TYPE_AUDIENCE_GROUP 時,系統就會填入此欄位。每項資源只能指定一個目標對象群組選項。

browserDetails

object (BrowserAssignedTargetingOptionDetails)

瀏覽器詳細資料。當 targetingTypeTARGETING_TYPE_BROWSER 時,系統就會填入此欄位。

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

家庭收入詳細資料。當 targetingTypeTARGETING_TYPE_HOUSEHOLD_INCOME 時,系統就會填入此欄位。

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

螢幕位置詳細資料。當 targetingTypeTARGETING_TYPE_ON_SCREEN_POSITION 時,系統就會填入此欄位。

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

電信業者和網際網路服務供應商 (ISP) 的詳細資料。當 targetingTypeTARGETING_TYPE_CARRIER_AND_ISP 時,系統就會填入此欄位。

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

關鍵字詳情。當 targetingTypeTARGETING_TYPE_KEYWORD 時,系統就會填入此欄位。

一項資源最多可指派 5,000 個直接排除關鍵字。可指派的正面關鍵字數量沒有限制。

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

關鍵字詳情。當 targetingTypeTARGETING_TYPE_NEGATIVE_KEYWORD_LIST 時,系統就會填入此欄位。

一項資源最多可指派 4 份排除關鍵字清單。

operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

作業系統詳細資料。當 targetingTypeTARGETING_TYPE_OPERATING_SYSTEM 時,系統就會填入此欄位。

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

裝置廠牌和型號詳細資料。當 targetingTypeTARGETING_TYPE_DEVICE_MAKE_MODEL 時,系統就會填入此欄位。

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

環境詳細資料。當 targetingTypeTARGETING_TYPE_ENVIRONMENT 時,系統就會填入此欄位。

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

廣告空間來源詳細資料。當 targetingTypeTARGETING_TYPE_INVENTORY_SOURCE 時,系統就會填入此欄位。

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

類別詳細資料。當 targetingTypeTARGETING_TYPE_CATEGORY 時,系統就會填入此欄位。

指定某個類別也會同時指定子類別。如果從指定目標中排除某個類別,且使用了子類別,系統會優先排除該類別。

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

可視度詳細資料。當 targetingTypeTARGETING_TYPE_VIEWABILITY 時,系統就會填入此欄位。

每項資源只能指定一個可視度選項。

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

授權賣方狀態詳細資料。當 targetingTypeTARGETING_TYPE_AUTHORIZED_SELLER_STATUS 時,系統就會填入此欄位。

每項資源只能指定一個授權賣方狀態選項。

如果資源沒有授權賣家狀態選項,系統預設會指定 ads.txt 檔案中所有註明為 DIRECT 或 RESELLER 的授權賣方。

languageDetails

object (LanguageAssignedTargetingOptionDetails)

語言詳細資料。當 targetingTypeTARGETING_TYPE_LANGUAGE 時,系統就會填入此欄位。

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

地理區域詳細資料。當 targetingTypeTARGETING_TYPE_GEO_REGION 時,系統就會填入此欄位。

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

廣告空間來源群組詳細資料。當 targetingTypeTARGETING_TYPE_INVENTORY_SOURCE_GROUP 時,系統就會填入此欄位。

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

數位內容標籤詳細資料。當 targetingTypeTARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION 時,系統就會填入此欄位。

數位內容標籤是指定目標排除條件。廣告客戶層級數位內容標籤排除條件 (如有設定) 一律會在廣告放送時套用 (即使未顯示在資源設定中)。資源設定除了可排除廣告客戶排除項目外的內容標籤,但無法覆寫這些標籤。如果排除所有數位內容標籤,委刊項就不會放送。

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

敏感類別詳細資料。當 targetingTypeTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION 時,系統就會填入此欄位。

敏感類別是指指定目標排除條件。廣告客戶層級的敏感類別排除條件 (如有設定) 一律會在廣告放送時套用,即使未顯示在資源設定中也一樣。資源設定除了可排除廣告客戶排除條件之外,還能排除敏感類別,但無法覆寫這些類別。

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

廣告交易平台詳細資料。當 targetingTypeTARGETING_TYPE_EXCHANGE 時,系統就會填入此欄位。

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

子廣告交易平台詳細資料。當 targetingTypeTARGETING_TYPE_SUB_EXCHANGE 時,系統就會填入此欄位。

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

第三方驗證詳細資料。當 targetingTypeTARGETING_TYPE_THIRD_PARTY_VERIFIER 時,系統就會填入此欄位。

poiDetails

object (PoiAssignedTargetingOptionDetails)

搜尋點詳細資料。當 targetingTypeTARGETING_TYPE_POI 時,系統就會填入此欄位。

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

連鎖店詳細資料。當 targetingTypeTARGETING_TYPE_BUSINESS_CHAIN 時,系統就會填入此欄位。

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

內容時間長度詳細資料。當 targetingTypeTARGETING_TYPE_CONTENT_DURATION 時,系統就會填入此欄位。

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

內容時間長度詳細資料。當指定類型為 TARGETING_TYPE_CONTENT_STREAM_TYPE 時,系統就會填入這個欄位。

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

原生內容位置詳細資料。當 targetingTypeTARGETING_TYPE_NATIVE_CONTENT_POSITION 時,系統就會填入此欄位。

omidDetails

object (OmidAssignedTargetingOptionDetails)

已啟用 Open Measurement 的廣告空間詳細資料。當 targetingTypeTARGETING_TYPE_OMID 時,系統就會填入此欄位。

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

音訊內容類型詳細資料。當 targetingTypeTARGETING_TYPE_AUDIO_CONTENT_TYPE 時,系統就會填入此欄位。

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

內容類型詳細資料。當 targetingTypeTARGETING_TYPE_CONTENT_GENRE 時,系統就會填入此欄位。

繼承

表示指定的指定目標選項是沿用自較高層級的實體 (例如合作夥伴或廣告客戶)。沿用的指派指定目標選項優先顯示,一律優先於在目前層級指派的指定目標放送,而且無法透過目前的實體服務修改。必須透過沿用來源的實體服務來修改。沿用設定僅適用於排除指定的頻道、敏感類別排除條件,以及數位內容標籤排除條件 (若這些排除條件是在上層層級設定)。

列舉
INHERITANCE_UNSPECIFIED 未指定繼承或設定不明。
NOT_INHERITED 指派的指定目標選項不會沿用較高層級實體。
INHERITED_FROM_PARTNER 指派的指定目標選項會沿用合作夥伴指定目標設定。
INHERITED_FROM_ADVERTISER 指派的指定目標選項會沿用廣告主指定目標設定。

ChannelAssignedTargetingOptionDetails

指定管道指定選項的詳細資料。當 targetingTypeTARGETING_TYPE_CHANNEL 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

JSON 表示法
{
  "channelId": string,
  "negative": boolean
}
欄位
channelId

string (int64 format)

必要欄位。頻道的 ID。請參閱合作夥伴擁有的頻道廣告客戶擁有的頻道資源中的頻道 ID 欄位。

negative

boolean

指出這個選項是否為排除指定。如果是廣告客戶層級指定的指定目標選項,這個欄位必須設為 true。

AppCategoryAssignedTargetingOptionDetails

指定應用程式類別指定選項的詳細資料。當 targetingTypeTARGETING_TYPE_APP_CATEGORY 時,系統會在 Assign TargetingOption 的「appCategoryDetails」欄位中填入資料。

JSON 表示法
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
欄位
displayName

string

僅供輸出。應用程式類別的顯示名稱。

targetingOptionId

string

必要欄位。targetingTypeTARGETING_TYPE_APP_CATEGORY 時,targetingOptionId 欄位。

negative

boolean

指出這個選項是否為排除指定。

AppAssignedTargetingOptionDetails

指定應用程式指定目標選項的詳細資料。當 targetingTypeTARGETING_TYPE_APP 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

JSON 表示法
{
  "appId": string,
  "displayName": string,
  "negative": boolean,
  "appPlatform": enum (AppPlatform)
}
欄位
appId

string

必要欄位。應用程式的 ID。

Android 的 Play 商店應用程式使用的是軟體包 ID,例如 com.google.android.gm。Apple 的 App Store 應用程式 ID 使用 9 位數字串,例如 422689480

displayName

string

僅供輸出。應用程式的顯示名稱。

negative

boolean

指出這個選項是否為排除指定。

appPlatform

enum (AppPlatform)

用於指出目標應用程式的平台。如果未指定這個欄位,系統會假設應用程式平台為行動裝置 (即Android 或 iOS),而我們將從應用程式 ID 取得適用的行動平台。

AppPlatform

可能的應用程式平台指定選項。

列舉
APP_PLATFORM_UNSPECIFIED 這個版本未指定應用程式平台時的預設值。這個列舉是預設值的預留位置,並不代表實際平台選項。
APP_PLATFORM_IOS 應用程式平台為 iOS。
APP_PLATFORM_ANDROID 應用程式平台是 Android。
APP_PLATFORM_ROKU 應用程式平台為 Roku。
APP_PLATFORM_AMAZON_FIRETV 這個應用程式平台是 Amazon FireTV。
APP_PLATFORM_PLAYSTATION 應用程式平台是 Playstation。
APP_PLATFORM_APPLE_TV 應用程式平台為 Apple TV。
APP_PLATFORM_XBOX 應用程式平台是 Xbox。
APP_PLATFORM_SAMSUNG_TV 應用程式平台是 Samsung TV。
APP_PLATFORM_ANDROID_TV 應用程式平台是 Android TV。
APP_PLATFORM_GENERIC_CTV 應用程式平台是連網電視平台,並未明確列於其他位置。

UrlAssignedTargetingOptionDetails

指定網址指定選項的詳細資料。當 targetingTypeTARGETING_TYPE_URL 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

JSON 表示法
{
  "url": string,
  "negative": boolean
}
欄位
url

string

必要欄位。網址,例如 example.com

DV360 支援兩種指定子目錄層級 (例如 www.example.com/one-subdirectory-level/second-level),以及指定五個層級的子網域,例如 five.four.three.two.one.example.com

negative

boolean

指出這個選項是否為排除指定。

DayAndTimeAssignedTargetingOptionDetails

代表一週內特定日期且包含開始和結束時間的時段區段。startHour 表示的時間必須早於 endHour 表示的時間。

JSON 表示法
{
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
欄位
dayOfWeek

enum (DayOfWeek)

必要欄位。用於指定日期和時間的指定目標設定是在星期幾。

startHour

integer

必要欄位。指定日期和時間的開始小時。必須介於 0 (當天的開始) 到 23 (結束時間前 1 小時) 之間。

endHour

integer

必要欄位。指定日期和時間的結束小時。必須介於 1 (一天開始後 1 小時) 到 24 (當天結束) 之間。

timeZoneResolution

enum (TimeZoneResolution)

必要欄位。用來決定這個日期和時間指定目標設定的時區的機制。

DayOfWeek

代表星期幾。

列舉
DAY_OF_WEEK_UNSPECIFIED 未指定星期幾。
MONDAY 週一
TUESDAY 週二
WEDNESDAY 星期三
THURSDAY 週四
FRIDAY 星期五
SATURDAY Saturday (週六)
SUNDAY 星期日

TimeZoneResolution

解析時區的可能方法。

列舉
TIME_ZONE_RESOLUTION_UNSPECIFIED 時區解析內容未指定或不明。
TIME_ZONE_RESOLUTION_END_USER 時間以看到廣告的使用者時區為準。
TIME_ZONE_RESOLUTION_ADVERTISER 時間以放送廣告的廣告客戶的時區為準。

AgeRangeAssignedTargetingOptionDetails

代表可指定的年齡層。當 targetingTypeTARGETING_TYPE_AGE_RANGE 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

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

enum (AgeRange)

目標對象的年齡層。我們只支援指定持續年齡層的目標對象。因此,這個欄位所代表的年齡層可以 1) 完全指定,或 2) 涵蓋較大的連續年齡層。指定指定年齡層時,您也可以一併指定年齡不明的目標對象,擴大指定年齡層的觸及範圍。

僅在 v1 中輸出。第 2 版的必要元素,

targetingOptionId

string

必要欄位。TARGETING_TYPE_AGE_RANGE 類型的 TargetingOptiontargetingOptionId

RegionalLocationListAssignedTargetingOptionDetails

區域地點清單的指定目標詳細資料。當 targetingTypeTARGETING_TYPE_REGIONAL_LOCATION_LIST 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

JSON 表示法
{
  "regionalLocationListId": string,
  "negative": boolean
}
欄位
regionalLocationListId

string (int64 format)

必要欄位。區域位置清單的 ID。應參照類型為 TARGETING_LOCATION_TYPE_REGIONALLocationList 資源中的 locationListId 欄位。

negative

boolean

指出這個選項是否為排除指定。

ProximityLocationListAssignedTargetingOptionDetails

鄰近地區清單的指定目標詳細資料。當 targetingTypeTARGETING_TYPE_PROXIMITY_LOCATION_LIST 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

JSON 表示法
{
  "proximityLocationListId": string,
  "proximityRadiusRange": enum (ProximityRadiusRange)
}
欄位
proximityLocationListId

string (int64 format)

必要欄位。鄰近地區清單的 ID。應參照類型為 TARGETING_LOCATION_TYPE_PROXIMITYLocationList 資源中的 locationListId 欄位。

proximityRadiusRange

enum (ProximityRadiusRange)

必要欄位。鄰近地點清單的半徑範圍。這代表指定地區周圍區域的大小。

單一資源底下的 All 個指定鄰近地區必須具有相同的半徑範圍值。設定這個值即可比對任何現有的指定目標。更新後,這個欄位就會變更資源下所有鄰近目標的半徑範圍。

ProximityRadiusRange

鄰近地理區域類型指派選項的半徑範圍類型。半徑範圍是相對於母體密度。舉例來說,鄉村地區的 PROXIMITY_RADIUS_RANGE_SMALL 和人口密集城市的 PROXIMITY_RADIUS_RANGE_SMALL 不同。

列舉
PROXIMITY_RADIUS_RANGE_UNSPECIFIED 未指定指定半徑範圍或指定的值不明。這個版本未指定半徑範圍時的預設值。此列舉是預設值的預留位置,不代表實際的半徑範圍選項。
PROXIMITY_RADIUS_RANGE_SMALL 指定半徑範圍較小。
PROXIMITY_RADIUS_RANGE_MEDIUM 指定半徑範圍為中。
PROXIMITY_RADIUS_RANGE_LARGE 指定半徑範圍很大。

GenderAssignedTargetingOptionDetails

指定性別選項的詳細資料。當 targetingTypeTARGETING_TYPE_GENDER 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

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

enum (Gender)

目標對象的性別。

僅在 v1 中輸出。第 2 版的必要元素,

targetingOptionId

string

必要欄位。TARGETING_TYPE_GENDER 類型的 TargetingOptiontargetingOptionId

VideoPlayerSizeAssignedTargetingOptionDetails

影片播放器大小指定目標選項詳細資料。當 targetingTypeTARGETING_TYPE_VIDEO_PLAYER_SIZE 時,系統會在 videoPlayerSizeDetails 欄位中填入這項資訊。不支援明確指定所有選項。如要達到這項效果,請移除所有影片播放器大小指定目標選項。

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

string

必要欄位。targetingTypeTARGETING_TYPE_VIDEO_PLAYER_SIZE 時,targetingOptionId 欄位。

videoPlayerSize

enum (VideoPlayerSize)

影片播放器的大小。

僅在 v1 中輸出。第 2 版的必要元素,

UserRewardedContentAssignedTargetingOptionDetails

使用者獎勵內容指定目標選項詳細資料。當 targetingTypeTARGETING_TYPE_USER_REWARDED_CONTENT 時,系統會在 userRewardedContentDetails 欄位中填入這項資訊。

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

string

必要欄位。targetingTypeTARGETING_TYPE_USER_REWARDED_CONTENT 時,targetingOptionId 欄位。

userRewardedContent

enum (UserRewardedContent)

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

ParentalStatusAssignedTargetingOptionDetails

「指派的家長狀態」選項詳細資料。當 targetingTypeTARGETING_TYPE_PARENTAL_STATUS 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

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

enum (ParentalStatus)

目標對象的家長狀態。

僅在 v1 中輸出。第 2 版的必要元素,

targetingOptionId

string

必要欄位。TARGETING_TYPE_PARENTAL_STATUS 類型的 TargetingOptiontargetingOptionId

ContentInstreamPositionAssignedTargetingOptionDetails

已指派的內容串流內廣告位置指定目標選項詳細資料。當 targetingTypeTARGETING_TYPE_CONTENT_INSTREAM_POSITION 時,系統會在 contentInstreamPositionDetails 欄位中填入這項資訊。

JSON 表示法
{
  "targetingOptionId": string,
  "contentInstreamPosition": enum (ContentInstreamPosition),
  "adType": enum (AdType)
}
欄位
targetingOptionId

string

必要欄位。targetingTypeTARGETING_TYPE_CONTENT_INSTREAM_POSITION 時,targetingOptionId 欄位。

contentInstreamPosition

enum (ContentInstreamPosition)

影片或音訊廣告的內容串流內位置。

僅在 v1 中輸出。第 2 版的必要元素,

adType

enum (AdType)

僅供輸出。要指定的廣告類型。只有支援指定廣告類型的廣告訂單和新委刊項才會預設沿用這個指定目標選項。可能的值為:

  • AD_TYPE_VIDEO,當 lineItemTypeLINE_ITEM_TYPE_VIDEO_DEFAULT 時,新委刊項會沿用這項設定。
  • AD_TYPE_AUDIO,當 lineItemTypeLINE_ITEM_TYPE_AUDIO_DEFAULT 時,新委刊項會沿用這項設定。

AdType

代表與廣告相關的廣告素材類型。

列舉
AD_TYPE_UNSPECIFIED 未指定廣告類型,或這個版本不明。
AD_TYPE_DISPLAY 多媒體廣告素材,例如圖片和 HTML5。
AD_TYPE_VIDEO 影片廣告素材,例如在影片播放器中串流內容時播放的影片廣告。
AD_TYPE_AUDIO 音訊廣告素材,例如在音訊內容期間播放的音訊廣告。

ContentOutstreamPositionAssignedTargetingOptionDetails

指派的內容串流外位置指定目標選項詳細資料。當 targetingTypeTARGETING_TYPE_CONTENT_OUTSTREAM_POSITION 時,系統會在 contentOutstreamPositionDetails 欄位中填入這項資訊。

JSON 表示法
{
  "targetingOptionId": string,
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
欄位
targetingOptionId

string

必要欄位。targetingTypeTARGETING_TYPE_CONTENT_OUTSTREAM_POSITION 時,targetingOptionId 欄位。

contentOutstreamPosition

enum (ContentOutstreamPosition)

內容串流外位置。

僅在 v1 中輸出。第 2 版的必要元素,

adType

enum (AdType)

僅供輸出。要指定的廣告類型。只有支援指定廣告類型的廣告訂單和新委刊項才會預設沿用這個指定目標選項。可能的值為:

  • AD_TYPE_DISPLAY,當 lineItemTypeLINE_ITEM_TYPE_DISPLAY_DEFAULT 時,新委刊項會沿用這項設定。
  • AD_TYPE_VIDEO,當 lineItemTypeLINE_ITEM_TYPE_VIDEO_DEFAULT 時,新委刊項會沿用這項設定。

DeviceTypeAssignedTargetingOptionDetails

裝置類型的指定目標詳細資料。當 targetingTypeTARGETING_TYPE_DEVICE_TYPE 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

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

string

必要欄位。裝置類型的 ID。

deviceType

enum (DeviceType)

裝置類型的顯示名稱。

僅在 v1 中輸出。第 2 版的必要元素,

AudienceGroupAssignedTargetingOptionDetails

指派的目標對象區隔指定目標選項詳細資料。當 targetingTypeTARGETING_TYPE_AUDIENCE_GROUP 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。每個群組之間的關係為 UNION,但排除 FirstAnd thirdPartyAudienceGroup 和 excludedGoogleAudienceGroup;「COMPLEMENT」與其他群組由 COMPLEMENT 搭配使用。

JSON 表示法
{
  "includedFirstAndThirdPartyAudienceGroups": [
    {
      object (FirstAndThirdPartyAudienceGroup)
    }
  ],
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedFirstAndThirdPartyAudienceGroup": {
    object (FirstAndThirdPartyAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  }
}
欄位
includedFirstAndThirdPartyAudienceGroups[]

object (FirstAndThirdPartyAudienceGroup)

包含第一方和第三方目標對象群組的第一方和第三方目標對象 ID 和頻率。每個第一方和第三方目標對象群組都只包含第一方和第三方目標對象 ID。每個第一方和第三方目標對象群組之間的關係為互動區域,結果與其他目標對象群組無關。系統會忽略採用相同設定的重複群組。

includedGoogleAudienceGroup

object (GoogleAudienceGroup)

所含 Google 目標對象群組的 Google 目標對象 ID。只包含 Google 目標對象 ID。

includedCustomListGroup

object (CustomListGroup)

已納入自訂名單群組的自訂名單 ID。僅包含自訂名單 ID。

includedCombinedAudienceGroup

object (CombinedAudienceGroup)

已納入目標對象群組的合併目標對象 ID。僅包含合併的目標對象 ID。

excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

已排除的第一方和第三方目標對象群組的第一方和第三方目標對象 ID 和頻率。用於排除指定目標。此群組「UNION」和其他排除目標對象群組的「COMPLEMENT」,是所有正面指定目標對象的比較結果。這些項目在邏輯上相互「OR」互換。

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

已排除 Google 目標對象群組的 Google 目標對象 ID。用於排除指定目標。此群組「UNION」和其他排除目標對象群組的「COMPLEMENT」,是所有正面指定目標對象的比較結果。只包含「興趣相似目標對象」、「潛在目標消費者」和「已安裝的應用程式」類型的 Google 目標對象。這些項目在邏輯上相互「OR」互換。

FirstAndThirdPartyAudienceGroup

第一方和第三方目標對象群組的詳細資料。所有第一方和第三方指定目標對象設定在邏輯上都具有「OR」關係。

JSON 表示法
{
  "settings": [
    {
      object (FirstAndThirdPartyAudienceTargetingSetting)
    }
  ]
}
欄位
settings[]

object (FirstAndThirdPartyAudienceTargetingSetting)

必要欄位。第一方和第三方目標對象群組中所有第一方和第三方指定目標對象設定。請勿重複輸入 ID 相同的設定。

FirstAndThirdPartyAudienceTargetingSetting

第一方和第三方指定目標對象設定的詳細資料。

JSON 表示法
{
  "firstAndThirdPartyAudienceId": string,
  "recency": enum (Recency)
}
欄位
firstAndThirdPartyAudienceId

string (int64 format)

必要欄位。第一方和第三方指定目標對象設定的第一方和第三方目標對象 ID。此 ID 為 firstAndThirdPartyAudienceId

recency

enum (Recency)

第一方和第三方指定目標對象設定的回訪率。僅適用於第一方目標對象,否則會遭到忽略。詳情請參閱 https://support.google.com/displayvideo/answer/2949947#recency。如未指定,則系統不會使用回訪率限制。

資料的新舊程度

所有支援的第一方和第三方目標對象回訪率值。

列舉
RECENCY_NO_LIMIT 回訪率無上限。
RECENCY_1_MINUTE 回訪率為 1 分鐘。
RECENCY_5_MINUTES 回訪率是 5 分鐘
RECENCY_10_MINUTES 回訪率是 10 分鐘。
RECENCY_15_MINUTES 回訪率是 15 分鐘。
RECENCY_30_MINUTES 回訪率是 30 分鐘。
RECENCY_1_HOUR 回訪率為 1 小時。
RECENCY_2_HOURS 回訪率為 2 小時。
RECENCY_3_HOURS 回訪率為 3 小時。
RECENCY_6_HOURS 回訪率為 6 小時。
RECENCY_12_HOURS 回訪率為 12 小時。
RECENCY_1_DAY 回訪率為 1 天。
RECENCY_2_DAYS 回訪率為 2 天。
RECENCY_3_DAYS 回訪率為 3 天。
RECENCY_5_DAYS 回訪率為 5 天。
RECENCY_7_DAYS 回訪率為 7 天。
RECENCY_10_DAYS 回訪率為 10 天。
RECENCY_14_DAYS 回訪率為 14 天。
RECENCY_15_DAYS 回訪率為 15 天。
RECENCY_21_DAYS 回訪率為 21 天。
RECENCY_28_DAYS 回訪率為 28 天。
RECENCY_30_DAYS 回訪率為 30 天。
RECENCY_40_DAYS 回訪率為 40 天。
RECENCY_45_DAYS 回訪率為 45 天。
RECENCY_60_DAYS 回訪率為 60 天。
RECENCY_90_DAYS 回訪率為 90 天。
RECENCY_120_DAYS 回訪率為 120 天。
RECENCY_180_DAYS 回訪率為 180 天。
RECENCY_270_DAYS 回訪率為 270 天。
RECENCY_365_DAYS 回訪率為 365 天。

GoogleAudienceGroup

Google 目標對象群組詳細資料。所有 Google 指定目標對象設定在邏輯上都具有「OR」關係。

JSON 表示法
{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}
欄位
settings[]

object (GoogleAudienceTargetingSetting)

必要欄位。Google 目標對象群組中所有 Google 指定目標對象設定。系統會忽略 ID 相同的重複設定。

GoogleAudienceTargetingSetting

Google 指定目標對象設定的詳細資料。

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

string (int64 format)

必要欄位。Google 指定目標對象設定的 Google 目標對象 ID。此 ID 為 googleAudienceId

CustomListGroup

自訂清單群組的詳細資料。所有自訂名單指定目標設定都以「OR」邏輯表示。

JSON 表示法
{
  "settings": [
    {
      object (CustomListTargetingSetting)
    }
  ]
}
欄位
settings[]

object (CustomListTargetingSetting)

必要欄位。自訂名單群組中所有自訂名單指定目標設定。系統會忽略 ID 相同的重複設定。

CustomListTargetingSetting

自訂名單指定目標設定的詳細資料。

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

string (int64 format)

必要欄位。自訂名單指定目標設定的自訂 ID。此 ID 為 customListId

CombinedAudienceGroup

合併目標對象群組的詳細資料。所有合併指定目標對象設定在邏輯上都具有「OR」關係。

JSON 表示法
{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}
欄位
settings[]

object (CombinedAudienceTargetingSetting)

必要欄位。合併目標對象群組中所有合併指定目標對象設定。系統會忽略 ID 相同的重複設定。合併目標對象設定的數量不得超過 5,否則系統會擲回錯誤。

CombinedAudienceTargetingSetting

合併指定目標對象設定的詳細資料。

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

string (int64 format)

必要欄位。合併指定目標對象設定的合併目標對象 ID。此 ID 為 combinedAudienceId

BrowserAssignedTargetingOptionDetails

指定瀏覽器指定選項的詳細資料。當 targetingTypeTARGETING_TYPE_BROWSER 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

JSON 表示法
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
欄位
displayName

string

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

targetingOptionId

string

必要欄位。TARGETING_TYPE_BROWSER 類型的 TargetingOptiontargetingOptionId

negative

boolean

指出這個選項是否為排除指定。在相同資源上,所有指派的瀏覽器指定選項都必須在這個欄位中填入相同值。

HouseholdIncomeAssignedTargetingOptionDetails

指定家庭收入指定目標選項的詳細資料。當 targetingTypeTARGETING_TYPE_HOUSEHOLD_INCOME 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

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

enum (HouseholdIncome)

目標對象的家庭收入。

僅在 v1 中輸出。第 2 版的必要元素,

targetingOptionId

string

必要欄位。TARGETING_TYPE_HOUSEHOLD_INCOME 類型的 TargetingOptiontargetingOptionId

OnScreenPositionAssignedTargetingOptionDetails

畫面上的指定選項詳細資料。當 targetingTypeTARGETING_TYPE_ON_SCREEN_POSITION 時,系統會在 onScreenPositionDetails 欄位中填入這項資訊。

JSON 表示法
{
  "targetingOptionId": string,
  "onScreenPosition": enum (OnScreenPosition),
  "adType": enum (AdType)
}
欄位
targetingOptionId

string

必要欄位。targetingTypeTARGETING_TYPE_ON_SCREEN_POSITION 時,targetingOptionId 欄位。

onScreenPosition

enum (OnScreenPosition)

僅供輸出。螢幕的位置。

adType

enum (AdType)

僅供輸出。要指定的廣告類型。只有支援指定廣告類型的廣告訂單和新委刊項才會預設沿用這個指定目標選項。可能的值為:

  • AD_TYPE_DISPLAY,當 lineItemTypeLINE_ITEM_TYPE_DISPLAY_DEFAULT 時,新委刊項會沿用這項設定。
  • AD_TYPE_VIDEO,當 lineItemTypeLINE_ITEM_TYPE_VIDEO_DEFAULT 時,新委刊項會沿用這項設定。

CarrierAndIspAssignedTargetingOptionDetails

指定電信業者和網際網路服務供應商 (ISP) 選項的詳細資料。當 targetingTypeTARGETING_TYPE_CARRIER_AND_ISP 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

JSON 表示法
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
欄位
displayName

string

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

targetingOptionId

string

必要欄位。TARGETING_TYPE_CARRIER_AND_ISP 類型的 TargetingOptiontargetingOptionId

negative

boolean

指出這個選項是否為排除指定。在相同資源中,所有指派的電信業者和網際網路服務供應商 (ISP) 指定目標選項在這個欄位中都必須有相同的值。

KeywordAssignedTargetingOptionDetails

指定指定關鍵字選項的詳細資料。當 targetingTypeTARGETING_TYPE_KEYWORD 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

JSON 表示法
{
  "keyword": string,
  "negative": boolean
}
欄位
keyword

string

必要欄位。關鍵字,例如 car insurance

正面關鍵字不得令人反感。必須採用 UTF-8 編碼,且大小不得超過 255 個位元組。長度上限為 80 個半形字元。字詞的數量上限為 10 個。

negative

boolean

指出這個選項是否為排除指定。

NegativeKeywordListAssignedTargetingOptionDetails

排除關鍵字清單的指定目標詳細資料。當 targetingTypeTARGETING_TYPE_NEGATIVE_KEYWORD_LIST 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

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

string (int64 format)

必要欄位。排除關鍵字清單的 ID。應參照 NegativeKeywordList 資源的 negativeKeywordListId 欄位。

OperatingSystemAssignedTargetingOptionDetails

已指派的作業系統指定選項詳細資料。當 targetingTypeTARGETING_TYPE_OPERATING_SYSTEM 時,系統會在 operatingSystemDetails 欄位中填入這項資訊。

JSON 表示法
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
欄位
displayName

string

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

targetingOptionId

string

必要欄位。targetingTypeTARGETING_TYPE_OPERATING_SYSTEM 時,「targetingOptionId」欄位中填入的指定目標選項 ID。

negative

boolean

指出這個選項是否為排除指定。

DeviceMakeModelAssignedTargetingOptionDetails

已指派的裝置廠牌和型號指定選項詳細說明。當 targetingTypeTARGETING_TYPE_DEVICE_MAKE_MODEL 時,系統會在 deviceMakeModelDetails 欄位中填入這項資訊。

JSON 表示法
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
欄位
displayName

string

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

targetingOptionId

string

必要欄位。targetingTypeTARGETING_TYPE_DEVICE_MAKE_MODEL 時,targetingOptionId 欄位。

negative

boolean

指出這個選項是否為排除指定。

EnvironmentAssignedTargetingOptionDetails

已指派的環境指定目標選項詳細資料。當 targetingTypeTARGETING_TYPE_ENVIRONMENT 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

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

enum (Environment)

放送環境。

僅在 v1 中輸出。第 2 版的必要元素,

targetingOptionId

string

必要欄位。TARGETING_TYPE_ENVIRONMENT 類型的 TargetingOptiontargetingOptionId (例如「508010」代表指定 ENVIRONMENT_WEB_OPTIMIZED 選項)。

InventorySourceAssignedTargetingOptionDetails

廣告空間來源的指定目標詳細資料。當 targetingTypeTARGETING_TYPE_INVENTORY_SOURCE 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

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

string (int64 format)

必要欄位。廣告空間來源的 ID。應參照 InventorySource 資源的 inventorySourceId 欄位。

CategoryAssignedTargetingOptionDetails

「已指派的指定類別」選項詳細說明。當 targetingTypeTARGETING_TYPE_CATEGORY 時,系統會在 categoryDetails 欄位中填入這項資訊。

JSON 表示法
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
欄位
displayName

string

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

targetingOptionId

string

必要欄位。targetingTypeTARGETING_TYPE_CATEGORY 時,targetingOptionId 欄位。

negative

boolean

指出這個選項是否為排除指定。

ViewabilityAssignedTargetingOptionDetails

指派的可視度指定目標選項詳細資料。當 targetingTypeTARGETING_TYPE_VIEWABILITY 時,系統會在 Assign TargetingOption 的「viewabilityDetails」欄位中填入資料。

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

enum (Viewability)

預測可視度百分比。

僅在 v1 中輸出。第 2 版的必要元素,

targetingOptionId

string

必要欄位。TARGETING_TYPE_VIEWABILITY 類型的 TargetingOptiontargetingOptionId (例如「509010」用於指定 VIEWABILITY_10_PERCENT_OR_MORE 選項)。

AuthorizedSellerStatusAssignedTargetingOptionDetails

代表指定授權賣方狀態。當 targetingTypeTARGETING_TYPE_AUTHORIZED_SELLER_STATUS 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

如果資源沒有指定的 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS 指定目標選項,系統會使用「授權直接賣方和經銷商」選項。

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

enum (AuthorizedSellerStatus)

僅供輸出。要指定的授權賣方狀態。

targetingOptionId

string

必要欄位。TARGETING_TYPE_AUTHORIZED_SELLER_STATUS 類型的 TargetingOptiontargetingOptionId

LanguageAssignedTargetingOptionDetails

「指定指定語言」選項的詳細資料。當 targetingTypeTARGETING_TYPE_LANGUAGE 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

JSON 表示法
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
欄位
displayName

string

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

targetingOptionId

string

必要欄位。TARGETING_TYPE_LANGUAGE 類型的 TargetingOptiontargetingOptionId

negative

boolean

指出這個選項是否為排除指定。同一個資源中所有指派的指定語言選項,都必須在這個欄位中填入相同值。

GeoRegionAssignedTargetingOptionDetails

指定地理區域選項的詳細資料。當 targetingTypeTARGETING_TYPE_GEO_REGION 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

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

string

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

targetingOptionId

string

必要欄位。TARGETING_TYPE_GEO_REGION 類型的 TargetingOptiontargetingOptionId

geoRegionType

enum (GeoRegionType)

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

negative

boolean

指出這個選項是否為排除指定。

InventorySourceGroupAssignedTargetingOptionDetails

廣告空間來源群組的指定目標詳細資料。當 targetingTypeTARGETING_TYPE_INVENTORY_SOURCE_GROUP 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

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

string (int64 format)

必要欄位。廣告空間來源群組的 ID。應參照 InventorySourceGroup 資源的 inventorySourceGroupId 欄位。

DigitalContentLabelAssignedTargetingOptionDetails

數位內容標籤的指定目標詳細資料。當 targetingTypeTARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

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

string

必要欄位。要排除的數位內容標籤 ID。

contentRatingTier

enum (ContentRatingTier)

僅供輸出。數位內容標籤分級等級的顯示名稱。

SensitiveCategoryAssignedTargetingOptionDetails

敏感類別的指定目標詳細資料。當 targetingTypeTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

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

string

必要欄位。要排除的敏感類別 ID。

sensitiveCategory

enum (SensitiveCategory)

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

ExchangeAssignedTargetingOptionDetails

指派的廣告交易平台指定目標選項的詳細資料。當 targetingTypeTARGETING_TYPE_EXCHANGE 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

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

string

必要欄位。TARGETING_TYPE_EXCHANGE 類型的 TargetingOptiontargetingOptionId

SubExchangeAssignedTargetingOptionDetails

指派子廣告交易平台指定目標選項的詳細資料。當 targetingTypeTARGETING_TYPE_SUB_EXCHANGE 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

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

string

必要欄位。TARGETING_TYPE_SUB_EXCHANGE 類型的 TargetingOptiontargetingOptionId

ThirdPartyVerifierAssignedTargetingOptionDetails

已指派的第三方驗證服務供應商指定目標選項詳細資料。當 targetingTypeTARGETING_TYPE_THIRD_PARTY_VERIFIER 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

JSON 表示法
{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
欄位
聯集欄位 verifier。可指定其中一個第三方驗證者,為曝光強制執行品牌安全門檻。verifier 只能是下列其中一項:
adloox

object (Adloox)

第三方品牌驗證商 -- Adloox。

doubleVerify

object (DoubleVerify)

第三方品牌驗證商 -- DoubleVerify。

integralAdScience

object (IntegralAdScience)

第三方品牌驗證商 -- Integral Ad Science。

Adloox

Adloox 設定的詳細資料。

JSON 表示法
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ]
}
欄位
excludedAdlooxCategories[]

enum (AdlooxCategory)

Adloox 的品牌安全設定。

AdlooxCategory

可能的 Adloox 選項。

列舉
ADLOOX_UNSPECIFIED 這個列舉只是預留位置,未指定任何 Adloox 選項。
ADULT_CONTENT_HARD 成人內容 (硬性)。
ADULT_CONTENT_SOFT 成人內容 (軟性)。
ILLEGAL_CONTENT 非法內容。
BORDERLINE_CONTENT 瀕臨違規內容。
DISCRIMINATORY_CONTENT 歧視內容。
VIOLENT_CONTENT_WEAPONS 暴力內容與武器。
LOW_VIEWABILITY_DOMAINS 低可視度網域。
FRAUD 詐欺。

DoubleVerify

DoubleVerify 設定的詳細資料。

JSON 表示法
{
  "brandSafetyCategories": {
    object (BrandSafetyCategories)
  },
  "avoidedAgeRatings": [
    enum (AgeRating)
  ],
  "appStarRating": {
    object (AppStarRating)
  },
  "displayViewability": {
    object (DisplayViewability)
  },
  "videoViewability": {
    object (VideoViewability)
  },
  "fraudInvalidTraffic": {
    object (FraudInvalidTraffic)
  },
  "customSegmentId": string
}
欄位
brandSafetyCategories

object (BrandSafetyCategories)

DV 品牌安全控制項。

avoidedAgeRatings[]

enum (AgeRating)

避免對具有年齡分級的應用程式出價。

appStarRating

object (AppStarRating)

避免對有星級評等的應用程式出價。

displayViewability

object (DisplayViewability)

顯示可視度設定 (僅適用於多媒體委刊項)。

videoViewability

object (VideoViewability)

影片可視度設定 (僅適用於影片委刊項)。

fraudInvalidTraffic

object (FraudInvalidTraffic)

避免指定具有過去詐欺和無效流量率的網站和應用程式。

customSegmentId

string (int64 format)

DoubleVerify 提供的自訂區隔 ID。ID 的開頭必須是「51」且由八個數字組成。自訂區隔 ID 不得和下列任一欄位一起指定:

BrandSafetyCategories

品牌安全控制選項的設定。

JSON 表示法
{
  "avoidUnknownBrandSafetyCategory": boolean,
  "avoidedHighSeverityCategories": [
    enum (HighSeverityCategory)
  ],
  "avoidedMediumSeverityCategories": [
    enum (MediumSeverityCategory)
  ]
}
欄位
avoidUnknownBrandSafetyCategory

boolean

不明或無法分級。

avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

品牌安全高嚴重性排除類別。

avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

品牌安全中嚴重程度排除類別。

HighSeverityCategory

高嚴重性類別的可用選項。

列舉
HIGHER_SEVERITY_UNSPECIFIED 這個列舉只是預留位置,不會指定任何高嚴重性類別。
ADULT_CONTENT_PORNOGRAPHY 成人內容:色情、成人主題和裸露內容。
COPYRIGHT_INFRINGEMENT 版權侵害。
SUBSTANCE_ABUSE 藥物/酒精飲料/管制類物品:藥物濫用。
GRAPHIC_VIOLENCE_WEAPONS 極端寫實/煽情露骨暴力/武器。
HATE_PROFANITY 仇恨/不雅用語。
CRIMINAL_SKILLS 非法活動:犯罪技能。
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER 獎勵/惡意軟體/間諜。

MediumSeverityCategory

中嚴重性類別的可能選項。

列舉
MEDIUM_SEVERITY_UNSPECIFIED 這個列舉只是預留位置,不會指定任何中嚴重性類別。
AD_SERVERS 廣告伺服器。
ADULT_CONTENT_SWIMSUIT 成人內容:泳裝。
ALTERNATIVE_LIFESTYLES 爭議性主題:另類生活方式。
CELEBRITY_GOSSIP 爭議性主題:名人八卦。
GAMBLING 爭議性主題:賭博。
OCCULT 爭議性主題:神秘現象。
SEX_EDUCATION 爭議性主題:性教育。
DISASTER_AVIATION 災難:飛行。
DISASTER_MAN_MADE 災害:人為造成,
DISASTER_NATURAL 災難:自然。
DISASTER_TERRORIST_EVENTS 災害:恐怖事件。
DISASTER_VEHICLE 災害:車輛。
ALCOHOL 藥物/酒精飲料/管制類物品:酒精飲料。
SMOKING 藥物/酒精飲料/管制類物品:吸菸。
NEGATIVE_NEWS_FINANCIAL 負面新聞:金融。
NON_ENGLISH 非標準內容:非英文。
PARKING_PAGE 非標準內容:停車網頁。
UNMODERATED_UGC 不審核的使用者原創內容:論壇、圖片和影片。
INFLAMMATORY_POLITICS_AND_NEWS 爭議性主題:煽動性政治和新聞。
NEGATIVE_NEWS_PHARMACEUTICAL 負面新聞:藥品。

AgeRating

年齡分級的選項。

列舉
AGE_RATING_UNSPECIFIED 這個列舉只是預留位置,未指定任何年齡分級選項。
APP_AGE_RATE_UNKNOWN 年齡分級不明的應用程式。
APP_AGE_RATE_4_PLUS 分級為適合所有人 (4 歲以上) 的應用程式。
APP_AGE_RATE_9_PLUS 分級為適合所有人 (9 歲以上) 的應用程式。
APP_AGE_RATE_12_PLUS 分級為適合青少年 (12 歲以上) 的應用程式。
APP_AGE_RATE_17_PLUS 分級為適合成人 (17 歲以上) 的應用程式。
APP_AGE_RATE_18_PLUS 分級為僅限成人 (18 歲以上) 的應用程式。

AppStarRating

DoubleVerify 星級評等設定的詳細資料。

JSON 表示法
{
  "avoidedStarRating": enum (StarRating),
  "avoidInsufficientStarRating": boolean
}
欄位
avoidedStarRating

enum (StarRating)

避免對有星級評等的應用程式出價。

avoidInsufficientStarRating

boolean

避免對星級評等不足的應用程式出價。

StarRating

星級評等的選項。

列舉
APP_STAR_RATE_UNSPECIFIED 這個列舉只是預留位置,不會指定任何應用程式星級評等選項。
APP_STAR_RATE_1_POINT_5_LESS 星級評等少於 1.5 顆星的官方應用程式。
APP_STAR_RATE_2_LESS 星級評等少於 2 顆星的官方應用程式。
APP_STAR_RATE_2_POINT_5_LESS 星級評等少於 2.5 顆星的官方應用程式。
APP_STAR_RATE_3_LESS 星級評等少於 3 顆星的官方應用程式。
APP_STAR_RATE_3_POINT_5_LESS 星級評等少於 3.5 顆星的官方應用程式。
APP_STAR_RATE_4_LESS 星級評等少於 4 顆星的官方應用程式。
APP_STAR_RATE_4_POINT_5_LESS 星級評等少於 4.5 顆星的官方應用程式。

DisplayViewability

DoubleVerify 多媒體廣告可視度設定的詳細資料。

JSON 表示法
{
  "iab": enum (IAB),
  "viewableDuring": enum (ViewableDuring)
}
欄位
iab

enum (IAB)

指定網站和應用程式廣告空間,盡量提高 IAB 可視率。

viewableDuring

enum (ViewableDuring)

指定網站和應用程式廣告空間,最大化 100% 的可視時間長度。

IAB

IAB 可視率的可能選項。

列舉
IAB_VIEWED_RATE_UNSPECIFIED 這個列舉只是預留位置,不會指定任何 IAB 可視率選項。
IAB_VIEWED_RATE_80_PERCENT_HIGHER 指定網站和應用程式廣告空間,將 IAB 可視率提高 80% 以上。
IAB_VIEWED_RATE_75_PERCENT_HIGHER 指定網站和應用程式廣告空間,將 IAB 可視率提高 75% 以上。
IAB_VIEWED_RATE_70_PERCENT_HIGHER 指定網站和應用程式廣告空間,將 IAB 可視率提高 70% 以上。
IAB_VIEWED_RATE_65_PERCENT_HIGHER 指定網站和應用程式廣告空間,將 IAB 可視率提高 65% 以上。
IAB_VIEWED_RATE_60_PERCENT_HIGHER 指定網站和應用程式廣告空間,將 IAB 可視率提高 60% 以上。
IAB_VIEWED_RATE_55_PERCENT_HIGHER 指定網站和應用程式廣告空間,將 IAB 可視率提高 55% 以上。
IAB_VIEWED_RATE_50_PERCENT_HIGHER 指定網站和應用程式廣告空間,將 IAB 可視率提高 50% 以上。
IAB_VIEWED_RATE_40_PERCENT_HIGHER 指定網站和應用程式廣告空間,將 IAB 可視率提高 40% 以上。
IAB_VIEWED_RATE_30_PERCENT_HIGHER 指定網站和應用程式廣告空間,將 IAB 可視率提高 30% 以上。

ViewableDuring

可視時間長度可能的選項。

列舉
AVERAGE_VIEW_DURATION_UNSPECIFIED 這個列舉只是預留位置,未指定任何平均觀看時間選項。
AVERAGE_VIEW_DURATION_5_SEC 指定網站和應用程式廣告空間,將 100% 的可視時間長度最大化 5 秒以上。
AVERAGE_VIEW_DURATION_10_SEC 指定網站和應用程式廣告空間,盡量將 100% 的可視時間長度最大化 10 秒以上。
AVERAGE_VIEW_DURATION_15_SEC 指定網站和應用程式廣告空間,盡量將 100% 的可視時間長度最大化 15 秒以上。

VideoViewability

DoubleVerify 影片可視度設定的詳細資料。

JSON 表示法
{
  "videoIab": enum (VideoIAB),
  "videoViewableRate": enum (VideoViewableRate),
  "playerImpressionRate": enum (PlayerImpressionRate)
}
欄位
videoIab

enum (VideoIAB)

指定網站廣告空間,以盡量提高 IAB 可視率。

videoViewableRate

enum (VideoViewableRate)

指定網站廣告空間,盡量提高完整可視率。

playerImpressionRate

enum (PlayerImpressionRate)

指定廣告空間,在 400x300 以上的播放器大小盡可能增加曝光。

VideoIAB

IAB 可視率可能選項。

列舉
VIDEO_IAB_UNSPECIFIED 這個列舉只是預留位置,不會指定任何影片 IAB 可視率選項。
IAB_VIEWABILITY_80_PERCENT_HIGHER 指定網站和應用程式廣告空間,將 IAB 可視率提高 80% 以上。
IAB_VIEWABILITY_75_PERCENT_HIGHER 指定網站和應用程式廣告空間,將 IAB 可視率提高 75% 以上。
IAB_VIEWABILITY_70_PERCENT_HIGHER 指定網站和應用程式廣告空間,將 IAB 可視率提高 70% 以上。
IAB_VIEWABILITY_65_PERCENT_HIHGER 指定網站和應用程式廣告空間,將 IAB 可視率提高 65% 以上。
IAB_VIEWABILITY_60_PERCENT_HIGHER 指定網站和應用程式廣告空間,將 IAB 可視率提高 60% 以上。
IAB_VIEWABILITY_55_PERCENT_HIHGER 指定網站和應用程式廣告空間,將 IAB 可視率提高 55% 以上。
IAB_VIEWABILITY_50_PERCENT_HIGHER 指定網站和應用程式廣告空間,將 IAB 可視率提高 50% 以上。
IAB_VIEWABILITY_40_PERCENT_HIHGER 指定網站和應用程式廣告空間,將 IAB 可視率提高 40% 以上。
IAB_VIEWABILITY_30_PERCENT_HIHGER 指定網站和應用程式廣告空間,將 IAB 可視率提高 30% 以上。

VideoViewableRate

完整可視率的可能選項。

列舉
VIDEO_VIEWABLE_RATE_UNSPECIFIED 這個列舉只是預留位置,不會指定任何影片可視率選項。
VIEWED_PERFORMANCE_40_PERCENT_HIGHER 指定網站廣告空間,將完整可視率提高 40% 以上。
VIEWED_PERFORMANCE_35_PERCENT_HIGHER 指定網站廣告空間,將完整可視率提高 35% 以上。
VIEWED_PERFORMANCE_30_PERCENT_HIGHER 指定網站廣告空間,將完整可視率提高 30% 以上。
VIEWED_PERFORMANCE_25_PERCENT_HIGHER 指定網站廣告空間,將完整可視率提高 25% 以上。
VIEWED_PERFORMANCE_20_PERCENT_HIGHER 指定網站廣告空間,將完整可視率提高 20% 以上。
VIEWED_PERFORMANCE_10_PERCENT_HIGHER 指定網站廣告空間,將完整可視率提高 10% 以上。

PlayerImpressionRate

可能的曝光選項。

列舉
PLAYER_SIZE_400X300_UNSPECIFIED 這個列舉只是預留位置,不會指定任何曝光選項。
PLAYER_SIZE_400X300_95 曝光次數達 95%的網站。
PLAYER_SIZE_400X300_70 曝光次數達 70%的網站。
PLAYER_SIZE_400X300_25 曝光次數超過 25%的網站。
PLAYER_SIZE_400X300_5 曝光次數超過 5%的網站。

FraudInvalidTraffic

DoubleVerify 詐欺和無效流量設定。

JSON 表示法
{
  "avoidedFraudOption": enum (FraudOption),
  "avoidInsufficientOption": boolean
}
欄位
avoidedFraudOption

enum (FraudOption)

避免使用有詐欺和 IVT 記錄的網站和應用程式。

avoidInsufficientOption

boolean

詐欺和無效流量統計資料記錄不足。

FraudOption

歷來詐欺和無效流量比率可能的選項。

列舉
FRAUD_UNSPECIFIED 這個列舉只是預留位置,並未指定任何詐欺和無效流量選項。
AD_IMPRESSION_FRAUD_100 100% 詐欺和無效流量
AD_IMPRESSION_FRAUD_50 詐欺和 IVT 率達 50% 以上。
AD_IMPRESSION_FRAUD_25 詐欺和 IVT 率達 25% 以上。
AD_IMPRESSION_FRAUD_10 詐欺和 IVT 率達 10% 以上。
AD_IMPRESSION_FRAUD_8 詐欺和 IVT 率達 8% 以上。
AD_IMPRESSION_FRAUD_6 詐欺和 IVT 率達 6% 以上。
AD_IMPRESSION_FRAUD_4 詐欺和 IVT 率達 4% 以上。
AD_IMPRESSION_FRAUD_2 詐欺和 IVT 率達 2% 以上。

IntegralAdScience

Integral Ad Science 設定的詳細資料。

JSON 表示法
{
  "traqScoreOption": enum (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ]
}
欄位
traqScoreOption

enum (TRAQScore)

真實廣告品質 (僅適用於多媒體廣告委刊項)。

excludeUnrateable

boolean

品牌安全 - 無法分級

excludedAdultRisk

enum (Adult)

品牌安全 - 成人內容

excludedAlcoholRisk

enum (Alcohol)

品牌安全 - 酒精飲料

excludedIllegalDownloadsRisk

enum (IllegalDownloads)

品牌安全 - 非法下載內容

excludedDrugsRisk

enum (Drugs)

品牌安全 - 藥物

excludedHateSpeechRisk

enum (HateSpeech)

品牌安全 - 仇恨言論

excludedOffensiveLanguageRisk

enum (OffensiveLanguage)

品牌安全 - 令人反感的用語

excludedViolenceRisk

enum (Violence)

品牌安全 - 暴力

excludedGamblingRisk

enum (Gambling)

品牌安全 - 賭博

excludedAdFraudRisk

enum (AdFraudPrevention)

廣告詐欺設定。

displayViewability

enum (DisplayViewability)

多媒體「可視度」部分 (僅適用於多媒體委刊項)。

videoViewability

enum (VideoViewability)

影片可視度部分 (僅適用於影片委刊項)。

customSegmentId[]

string (int64 format)

Integral Ad Science 提供的自訂區隔 ID。ID 必須介於 10000011999999 之間 (含頭尾)。

TRAQScore

可能的 Integral Ad Science TRAQ (真正廣告品質) 分數範圍。

列舉
TRAQ_UNSPECIFIED 這個列舉只是預留位置,不會指定任何真正的廣告品質分數。
TRAQ_250 TRAQ 分數 250-1000。
TRAQ_500 TRAQ 分數 500-1000。
TRAQ_600 TRAQ 分數 600-1000。
TRAQ_700 TRAQ 分數:700-1000。
TRAQ_750 TRAQ 分數為 750-1000。
TRAQ_875 TRAQ 分數為 875-1000。
TRAQ_1000 TRAQ 分數為 1000。

Adult

可能的 Integral Ad Science 成人選項。

列舉
ADULT_UNSPECIFIED 這個列舉只是預留位置,並未指定任何成人選項。
ADULT_HR 成人 - 排除高度風險。
ADULT_HMR 成人 - 排除中度與高度風險。

酒精飲料

可能的 Integral Ad Science 酒精飲料選項。

列舉
ALCOHOL_UNSPECIFIED 此列舉只是預留位置,未指定任何酒精飲料選項。
ALCOHOL_HR 酒精飲料 - 排除高度風險。
ALCOHOL_HMR 酒精飲料 - 排除中度與高度風險。

IllegalDownloads

可能的 Integral Ad Science Illegal 下載選項。

列舉
ILLEGAL_DOWNLOADS_UNSPECIFIED 這個列舉只是預留位置,不會指定任何無效的下載選項。
ILLEGAL_DOWNLOADS_HR 非法下載 - 排除高度風險。
ILLEGAL_DOWNLOADS_HMR 非法下載 - 排除中度與中度風險。

藥物

可能的 Integral Ad Science 藥物選項。

列舉
DRUGS_UNSPECIFIED 本列舉只是預留位置,並未指定任何藥物選項。
DRUGS_HR 藥物 - 排除高度風險。
DRUGS_HMR 毒品 - 排除中度與高度風險。

HateSpeech

可能的 Integral Ad Science 仇恨言論選項。

列舉
HATE_SPEECH_UNSPECIFIED 這個列舉只是預留位置,並未指定任何仇恨言論選項。
HATE_SPEECH_HR 仇恨言論 - 排除高度風險。
HATE_SPEECH_HMR 仇恨言論 - 排除中度與高度風險。

OffensiveLanguage

可能的 Integral Ad Science 令人反感的語言選項。

列舉
OFFENSIVE_LANGUAGE_UNSPECIFIED 這個列舉只是預留位置,未指定任何語言選項。
OFFENSIVE_LANGUAGE_HR 令人反感的用語 - 排除高度風險。
OFFENSIVE_LANGUAGE_HMR 令人反感的用語 - 排除中度與中度風險。

暴力

可能的 Integral Ad Science 暴力選項。

列舉
VIOLENCE_UNSPECIFIED 這個列舉只是預留位置,並未指定任何暴力選項。
VIOLENCE_HR 暴力 - 排除高度風險。
VIOLENCE_HMR 暴力 - 排除高度與中度風險。

賭博

可能的 Integral Ad Science 賭博選項。

列舉
GAMBLING_UNSPECIFIED 這個列舉只是預留位置,並未指定任何賭博選項。
GAMBLING_HR 賭博 - 排除高度風險。
GAMBLING_HMR 賭博 - 排除中度與中度風險。

AdFraudPrevention

可能的 Integral Ad Science 廣告詐欺防範選項。

列舉
SUSPICIOUS_ACTIVITY_UNSPECIFIED 這個列舉只是預留位置,並未指定任何廣告詐欺防範選項。
SUSPICIOUS_ACTIVITY_HR 廣告詐欺 - 排除高度風險。
SUSPICIOUS_ACTIVITY_HMR 廣告詐欺 - 排除中度與中度風險。

DisplayViewability

可能的 Integral Ad Science 多媒體廣告可視度選項。

列舉
PERFORMANCE_VIEWABILITY_UNSPECIFIED 這個列舉只是預留位置,不會指定任何多媒體廣告可視度選項。
PERFORMANCE_VIEWABILITY_40 指定 40% 以上的可視度。
PERFORMANCE_VIEWABILITY_50 指定 50% 以上的可視度。
PERFORMANCE_VIEWABILITY_60 指定 60% 以上的可視度。
PERFORMANCE_VIEWABILITY_70 指定 70% 以上的可視度。

VideoViewability

可能的 Integral Ad Science 影片可視度選項。

列舉
VIDEO_VIEWABILITY_UNSPECIFIED 這個列舉只是預留位置,不會指定任何影片可視度選項。
VIDEO_VIEWABILITY_40 觀看率 40%以上 (依 IAB 影片可視度標準定義)。
VIDEO_VIEWABILITY_50 觀看率 50%以上 (依 IAB 影片可視度標準定義)。
VIDEO_VIEWABILITY_60 觀看率 60%以上 (依 IAB 影片可視度標準定義)。
VIDEO_VIEWABILITY_70 觀看率 70%以上 (依 IAB 影片可視度標準定義)。

PoiAssignedTargetingOptionDetails

指定搜尋點指定選項的詳細資料。當 targetingTypeTARGETING_TYPE_POI 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

JSON 表示法
{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
欄位
displayName

string

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

targetingOptionId

string

必要欄位。TARGETING_TYPE_POI 類型的 TargetingOptiontargetingOptionId

您可以使用 SearchTargetingOptions 擷取已接受的搜尋點指定目標選項 ID。

如果指定的經緯度座標已從地址或搜尋點名稱中移除,您可以將所需的座標值四捨五入至第 6 位數,移除小數,然後串連以半形分號分隔的字串值,藉此產生必要的指定選項 ID。舉例來說,您可以使用指定選項 ID「40741469;-74003387」來指定 40.7414691, -74.003387 的經緯度組合。

latitude

number

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

longitude

number

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

proximityRadiusAmount

number

必要欄位。指定搜尋點周圍區域的半徑。半徑單位是由 proximityRadiusUnit 指定。如果單位為 DISTANCE_UNIT_KILOMETERS,必須為 1 到 800;如果單位為 DISTANCE_UNIT_MILES,則為 1 至 500。

proximityRadiusUnit

enum (DistanceUnit)

必要欄位。測量指定半徑的距離單位。

DistanceUnit

可能的距離單位選項。

列舉
DISTANCE_UNIT_UNSPECIFIED 未指定類型值,或這個版本中的類型值不明。
DISTANCE_UNIT_MILES 英里。
DISTANCE_UNIT_KILOMETERS

BusinessChainAssignedTargetingOptionDetails

指定連鎖店指定目標選項的詳細資料。當 targetingTypeTARGETING_TYPE_BUSINESS_CHAIN 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

JSON 表示法
{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
欄位
displayName

string

僅供輸出。連鎖店的顯示名稱,例如「肯德基」(KFC)、「Chase Bank」。

targetingOptionId

string

必要欄位。TARGETING_TYPE_BUSINESS_CHAIN 類型的 TargetingOptiontargetingOptionId

您可以使用 SearchTargetingOptions 擷取系統接受的連鎖店指定目標選項 ID。

proximityRadiusAmount

number

必要欄位。指定連鎖店的半徑範圍。半徑單位是由 proximityRadiusUnit 指定。如果單位為 DISTANCE_UNIT_KILOMETERS,必須為 1 到 800;如果單位為 DISTANCE_UNIT_MILES,則為 1 至 500。兩個情況的最低遞增值為 0.1。如果輸入的值太精細,系統會將其四捨五入至最接近的可接受的值,例如 15.57 會變成 15.6。

proximityRadiusUnit

enum (DistanceUnit)

必要欄位。測量指定半徑的距離單位。

ContentDurationAssignedTargetingOptionDetails

「指定內容時間長度」指定目標選項的詳細資料。當 targetingTypeTARGETING_TYPE_CONTENT_DURATION 時,系統會在 contentDurationDetails 欄位中填入這項資訊。不支援明確指定所有選項。如要達到這項效果,請移除所有指定內容時間長度指定目標選項。

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

string

必要欄位。targetingTypeTARGETING_TYPE_CONTENT_DURATION 時,targetingOptionId 欄位。

contentDuration

enum (ContentDuration)

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

ContentStreamTypeAssignedTargetingOptionDetails

內容串流類型指派指定目標選項的詳細資料。當 targetingTypeTARGETING_TYPE_CONTENT_STREAM_TYPE 時,系統會在 contentStreamTypeDetails 欄位中填入這項資訊。不支援明確指定所有選項。為了達到此效果,請移除所有內容串流類型指定選項。

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

string

必要欄位。targetingTypeTARGETING_TYPE_CONTENT_STREAM_TYPE 時,targetingOptionId 欄位。

contentStreamType

enum (ContentStreamType)

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

NativeContentPositionAssignedTargetingOptionDetails

原生內容位置指派選項詳細資料。當 targetingTypeTARGETING_TYPE_NATIVE_CONTENT_POSITION 時,系統會在 nativeContentPositionDetails 欄位中填入這項資訊。不支援明確指定所有選項。如果不想這麼做,請移除所有原生內容位置指定目標選項。

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

string

必要欄位。targetingTypeTARGETING_TYPE_NATIVE_CONTENT_POSITION 時,targetingOptionId 欄位。

contentPosition

enum (NativeContentPosition)

內容位置。

僅在 v1 中輸出。第 2 版的必要元素,

OmidAssignedTargetingOptionDetails

代表已啟用 Open Measurement 的廣告空間類型。當 targetingTypeTARGETING_TYPE_OMID 時,這個欄位會填入 Assign TargetingOption 的詳細資料欄位。

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

enum (Omid)

已啟用 Open Measurement 的廣告空間類型。

僅在 v1 中輸出。第 2 版的必要元素,

targetingOptionId

string

必要欄位。TARGETING_TYPE_OMID 類型的 TargetingOptiontargetingOptionId

AudioContentTypeAssignedTargetingOptionDetails

音訊內容類型指派選項的詳細資料。當 targetingTypeTARGETING_TYPE_AUDIO_CONTENT_TYPE 時,系統會在 audioContentTypeDetails 欄位中填入這項資訊。不支援明確指定所有選項。請移除所有音訊內容類型指定目標選項,才能達到此效果。

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

string

必要欄位。targetingTypeTARGETING_TYPE_AUDIO_CONTENT_TYPE 時,targetingOptionId 欄位。

audioContentType

enum (AudioContentType)

音訊內容類型。

僅在 v1 中輸出。第 2 版的必要元素,

ContentGenreAssignedTargetingOptionDetails

指定內容類型指派選項的詳細資料。當 targetingTypeTARGETING_TYPE_CONTENT_GENRE 時,系統會在 contentGenreDetails 欄位中填入這項資訊。不支援明確指定所有選項。請移除所有內容類型指定目標選項,才能達到此效果。

JSON 表示法
{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}
欄位
targetingOptionId

string

必要欄位。targetingTypeTARGETING_TYPE_CONTENT_GENRE 時,targetingOptionId 欄位。

displayName

string

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

negative

boolean

指出這個選項是否為排除指定。

方法

get

為廣告活動指派一個指定目標選項。

list

可根據特定指定類型,列出指派給廣告活動的指定目標選項。