- 資源: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 |
內容播放時間詳細資料。如果 TargetingType 為 |
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,再由應用程式 ID 取得相應的行動平台。 |
應用程式平台
可用的應用程式平台指定目標選項。
列舉 | |
---|---|
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 |
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 做為其他群組的使用。
JSON 表示法 |
---|
{ "includedFirstAndThirdPartyAudienceGroups": [ { object ( |
欄位 | |
---|---|
includedFirstAndThirdPartyAudienceGroups[] |
已納入第一方和第三方目標對象群組的第一方和第三方目標對象 ID 和頻率。每個第一方和第三方目標對象群組只包含第一方和第三方目標對象 ID。每個第一方和第三方目標對象群組的關係創下,而結果將與其他目標對象群組「UNION」連結。系統會忽略設定相同的重複群組。 |
includedGoogleAudienceGroup |
所含 Google 目標對象群組的 Google 目標對象 ID。僅包含 Google 目標對象 ID。 |
includedCustomListGroup |
所含自訂名單群組的自訂名單 ID。僅包含自訂名單 ID。 |
includedCombinedAudienceGroup |
納入的合併目標對象群組的合併目標對象 ID。只包含合併目標對象 ID。 |
excludedFirstAndThirdPartyAudienceGroup |
已排除的第一個和第三方目標對象群組的第一個和第三方目標對象 ID 和頻率。用於排除指定。此群組「UNION」的「UNION」和其他目標對象群組的「合併」部分,會做為任何正面指定目標對象的參考依據。所有的項目在邏輯上都是「OR」。 |
excludedGoogleAudienceGroup |
已排除的 Google 目標對象群組的 Google 目標對象 ID。用於排除指定。此群組「UNION」的「UNION」和其他目標對象群組的「合併」部分,會做為任何正面指定目標對象的參考依據。只包含 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
指定目標選項,則會使用「授權直接賣方和經銷商」如果有需要 SQL 指令的分析工作負載
則 BigQuery 可能是最佳選擇
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 |
指定網站和應用程式廣告空間,將 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 |
指定網站廣告空間可最大化 IAB 可視率。 |
videoViewableRate |
指定網站廣告空間,盡可能提高完整可視率。 |
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 ( |
欄位 | |
---|---|
avoidedFraudOption |
避免指定涉及過往詐欺和無效流量。 |
avoidInsufficientOption |
歷來詐欺事件不足與無效流量統計資料。 |
FraudOption
可能涉及歷史詐欺和無效流量比率。
列舉 | |
---|---|
FRAUD_UNSPECIFIED |
這個列舉只是預留位置,並未指定任何詐欺和無效流量選項。 |
AD_IMPRESSION_FRAUD_100 |
100% 詐欺和無效流量。 |
AD_IMPRESSION_FRAUD_50 |
詐欺和 50% 以上無效流量。 |
AD_IMPRESSION_FRAUD_25 |
25% 以上詐欺和無效流量。 |
AD_IMPRESSION_FRAUD_10 |
10% 以上詐欺和無效流量。 |
AD_IMPRESSION_FRAUD_8 |
8% 以上的詐欺和無效流量。 |
AD_IMPRESSION_FRAUD_6 |
6% 以上的詐欺和無效流量。 |
AD_IMPRESSION_FRAUD_4 |
詐欺和 4% 以上無效流量。 |
AD_IMPRESSION_FRAUD_2 |
詐欺和 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 分。 |
成人
可能的 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 選項。
列舉 | |
---|---|
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 |
僅供輸出。商家連鎖店的顯示名稱,例如「KFC」、「Chase Bank」。 |
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 觀賞頁面上顯示的相同。 |
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 |
工作階段的首次曝光。 |
方法 |
|
---|---|
|
取得為廣告活動指派一個指定目標選項。 |
|
列出針對特定指定類型指派給廣告活動的指定目標選項。 |