- 資源:Assign TargetingOption
- JSON 表示法
- 繼承
- ChannelAssignedTargetingOptionDetails
- AppCategoryAssignedTargetingOptionDetails
- AppAssignedTargetingOptionDetails
- AppPlatform
- UrlAssignedTargetingOptionDetails
- DayAndTimeAssignedTargetingOptionDetails
- DayOfWeek
- TimeZoneResolution
- AgeRangeAssignedTargetingOptionDetails
- RegionalLocationListAssignedTargetingOptionDetails
- ProximityLocationListAssignedTargetingOptionDetails
- ProximityRadiusUnit
- GenderAssignedTargetingOptionDetails
- VideoPlayerSizeAssignedTargetingOptionDetails
- UserRewardedContentAssignedTargetingOptionDetails
- ParentalStatusAssignedTargetingOptionDetails
- ContentInstreamPositionAssignedTargetingOptionDetails
- AdType
- ContentOutstreamPositionAssignedTargetingOptionDetails
- DeviceTypeAssignedTargetingOptionDetails
- AudienceGroupAssignedTargetingOptionDetails
- FirstAndThirdPartyAudienceGroup
- FirstAndThirdPartyAudienceTargetingSetting
- 回訪率
- GoogleAudienceGroup
- GoogleAudienceTargetingSetting
- CustomListGroup
- CustomListTargetingSetting
- CombinedAudienceGroup
- CombinedAudienceTargetingSetting
- BrowserAssignedTargetingOptionDetails
- HouseholdIncomeAssignedTargetingOptionDetails
- OnScreenPositionAssignedTargetingOptionDetails
- CarrierAndIspAssignedTargetingOptionDetails
- KeywordAssignedTargetingOptionDetails
- NegativeKeywordListAssignedTargetingOptionDetails
- OperatingSystemAssignedTargetingOptionDetails
- DeviceMakeModelAssignedTargetingOptionDetails
- EnvironmentAssignedTargetingOptionDetails
- InventorySourceAssignedTargetingOptionDetails
- CategoryAssignedTargetingOptionDetails
- ViewabilityAssignedTargetingOptionDetails
- AuthorizedSellerStatusAssignedTargetingOptionDetails
- LanguageAssignedTargetingOptionDetails
- GeoRegionAssignedTargetingOptionDetails
- InventorySourceGroupAssignedTargetingOptionDetails
- DigitalContentLabelAssignedTargetingOptionDetails
- SensitiveCategoryAssignedTargetingOptionDetails
- ExchangeAssignedTargetingOptionDetails
- SubExchangeAssignedTargetingOptionDetails
- ThirdPartyVerifierAssignedTargetingOptionDetails
- Adloox
- AdlooxCategory
- DoubleVerify
- BrandSafetyCategories
- HighSeverityCategory
- MediumSeverityCategory
- AgeRating
- AppStarRating
- StarRating
- DisplayViewability
- IAB
- ViewableDuring
- VideoViewability
- VideoIAB
- VideoViewableRate
- PlayerImpressionRate
- FraudInvalidTraffic
- FraudOption
- IntegralAdScience
- TRAQScore
- 成人
- 酒精飲料
- IllegalDownloads
- 藥物
- HateSpeech
- OffensiveLanguage
- 暴力內容
- 賭博
- AdFraudPrevention
- DisplayViewability
- VideoViewability
- PoiAssignedTargetingOptionDetails
- DistanceUnit
- BusinessChainAssignedTargetingOptionDetails
- ContentDurationAssignedTargetingOptionDetails
- ContentStreamTypeAssignedTargetingOptionDetails
- NativeContentPositionAssignedTargetingOptionDetails
- OmidAssignedTargetingOptionDetails
- AudioContentTypeAssignedTargetingOptionDetails
- ContentGenreAssignedTargetingOptionDetails
- YoutubeVideoAssignedTargetingOptionDetails
- YoutubeChannelAssignedTargetingOptionDetails
- SessionPositionAssignedTargetingOptionDetails
- SessionPosition
- 方法
資源:Assign TargetingOption
單一指派的指定目標選項,可為採用指定目標設定的實體定義指定目標選項的狀態。
JSON 表示法 |
---|
{ "name": string, "assignedTargetingOptionId": string, "assignedTargetingOptionIdAlias": string, "targetingType": enum ( |
欄位 | |
---|---|
name |
僅供輸出。這個指派指定目標選項的資源名稱。 |
assignedTargetingOptionId |
僅供輸出。所指定指定目標選項的專屬 ID。此 ID 在特定資源和指定類型中不得重複。在其他情況下可能會重複使用。 |
assignedTargetingOptionIdAlias |
僅供輸出。 只有下列指定類型的所有指派指定目標選項都支援這個欄位:
下列指定類型的委刊項指定目標選項也同樣支援這個欄位:
|
targetingType |
僅供輸出。表示這個指定指定目標選項的類型。 |
inheritance |
僅供輸出。所指派指定目標選項的沿用狀態。 |
聯集欄位 details 。指定目標選項的詳細資訊。詳細資料中的一個欄位只能填入一個欄位,而且該欄位必須對應至 targeting_type ;details 只能採用下列其中一種做法: |
|
channelDetails |
頻道詳細資料。如果 |
appCategoryDetails |
應用程式類別詳細資料。如果 |
appDetails |
應用程式詳細資料。如果 |
urlDetails |
網址詳細資料。如果 |
dayAndTimeDetails |
日期和時間詳細資料。如果 |
ageRangeDetails |
年齡層詳細資料。如果 |
regionalLocationListDetails |
區域位置清單詳細資料。如果 |
proximityLocationListDetails |
鄰近位置清單詳細資料。如果 |
genderDetails |
性別詳細資料。如果 |
videoPlayerSizeDetails |
影片播放器大小詳細資料。如果 |
userRewardedContentDetails |
使用者獎勵內容詳細資料。如果 |
parentalStatusDetails |
家長狀態詳情。如果 |
contentInstreamPositionDetails |
內容串流內位置詳細資料。如果 |
contentOutstreamPositionDetails |
內容串流外位置詳細資料。如果 |
deviceTypeDetails |
裝置類型詳細資料。如果 |
audienceGroupDetails |
指定目標對象詳細資料。如果 |
browserDetails |
瀏覽器詳細資料。如果 |
householdIncomeDetails |
家庭收入詳細資料。如果 |
onScreenPositionDetails |
畫面上的位置詳細資料。如果 |
carrierAndIspDetails |
電信業者和網際網路服務供應商 (ISP) 的詳細資料。如果 |
keywordDetails |
關鍵字詳情。如果 每項資源最多可指派 5,000 個直接排除關鍵字。可指派的正面關鍵字數量沒有限制。 |
negativeKeywordListDetails |
關鍵字詳情。如果 最多只能將 4 份排除關鍵字清單指派給資源。 |
operatingSystemDetails |
作業系統詳細資料。如果 |
deviceMakeModelDetails |
裝置品牌和型號詳細資料。如果 |
environmentDetails |
環境詳細資料。如果 |
inventorySourceDetails |
廣告空間來源詳細資料。如果 |
categoryDetails |
類別詳細資料。如果 此外,指定該類別也會指定其子類別。如果某類別已從指定目標中排除,且已納入子類別,系統將優先採用排除設定。 |
viewabilityDetails |
可視度詳細資料。如果 每個資源只能指定一個可視度選項。 |
authorizedSellerStatusDetails |
授權賣方狀態詳細資料。如果 每個資源只能指定一個授權賣方狀態選項。 如果資源沒有授權賣家狀態選項,系統預設會指定 ads.txt 檔案中標示為 DIRECT 或 RESELLER 的所有授權賣方。 |
languageDetails |
語言詳細資料。如果 |
geoRegionDetails |
地理區域詳細資料。如果 |
inventorySourceGroupDetails |
廣告空間來源群組詳細資料。如果 |
digitalContentLabelExclusionDetails |
數位內容標籤詳細資料。如果 數位內容標籤是指定排除條件。廣告客戶層級的數位內容標籤排除條件 (如有設定) 一律會在放送時套用 (即使系統未顯示在資源設定中也是如此)。除了廣告主排除項目之外,資源設定也可以排除內容標籤,但無法覆寫。如果排除所有數位內容標籤,委刊項就不會放送。 |
sensitiveCategoryExclusionDetails |
敏感類別詳細資料。如果 敏感類別是指定排除條件。廣告客戶層級的敏感類別排除條件 (如有設定) 一律會用於放送 (即使系統不會顯示在資源設定中)。除了廣告客戶排除項目外,資源設定還可以排除敏感類別,但無法覆寫。 |
exchangeDetails |
廣告交易平台詳細資料。如果 |
subExchangeDetails |
子廣告交易平台詳細資料。如果 |
thirdPartyVerifierDetails |
第三方驗證詳細資料。如果 |
poiDetails |
搜尋點詳細資料。如果 |
businessChainDetails |
商家連鎖店詳細資料。如果 |
contentDurationDetails |
內容時間長度詳細資料。如果 |
contentStreamTypeDetails |
內容時間長度詳細資料。當指定類型為 |
nativeContentPositionDetails |
原生內容位置詳細資料。如果 |
omidDetails |
已啟用 Open Measurement 的廣告空間詳細資料。如果 |
audioContentTypeDetails |
音訊內容類型詳細資料。如果 |
contentGenreDetails |
內容類型詳細資料。如果 |
youtubeVideoDetails |
YouTube 影片詳細資料。如果 |
youtubeChannelDetails |
YouTube 頻道詳細資料。如果 |
sessionPositionDetails |
工作階段排名詳細資料。如果 |
繼承
表示指派的指定目標選項是沿用自較高層級的實體 (例如合作夥伴或廣告主)。繼承指派的指定目標選項會優先採用,而且一律會套用至目前層級指派的指定目標,而且無法透過目前的實體服務修改。如要修改這些欄位,請透過沿用其來源的實體服務。只有在排除指定頻道、敏感類別排除條件和數位內容標籤排除條件必須在上層層級設定,沿用才會沿用上層聯播網設定。
列舉 | |
---|---|
INHERITANCE_UNSPECIFIED |
繼承未指定或不明。 |
NOT_INHERITED |
指派的指定目標選項不會沿用自較高層級實體。 |
INHERITED_FROM_PARTNER |
指派的指定目標選項會沿用夥伴指定目標設定。 |
INHERITED_FROM_ADVERTISER |
指派的指定目標選項會沿用廣告主的指定目標設定。 |
ChannelAssignedTargetingOptionDetails
指派管道指定選項的詳細資料。當 targetingType
為 TARGETING_TYPE_CHANNEL
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{ "channelId": string, "negative": boolean } |
欄位 | |
---|---|
channelId |
|
negative |
表示該選項是否為排除指定。如為廣告主層級指派的指定目標選項,這個欄位必須設為 true。 |
AppCategoryAssignedTargetingOptionDetails
指派應用程式類別指定選項的詳細資料。當 targetingType
為 TARGETING_TYPE_APP_CATEGORY
時,系統就會在 Assign TargetingOption 的 appCategoryDetails
欄位中填入這項資訊。
JSON 表示法 |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
欄位 | |
---|---|
displayName |
僅供輸出。應用程式類別的顯示名稱。 |
targetingOptionId |
必要欄位。 |
negative |
表示該選項是否為排除指定。 |
AppAssignedTargetingOptionDetails
指派應用程式指定選項的詳細資料。當 targetingType
為 TARGETING_TYPE_APP
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{
"appId": string,
"displayName": string,
"negative": boolean,
"appPlatform": enum ( |
欄位 | |
---|---|
appId |
必要欄位。應用程式的 ID。 Android 的 Play 商店應用程式會使用軟體包 ID,例如 |
displayName |
僅供輸出。應用程式的顯示名稱。 |
negative |
表示該選項是否為排除指定。 |
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 |
應用程式平台是未明確列出的連網電視平台。 |
APP_PLATFORM_LG_TV |
應用程式平台是 LG TV。 |
APP_PLATFORM_VIZIO_TV |
應用程式平台是 VIZIO TV。 |
UrlAssignedTargetingOptionDetails
指派網址指定選項的詳細資料。當 targetingType
為 TARGETING_TYPE_URL
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{ "url": string, "negative": boolean } |
欄位 | |
---|---|
url |
必要欄位。網址,例如 DV360 支援兩個層級的子目錄指定功能 (例如 |
negative |
表示該選項是否為排除指定。 |
DayAndTimeAssignedTargetingOptionDetails
代表一週內特定一天定義的一段時間,以及開始和結束時間。startHour
表示的時間必須早於 endHour
表示的時間。
JSON 表示法 |
---|
{ "dayOfWeek": enum ( |
欄位 | |
---|---|
dayOfWeek |
必要欄位。指定的日期和時間設定在星期幾。 |
startHour |
必要欄位。指定日期和時間的開始小時。必須介於 0 (一天的開始日期) 到 23 (一天結束前 1 小時) 之間。 |
endHour |
必要欄位。指定日期和時間的結束小時。這個值必須介於 1 (一天開始時間後 1 小時) 到 24 (當天結束) 之間。 |
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
代表可指定的年齡層。當 targetingType
為 TARGETING_TYPE_AGE_RANGE
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{
"ageRange": enum ( |
欄位 | |
---|---|
ageRange |
必要欄位。目標對象的年齡層。我們只支援指定固定年齡層的目標對象,因此,這個欄位中顯示的年齡層可僅 1) 指定,或 2) 屬於較大連續年齡層的一部分。您也可指定年齡不明的目標對象,藉此擴展持續指定年齡層的觸及範圍。 |
RegionalLocationListAssignedTargetingOptionDetails
區域地點清單的指定目標詳情。當 targetingType
為 TARGETING_TYPE_REGIONAL_LOCATION_LIST
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{ "regionalLocationListId": string, "negative": boolean } |
欄位 | |
---|---|
regionalLocationListId |
必要欄位。區域地點清單的 ID。應參照類型為 |
negative |
表示該選項是否為排除指定。 |
ProximityLocationListAssignedTargetingOptionDetails
鄰近地點清單的指定目標詳情。當 targetingType
為 TARGETING_TYPE_PROXIMITY_LOCATION_LIST
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{
"proximityLocationListId": string,
"proximityRadius": number,
"proximityRadiusUnit": enum ( |
欄位 | |
---|---|
proximityLocationListId |
必要欄位。鄰近地點清單的 ID。應參照類型為 |
proximityRadius |
必要欄位。以 |
proximityRadiusUnit |
必要欄位。半徑距離單位。 |
ProximityRadiusUnit
ProximityRadius 的距離單位列舉。
列舉 | |
---|---|
PROXIMITY_RADIUS_UNIT_UNSPECIFIED |
這個版本未指定距離單位時的預設值。這個列舉是預設值的預留位置,不代表實際距離單位。 |
PROXIMITY_RADIUS_UNIT_MILES |
半徑距離單位,以英里為單位。 |
PROXIMITY_RADIUS_UNIT_KILOMETERS |
半徑距離單位 (公里) |
GenderAssignedTargetingOptionDetails
指派的指定性別選項詳細資料。當 targetingType
為 TARGETING_TYPE_GENDER
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{
"gender": enum ( |
欄位 | |
---|---|
gender |
必要欄位。目標對象的性別。 |
VideoPlayerSizeAssignedTargetingOptionDetails
影片播放器大小指定目標選項詳細資料。如果 targetingType
是 TARGETING_TYPE_VIDEO_PLAYER_SIZE
,這個欄位就會填入 videoPlayerSizeDetails
欄位。不支援明確指定所有選項。如要達到這項效果,請移除所有影片播放器大小指定目標選項。
JSON 表示法 |
---|
{
"videoPlayerSize": enum ( |
欄位 | |
---|---|
videoPlayerSize |
必要欄位。影片播放器大小。 |
UserRewardedContentAssignedTargetingOptionDetails
使用者獎勵內容指定目標選項詳細資料。如果 targetingType
是 TARGETING_TYPE_USER_REWARDED_CONTENT
,這個欄位就會填入 userRewardedContentDetails
欄位。
JSON 表示法 |
---|
{
"targetingOptionId": string,
"userRewardedContent": enum ( |
欄位 | |
---|---|
targetingOptionId |
必要欄位。 |
userRewardedContent |
僅供輸出。影片廣告的使用者獎勵內容狀態。 |
ParentalStatusAssignedTargetingOptionDetails
指派的家長狀態指定目標選項詳細資料。當 targetingType
為 TARGETING_TYPE_PARENTAL_STATUS
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{
"parentalStatus": enum ( |
欄位 | |
---|---|
parentalStatus |
必要欄位。目標對象的家長狀態。 |
ContentInstreamPositionAssignedTargetingOptionDetails
指派的內容串流內位置指定目標選項詳細資料。如果 targetingType
是 TARGETING_TYPE_CONTENT_INSTREAM_POSITION
,這個欄位就會填入 contentInstreamPositionDetails
欄位。
JSON 表示法 |
---|
{ "contentInstreamPosition": enum ( |
欄位 | |
---|---|
contentInstreamPosition |
必要欄位。影片或音訊廣告的內容串流內位置。 |
adType |
僅供輸出。要指定的廣告類型。根據預設,這個指定目標選項僅適用於廣告訂單指定目標,以及支援指定廣告類型的新委刊項。可能的值為:
|
AdType
代表與廣告相關聯的廣告素材類型。
列舉 | |
---|---|
AD_TYPE_UNSPECIFIED |
此版本未指定或未知的廣告類型。 |
AD_TYPE_DISPLAY |
多媒體廣告素材,例如圖片和 HTML5。 |
AD_TYPE_VIDEO |
影片廣告素材,例如:在影片播放器中串流內容期間放送的影片廣告。 |
AD_TYPE_AUDIO |
音訊廣告素材,例如在音訊內容期間播放的音訊廣告。 |
ContentOutstreamPositionAssignedTargetingOptionDetails
指派的內容串流外位置指定目標選項詳細資料。如果 targetingType
是 TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
,這個欄位就會填入 contentOutstreamPositionDetails
欄位。
JSON 表示法 |
---|
{ "contentOutstreamPosition": enum ( |
欄位 | |
---|---|
contentOutstreamPosition |
必要欄位。內容串流外位置。 |
adType |
僅供輸出。要指定的廣告類型。根據預設,這個指定目標選項僅適用於廣告訂單指定目標,以及支援指定廣告類型的新委刊項。可能的值為:
|
DeviceTypeAssignedTargetingOptionDetails
裝置類型的指定目標詳情。當 targetingType
為 TARGETING_TYPE_DEVICE_TYPE
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{
"deviceType": enum ( |
欄位 | |
---|---|
deviceType |
必要欄位。裝置類型的顯示名稱。 |
youtubeAndPartnersBidMultiplier |
僅供輸出。出價調節係數可讓您根據裝置類型調整廣告的放送頻率。然後套用原始出價金額的調節係數。如果這個欄位是 0,表示這個欄位不適用,而不是將原始出價金額乘以 0。 舉例來說,如果未設定調節係數的出價金額為 $10.0 美元,平板電腦的調節係數為 1.5,那麼平板電腦的最終出價會是 $15.0 美元。 僅適用於 YouTube 和合作夥伴委刊項。 |
AudienceGroupAssignedTargetingOptionDetails
已指派的指定目標對象群組指定目標選項詳細資料。當 targetingType
為 TARGETING_TYPE_AUDIENCE_GROUP
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。每個群組之間的關係為「UNION」,但 excludedFirstAndThirdPartyAudienceGroup 和 excludedGoogleAudienceGroup 除外,因為其中 COMPLEMENT 是與其他群組的 COMPLEMENT 使用。
JSON 表示法 |
---|
{ "includedFirstAndThirdPartyAudienceGroups": [ { object ( |
欄位 | |
---|---|
includedFirstAndThirdPartyAudienceGroups[] |
納入第一方和第三方目標對象群組的第一方和第三方目標對象 ID 和回訪率。每個第一方和第三方目標對象群組只能包含第一方和第三方目標對象 ID。每個第一方和第三方目標對象群組之間的關係為 NG,結果是 UNION 與其他目標對象群組的關係。系統會忽略具有相同設定的重複群組。 |
includedGoogleAudienceGroup |
已納入 Google 目標對象群組的 Google 目標對象 ID。只包含 Google 目標對象 ID。 |
includedCustomListGroup |
納入的自訂名單群組的自訂名單 ID。只包含自訂清單 ID。 |
includedCombinedAudienceGroup |
已納入合併目標對象群組的合併目標對象 ID。只包含合併目標對象 ID。 |
excludedFirstAndThirdPartyAudienceGroup |
已排除的第一方和第三方目標對象群組的第一和第三方目標對象 ID 和頻率。用於排除指定目標。這個群組和其他排除目標對象群組的「組成」項目,可做為任何正面目標對象的「提案」。所有項目在邏輯上是「OR」。 |
excludedGoogleAudienceGroup |
已排除 Google 目標對象群組的 Google 目標對象 ID。用於排除指定目標。這個群組和其他排除目標對象群組的「組成」項目,可做為任何正面目標對象的「提案」。只包含「興趣相似目標對象」、「潛在目標消費者」和「已安裝的應用程式」類型的 Google 目標對象。所有項目在邏輯上是「OR」。 |
FirstAndThirdPartyAudienceGroup
第一方和第三方目標對象群組的詳細資料。在邏輯上,所有第一方和第三方指定目標對象設定在邏輯上是「OR」。
JSON 表示法 |
---|
{
"settings": [
{
object ( |
欄位 | |
---|---|
settings[] |
必要欄位。在第一方和第三方目標對象群組中,所有的第一方和第三方指定目標對象設定。不可重複設定相同 ID 的設定。 |
FirstAndThirdPartyAudienceTargetingSetting
第一方和第三方指定目標對象設定的詳細資料。
JSON 表示法 |
---|
{
"firstAndThirdPartyAudienceId": string,
"recency": enum ( |
欄位 | |
---|---|
firstAndThirdPartyAudienceId |
必要欄位。第一方和第三方指定目標對象設定的第一方和第三方目標對象 ID。此 ID 為 |
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 ( |
欄位 | |
---|---|
settings[] |
必要欄位。Google 目標對象群組中的所有 Google 指定目標對象設定。系統會忽略 ID 相同的重複設定。 |
GoogleAudienceTargetingSetting
Google 指定目標對象設定的詳細資料。
JSON 表示法 |
---|
{ "googleAudienceId": string } |
欄位 | |
---|---|
googleAudienceId |
必要欄位。Google 指定目標對象設定的 Google 目標對象 ID。此 ID 為 |
CustomListGroup
自訂名單群組的詳細資料。所有自訂名單指定目標設定的邏輯都是「OR」。
JSON 表示法 |
---|
{
"settings": [
{
object ( |
欄位 | |
---|---|
settings[] |
必要欄位。自訂名單群組中的所有自訂名單指定目標設定。系統會忽略 ID 相同的重複設定。 |
CustomListTargetingSetting
自訂名單指定目標設定的詳細資料。
JSON 表示法 |
---|
{ "customListId": string } |
欄位 | |
---|---|
customListId |
必要欄位。自訂名單指定目標設定的自訂 ID。此 ID 為 |
CombinedAudienceGroup
合併目標對象群組的詳細資料。所有合併指定目標對象設定在邏輯上是「OR」。
JSON 表示法 |
---|
{
"settings": [
{
object ( |
欄位 | |
---|---|
settings[] |
必要欄位。合併目標對象群組中的所有合併指定目標對象設定。系統會忽略 ID 相同的重複設定。合併目標對象設定的數量不得超過 5 個,否則系統會擲回錯誤。 |
CombinedAudienceTargetingSetting
合併指定目標對象設定的詳細資料。
JSON 表示法 |
---|
{ "combinedAudienceId": string } |
欄位 | |
---|---|
combinedAudienceId |
必要欄位。合併指定目標對象設定的合併目標對象 ID。此 ID 為 |
BrowserAssignedTargetingOptionDetails
指派瀏覽器指定選項的詳細資料。當 targetingType
為 TARGETING_TYPE_BROWSER
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
欄位 | |
---|---|
displayName |
僅供輸出。瀏覽器的顯示名稱。 |
targetingOptionId |
必要欄位。 |
negative |
表示該選項是否為排除指定。同一個資源中所有指派的瀏覽器指定選項,必須在這個欄位填入相同的值。 |
HouseholdIncomeAssignedTargetingOptionDetails
指派家庭收入指定選項的詳細資料。當 targetingType
為 TARGETING_TYPE_HOUSEHOLD_INCOME
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{
"householdIncome": enum ( |
欄位 | |
---|---|
householdIncome |
必要欄位。目標對象的家庭收入。 |
OnScreenPositionAssignedTargetingOptionDetails
畫面上的指定目標選項詳細資料。如果 targetingType
是 TARGETING_TYPE_ON_SCREEN_POSITION
,這個欄位就會填入 onScreenPositionDetails
欄位。
JSON 表示法 |
---|
{ "targetingOptionId": string, "onScreenPosition": enum ( |
欄位 | |
---|---|
targetingOptionId |
必要欄位。 |
onScreenPosition |
僅供輸出。畫面位置。 |
adType |
僅供輸出。要指定的廣告類型。根據預設,這個指定目標選項僅適用於廣告訂單指定目標,以及支援指定廣告類型的新委刊項。可能的值為:
|
CarrierAndIspAssignedTargetingOptionDetails
指派的電信業者和網際網路服務供應商 (ISP) 指定選項詳細資料。當 targetingType
為 TARGETING_TYPE_CARRIER_AND_ISP
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
欄位 | |
---|---|
displayName |
僅供輸出。電信業者或網際網路服務供應商 (ISP) 的顯示名稱。 |
targetingOptionId |
必要欄位。 |
negative |
表示該選項是否為排除指定。同一個資源中所有指派的電信業者和網際網路服務供應商 (ISP) 指定選項,必須在這個欄位中使用相同的值。 |
KeywordAssignedTargetingOptionDetails
指派的關鍵字指定選項的詳細資料。當 targetingType
為 TARGETING_TYPE_KEYWORD
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{ "keyword": string, "negative": boolean } |
欄位 | |
---|---|
keyword |
必要欄位。關鍵字,例如 正面關鍵字不能是令人反感的字詞。必須使用 UTF-8 編碼,且大小上限為 255 個位元組。不得超過 80 個字元。字詞數量上限為 10 個。 |
negative |
表示該選項是否為排除指定。 |
NegativeKeywordListAssignedTargetingOptionDetails
排除關鍵字清單的指定目標詳情。當 targetingType
為 TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{ "negativeKeywordListId": string } |
欄位 | |
---|---|
negativeKeywordListId |
必要欄位。排除關鍵字清單的 ID。應參照 |
OperatingSystemAssignedTargetingOptionDetails
指派的作業系統指定目標選項詳細資料。如果 targetingType
是 TARGETING_TYPE_OPERATING_SYSTEM
,這個欄位就會填入 operatingSystemDetails
欄位。
JSON 表示法 |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
欄位 | |
---|---|
displayName |
僅供輸出。作業系統的顯示名稱。 |
targetingOptionId |
必要欄位。當 |
negative |
表示該選項是否為排除指定。 |
DeviceMakeModelAssignedTargetingOptionDetails
已指派的裝置製造商和型號指定選項詳細資料。如果 targetingType
是 TARGETING_TYPE_DEVICE_MAKE_MODEL
,這個欄位就會填入 deviceMakeModelDetails
欄位。
JSON 表示法 |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
欄位 | |
---|---|
displayName |
僅供輸出。裝置品牌和型號的顯示名稱。 |
targetingOptionId |
必要欄位。 |
negative |
表示該選項是否為排除指定。 |
EnvironmentAssignedTargetingOptionDetails
指派的環境指定目標選項詳細資料。當 targetingType
為 TARGETING_TYPE_ENVIRONMENT
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{
"environment": enum ( |
欄位 | |
---|---|
environment |
必要欄位。放送環境。 |
InventorySourceAssignedTargetingOptionDetails
廣告空間來源的指定目標詳細資料。當 targetingType
為 TARGETING_TYPE_INVENTORY_SOURCE
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{ "inventorySourceId": string } |
欄位 | |
---|---|
inventorySourceId |
必要欄位。廣告空間來源的 ID。應參照 |
CategoryAssignedTargetingOptionDetails
指派的指定類別選項詳細資料。如果 targetingType
是 TARGETING_TYPE_CATEGORY
,這個欄位就會填入 categoryDetails
欄位。
JSON 表示法 |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
欄位 | |
---|---|
displayName |
僅供輸出。類別的顯示名稱。 |
targetingOptionId |
必要欄位。 |
negative |
表示該選項是否為排除指定。 |
ViewabilityAssignedTargetingOptionDetails
指定的可視度指定目標選項詳細資料。當 targetingType
為 TARGETING_TYPE_VIEWABILITY
時,系統就會在 Assign TargetingOption 的 viewabilityDetails
欄位中填入這項資訊。
JSON 表示法 |
---|
{
"viewability": enum ( |
欄位 | |
---|---|
viewability |
必要欄位。預測可視度百分比。 |
AuthorizedSellerStatusAssignedTargetingOptionDetails
代表指派的授權賣方狀態。當 targetingType
為 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
如果資源沒有指定的 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
指定目標選項,則會使用「授權直接賣方和經銷商」選項。
JSON 表示法 |
---|
{
"authorizedSellerStatus": enum ( |
欄位 | |
---|---|
authorizedSellerStatus |
僅供輸出。要指定的授權賣方狀態。 |
targetingOptionId |
必要欄位。 |
LanguageAssignedTargetingOptionDetails
指定語言選項的詳細資料。當 targetingType
為 TARGETING_TYPE_LANGUAGE
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
欄位 | |
---|---|
displayName |
僅供輸出。語言的顯示名稱 (例如「法文」)。 |
targetingOptionId |
必要欄位。 |
negative |
表示該選項是否為排除指定。同一項資源的所有指定指定語言選項在這個欄位都必須使用相同的值。 |
GeoRegionAssignedTargetingOptionDetails
指派的指定地理區域選項詳細資料。當 targetingType
為 TARGETING_TYPE_GEO_REGION
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{
"displayName": string,
"targetingOptionId": string,
"geoRegionType": enum ( |
欄位 | |
---|---|
displayName |
僅供輸出。地理區域的顯示名稱 (例如「加拿大安大略省」)。 |
targetingOptionId |
必要欄位。 |
geoRegionType |
僅供輸出。指定地理區域的類型。 |
negative |
表示該選項是否為排除指定。 |
InventorySourceGroupAssignedTargetingOptionDetails
廣告空間來源群組的指定目標詳細資料。當 targetingType
為 TARGETING_TYPE_INVENTORY_SOURCE_GROUP
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{ "inventorySourceGroupId": string } |
欄位 | |
---|---|
inventorySourceGroupId |
必要欄位。廣告空間來源群組的 ID。應參照 |
DigitalContentLabelAssignedTargetingOptionDetails
數位內容標籤的指定目標詳情。當 targetingType
為 TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{
"excludedContentRatingTier": enum ( |
欄位 | |
---|---|
excludedContentRatingTier |
必要欄位。要排除的數位內容標籤分級等級顯示名稱。 |
SensitiveCategoryAssignedTargetingOptionDetails
敏感類別的指定目標詳情。當 targetingType
為 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{
"excludedSensitiveCategory": enum ( |
欄位 | |
---|---|
excludedSensitiveCategory |
必要欄位。此屬性列舉了歸類為「排除」的 DV360 敏感類別內容。 |
ExchangeAssignedTargetingOptionDetails
指派的廣告交易平台指定目標選項詳細資料。當 targetingType
為 TARGETING_TYPE_EXCHANGE
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{
"exchange": enum ( |
欄位 | |
---|---|
exchange |
必要欄位。交換的列舉值。 |
SubExchangeAssignedTargetingOptionDetails
指派的子廣告交易平台指定選項詳細資料。當 targetingType
為 TARGETING_TYPE_SUB_EXCHANGE
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{ "targetingOptionId": string } |
欄位 | |
---|---|
targetingOptionId |
必要欄位。 |
ThirdPartyVerifierAssignedTargetingOptionDetails
指派的第三方驗證服務供應商指定目標選項詳細資料。當 targetingType
為 TARGETING_TYPE_THIRD_PARTY_VERIFIER
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 verifier 。可指定其中一個第三方驗證者,為曝光強制執行品牌安全門檻。verifier 只能是下列其中一項: |
|
adloox |
第三方品牌驗證工具 -- Adloox。 |
doubleVerify |
第三方品牌驗證器 -- DoubleVerify。 |
integralAdScience |
第三方品牌驗證商 -- Integral Ad Science。 |
Adloox
Adloox 設定的詳細資料。
JSON 表示法 |
---|
{
"excludedAdlooxCategories": [
enum ( |
欄位 | |
---|---|
excludedAdlooxCategories[] |
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 |
DV 品牌安全控制選項。 |
avoidedAgeRatings[] |
避免對符合年齡分級的應用程式出價。 |
appStarRating |
避免對星級評等的應用程式出價。 |
displayViewability |
顯示可視度設定 (僅適用於多媒體委刊項)。 |
videoViewability |
影片可視度設定 (僅適用於影片委刊項)。 |
fraudInvalidTraffic |
避免指定有詐欺和無效流量率記錄的網站和應用程式。 |
customSegmentId |
DoubleVerify 提供的自訂區隔 ID。ID 必須以「51」開頭,並由八個數字組成。自訂區隔 ID 不能與下列任一欄位一起指定: |
BrandSafetyCategories
品牌安全控制選項設定。
JSON 表示法 |
---|
{ "avoidUnknownBrandSafetyCategory": boolean, "avoidedHighSeverityCategories": [ enum ( |
欄位 | |
---|---|
avoidUnknownBrandSafetyCategory |
不明或無法分級。 |
avoidedHighSeverityCategories[] |
品牌安全高嚴重性避開類別。 |
avoidedMediumSeverityCategories[] |
品牌安全中嚴重性避開類別。 |
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 ( |
欄位 | |
---|---|
avoidedStarRating |
避免對星級評等的應用程式出價。 |
avoidInsufficientStarRating |
避免對星級評等不足的應用程式出價。 |
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 |
指定網站和應用程式廣告空間,盡可能提高 IAB 可視率。 |
viewableDuring |
指定網站和應用程式廣告空間,盡可能延長 100% 的可視時間長度。 |
IAB
IAB 可視率可能的選項。
列舉 | |
---|---|
IAB_VIEWED_RATE_UNSPECIFIED |
此列舉只是預留位置,並未指定任何 IAB 觀看率選項。 |
IAB_VIEWED_RATE_80_PERCENT_HIGHER |
指定網站和應用程式廣告空間,盡可能提高 80% 以上的 IAB 可視率。 |
IAB_VIEWED_RATE_75_PERCENT_HIGHER |
指定網站和應用程式廣告空間,盡可能提高 75% 以上的 IAB 可視率。 |
IAB_VIEWED_RATE_70_PERCENT_HIGHER |
指定網站和應用程式廣告空間,盡可能提高 70% 以上的 IAB 可視率。 |
IAB_VIEWED_RATE_65_PERCENT_HIGHER |
指定網站和應用程式廣告空間,盡可能提高 65% 以上的 IAB 可視率。 |
IAB_VIEWED_RATE_60_PERCENT_HIGHER |
指定網站和應用程式廣告空間,盡可能提高 60% 以上的 IAB 可視率。 |
IAB_VIEWED_RATE_55_PERCENT_HIGHER |
指定網站和應用程式廣告空間,盡可能提高 55% 以上的 IAB 可視率。 |
IAB_VIEWED_RATE_50_PERCENT_HIGHER |
指定網站和應用程式廣告空間,讓 IAB 可視率提高 50% 以上。 |
IAB_VIEWED_RATE_40_PERCENT_HIGHER |
指定網站和應用程式廣告空間,盡可能提高 40% 以上的 IAB 可視率。 |
IAB_VIEWED_RATE_30_PERCENT_HIGHER |
指定網站和應用程式廣告空間,盡可能提高 30% 以上的 IAB 可視率。 |
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 |
指定網站廣告空間,盡量提高 IAB 可視率。 |
videoViewableRate |
指定網站廣告空間,盡量提高完整可視率。 |
playerImpressionRate |
指定廣告空間以盡可能提高 400x300 的播放器尺寸,盡可能增加曝光。 |
VideoIAB
IAB 可視率可能的選項。
列舉 | |
---|---|
VIDEO_IAB_UNSPECIFIED |
此列舉只是預留位置,並未指定任何影片 IAB 可視率選項。 |
IAB_VIEWABILITY_80_PERCENT_HIGHER |
指定網站和應用程式廣告空間,盡可能提高 80% 以上的 IAB 可視率。 |
IAB_VIEWABILITY_75_PERCENT_HIGHER |
指定網站和應用程式廣告空間,盡可能提高 75% 以上的 IAB 可視率。 |
IAB_VIEWABILITY_70_PERCENT_HIGHER |
指定網站和應用程式廣告空間,盡可能提高 70% 以上的 IAB 可視率。 |
IAB_VIEWABILITY_65_PERCENT_HIHGER |
指定網站和應用程式廣告空間,盡可能提高 65% 以上的 IAB 可視率。 |
IAB_VIEWABILITY_60_PERCENT_HIGHER |
指定網站和應用程式廣告空間,盡可能提高 60% 以上的 IAB 可視率。 |
IAB_VIEWABILITY_55_PERCENT_HIHGER |
指定網站和應用程式廣告空間,盡可能提高 55% 以上的 IAB 可視率。 |
IAB_VIEWABILITY_50_PERCENT_HIGHER |
指定網站和應用程式廣告空間,讓 IAB 可視率提高 50% 以上。 |
IAB_VIEWABILITY_40_PERCENT_HIHGER |
指定網站和應用程式廣告空間,盡可能提高 40% 以上的 IAB 可視率。 |
IAB_VIEWABILITY_30_PERCENT_HIHGER |
指定網站和應用程式廣告空間,盡可能提高 30% 以上的 IAB 可視率。 |
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 ( |
欄位 | |
---|---|
avoidedFraudOption |
請避免選擇有過往詐欺和 IVT 的網站和應用程式。 |
avoidInsufficientOption |
詐欺和 IVT 統計資料的歷來資料不足。 |
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 ( |
欄位 | |
---|---|
traqScoreOption |
真實廣告品質 (僅適用於多媒體委刊項)。 |
excludeUnrateable |
品牌安全 - 無法分級。 |
excludedAdultRisk |
品牌安全 - 成人內容。 |
excludedAlcoholRisk |
品牌安全 - 酒精飲料。 |
excludedIllegalDownloadsRisk |
品牌安全 - 非法下載。 |
excludedDrugsRisk |
品牌安全 - 藥物。 |
excludedHateSpeechRisk |
品牌安全 - 仇恨言論。 |
excludedOffensiveLanguageRisk |
品牌安全 - 令人反感的用語。 |
excludedViolenceRisk |
品牌安全 - 暴力內容。 |
excludedGamblingRisk |
品牌安全 - 賭博。 |
excludedAdFraudRisk |
廣告詐欺設定。 |
displayViewability |
顯示可視度部分 (僅適用於多媒體委刊項)。 |
videoViewability |
影片可視度部分 (僅適用於影片委刊項)。 |
customSegmentId[] |
Integral Ad Science 提供的自訂區隔 ID。ID 必須介於 |
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_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 語言選項。
列舉 | |
---|---|
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 Ad 詐欺防範選項。
列舉 | |
---|---|
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
指派的搜尋點指定選項詳細資料。當 targetingType
為 TARGETING_TYPE_POI
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{
"displayName": string,
"targetingOptionId": string,
"latitude": number,
"longitude": number,
"proximityRadiusAmount": number,
"proximityRadiusUnit": enum ( |
欄位 | |
---|---|
displayName |
僅供輸出。搜尋點的顯示名稱 (例如「時代廣場」、「太空針塔」)、其完整地址 (如果有的話)。 |
targetingOptionId |
必要欄位。 您可以使用 如果您指定的某個經緯度座標已從地址或搜尋點名稱中移除,您可以產生必要的座標選項 ID,方法是將所需的座標值四捨五入至小數點第 6 位、移除小數,並串連以半形分號分隔的字串值。舉例來說,您可以使用指定目標選項 ID「40741469;-74003387」指定經緯度組合 40.7414691、-74.003387。建立 後,這個欄位值會更新以附加半形分號和 英數字元雜湊值 (如果只提供經緯度座標)。 |
latitude |
僅供輸出。搜尋點的緯度,會四捨五入到小數點後第 6 位。 |
longitude |
僅供輸出。搜尋點的經度,會四捨五入到小數點後第 6 位。 |
proximityRadiusAmount |
必要欄位。要指定的搜尋點周圍區域半徑。半徑單位是由 |
proximityRadiusUnit |
必要欄位。指定半徑的距離單位。 |
DistanceUnit
可能的距離單位選項。
列舉 | |
---|---|
DISTANCE_UNIT_UNSPECIFIED |
這個版本未指定類型值,或無法指定類型值。 |
DISTANCE_UNIT_MILES |
英里。 |
DISTANCE_UNIT_KILOMETERS |
。 |
BusinessChainAssignedTargetingOptionDetails
指派的連鎖店指定目標選項詳細資料。當 targetingType
為 TARGETING_TYPE_BUSINESS_CHAIN
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{
"displayName": string,
"targetingOptionId": string,
"proximityRadiusAmount": number,
"proximityRadiusUnit": enum ( |
欄位 | |
---|---|
displayName |
僅供輸出。連鎖商家的顯示名稱,例如「肯德基」、「中國銀行」。 |
targetingOptionId |
必要欄位。 您可以使用 |
proximityRadiusAmount |
必要欄位。連鎖店周圍區域的半徑範圍。半徑單位是由 |
proximityRadiusUnit |
必要欄位。指定半徑的距離單位。 |
ContentDurationAssignedTargetingOptionDetails
指定內容時間長度的指定目標選項詳細資料。如果 targetingType
是 TARGETING_TYPE_CONTENT_DURATION
,這個欄位就會填入 contentDurationDetails
欄位。不支援明確指定所有選項。請移除所有內容時間長度指定目標選項,以達到這項成效。
JSON 表示法 |
---|
{
"targetingOptionId": string,
"contentDuration": enum ( |
欄位 | |
---|---|
targetingOptionId |
必要欄位。 |
contentDuration |
僅供輸出。內容時間長度。 |
ContentStreamTypeAssignedTargetingOptionDetails
指定內容串流類型指定目標選項的詳細資料。如果 targetingType
是 TARGETING_TYPE_CONTENT_STREAM_TYPE
,這個欄位就會填入 contentStreamTypeDetails
欄位。不支援明確指定所有選項。請移除所有內容串流類型指定目標選項來達到這項效果。
JSON 表示法 |
---|
{
"targetingOptionId": string,
"contentStreamType": enum ( |
欄位 | |
---|---|
targetingOptionId |
必要欄位。 |
contentStreamType |
僅供輸出。內容串流類型。 |
NativeContentPositionAssignedTargetingOptionDetails
原生內容位置指派指定目標選項的詳細資料。如果 targetingType
是 TARGETING_TYPE_NATIVE_CONTENT_POSITION
,這個欄位就會填入 nativeContentPositionDetails
欄位。不支援明確指定所有選項。請移除所有原生內容位置指定目標選項來達到這項效果。
JSON 表示法 |
---|
{
"contentPosition": enum ( |
欄位 | |
---|---|
contentPosition |
必要欄位。內容位置。 |
OmidAssignedTargetingOptionDetails
代表已啟用 Open Measurement 的廣告空間類型。當 targetingType
為 TARGETING_TYPE_OMID
時,系統就會在 Assign TargetingOption 的詳細資料欄位中填入這項資訊。
JSON 表示法 |
---|
{
"omid": enum ( |
欄位 | |
---|---|
omid |
必要欄位。已啟用 Open Measurement 的廣告空間類型。 |
AudioContentTypeAssignedTargetingOptionDetails
「已指派的音訊內容類型」指定目標選項詳細資料。如果 targetingType
是 TARGETING_TYPE_AUDIO_CONTENT_TYPE
,這個欄位就會填入 audioContentTypeDetails
欄位。不支援明確指定所有選項。請移除所有音訊內容類型指定目標選項來達到這項效果。
JSON 表示法 |
---|
{
"audioContentType": enum ( |
欄位 | |
---|---|
audioContentType |
必要欄位。音訊內容類型。 |
ContentGenreAssignedTargetingOptionDetails
指定內容類型的指定目標選項詳細資料。如果 targetingType
是 TARGETING_TYPE_CONTENT_GENRE
,這個欄位就會填入 contentGenreDetails
欄位。不支援明確指定所有選項。請移除所有指定內容類型選項,以達到這項效果。
JSON 表示法 |
---|
{ "targetingOptionId": string, "displayName": string, "negative": boolean } |
欄位 | |
---|---|
targetingOptionId |
必要欄位。 |
displayName |
僅供輸出。內容類型的顯示名稱。 |
negative |
表示該選項是否為排除指定。 |
YoutubeVideoAssignedTargetingOptionDetails
YouTube 影片指派的指定目標選項詳細資料。如果 targetingType
是 TARGETING_TYPE_YOUTUBE_VIDEO
,這個欄位就會填入 youtubeVideoDetails
欄位。
JSON 表示法 |
---|
{ "videoId": string, "negative": boolean } |
欄位 | |
---|---|
videoId |
YouTube 影片 ID 在 YouTube 觀賞頁面上顯示的 ID。 |
negative |
表示該選項是否為排除指定。 |
YoutubeChannelAssignedTargetingOptionDetails
YouTube 頻道指派的指定目標選項詳細資料。如果 targetingType
是 TARGETING_TYPE_YOUTUBE_CHANNEL
,這個欄位就會填入 youtubeChannelDetails
欄位。
JSON 表示法 |
---|
{ "channelId": string, "negative": boolean } |
欄位 | |
---|---|
channelId |
YouTube 上傳者頻道 ID 或 YouTube 頻道的頻道代碼。 |
negative |
表示該選項是否為排除指定。 |
SessionPositionAssignedTargetingOptionDetails
工作階段位置指派的指定目標選項詳細資料。如果 targetingType
是 TARGETING_TYPE_SESSION_POSITION
,這個欄位就會填入 sessionPositionDetails
欄位。
JSON 表示法 |
---|
{
"sessionPosition": enum ( |
欄位 | |
---|---|
sessionPosition |
廣告在工作階段中顯示的位置。 |
SessionPosition
工作階段中可能的位置。
列舉 | |
---|---|
SESSION_POSITION_UNSPECIFIED |
這是預留位置,不代表任何位置。 |
SESSION_POSITION_FIRST_IMPRESSION |
工作階段的第一次曝光。 |
方法 |
|
---|---|
|
為廣告群組取得一個指定目標選項。 |
|
列出指派給廣告群組的指定目標選項。 |