- 资源:AssignmentTargetingOption
- 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
- 方法
资源:AssignTargetingOption
分配的单个定位选项,用于定义采用定位设置的实体的定位选项的状态。
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 |
关键字详细信息。当 一项资源最多可以分配 5000 个直接否定关键字。可指定的肯定关键字的数量没有限制。 |
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
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
JSON 表示法 |
---|
{ "channelId": string, "negative": boolean } |
字段 | |
---|---|
channelId |
|
negative |
指明此选项是否为排除性定位。对于指定的广告客户级定位选项,此字段必须为 true。 |
AppCategoryAssignedTargetingOptionDetails
已分配的应用类别定位选项的详细信息。当 targetingType
为 TARGETING_TYPE_APP_CATEGORY
时,此字段将填充到 AllocationTargetingOption 的 appCategoryDetails
字段中。
JSON 表示法 |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
字段 | |
---|---|
displayName |
仅限输出。应用类别的显示名称。 |
targetingOptionId |
必需。 |
negative |
指明此选项是否为排除性定位。 |
AppAssignedTargetingOptionDetails
已分配的应用定位选项的详细信息。当 targetingType
为 TARGETING_TYPE_APP
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
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
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
JSON 表示法 |
---|
{ "url": string, "negative": boolean } |
字段 | |
---|---|
url |
必需。网址,例如 DV360 支持 2 个级别的子目录定位(例如 |
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 |
星期六 |
SUNDAY |
星期日 |
TimeZoneResolution
可用于解析时区的方法。
枚举 | |
---|---|
TIME_ZONE_RESOLUTION_UNSPECIFIED |
时区分辨率未指定或未知。 |
TIME_ZONE_RESOLUTION_END_USER |
系统会根据看到广告的用户所在的时区解析时间。 |
TIME_ZONE_RESOLUTION_ADVERTISER |
时间按照投放广告的广告客户所在的时区进行解析。 |
AgeRangeAssignedTargetingOptionDetails
表示可定位的年龄段。当 targetingType
为 TARGETING_TYPE_AGE_RANGE
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
JSON 表示法 |
---|
{
"ageRange": enum ( |
字段 | |
---|---|
ageRange |
必需。受众群体的年龄段。我们仅支持定位到一个连续的年龄段的受众群体。因此,此字段中所表示的年龄段可以 1) 单独定位,或 2) 较大的连续年龄段的一部分。通过同时定位到年龄未知的受众群体,可以扩大连续的年龄段定位的覆盖面。 |
RegionalLocationListAssignedTargetingOptionDetails
地区性地理位置列表的定位详情。当 targetingType
为 TARGETING_TYPE_REGIONAL_LOCATION_LIST
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
JSON 表示法 |
---|
{ "regionalLocationListId": string, "negative": boolean } |
字段 | |
---|---|
regionalLocationListId |
必需。地区性地理位置列表的 ID。应引用类型为 |
negative |
指明此选项是否为排除性定位。 |
ProximityLocationListAssignedTargetingOptionDetails
邻近区域地理位置列表的定位详情。当 targetingType
为 TARGETING_TYPE_PROXIMITY_LOCATION_LIST
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
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
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
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
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
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
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
JSON 表示法 |
---|
{
"deviceType": enum ( |
字段 | |
---|---|
deviceType |
必需。设备类型的显示名称。 |
youtubeAndPartnersBidMultiplier |
仅限输出。利用出价调节系数,您可以根据设备类型提高或降低广告展示频率。它会对原出价应用一个调节系数。如果此字段为 0,则表示此字段不适用,而不是将原出价乘以 0。 例如,如果无调节系数的出价为 10.0 美元,平板电脑的调节系数为 1.5,则平板电脑的最终出价为 15.0 美元。 仅适用于 YouTube 和合作伙伴订单项。 |
AudienceGroupAssignedTargetingOptionDetails
已分配的受众群体群组定位选项详细信息。当 targetingType
为 TARGETING_TYPE_AUDIENCE_GROUP
时,此字段将填充到 AllocationTargetingOption 的详情字段中。每组之间的关系均为 UNION,但 excludedFirstAndThirdPartyAudienceGroup 和 excludedGoogleAudienceGroup 除外,其中 COMPLEMENT 用作与其他组的 Polygon 。
JSON 表示法 |
---|
{ "includedFirstAndThirdPartyAudienceGroups": [ { object ( |
字段 | |
---|---|
includedFirstAndThirdPartyAudienceGroups[] |
已添加的第一方和第三方受众群体组的第一方和第三方受众群体 ID 和新近度。每个第一方和第三方受众群体组仅包含第一方和第三方受众群体 ID。每个第一方受众群体组和第三方受众群体组之间的关系为 Polygon,其结果会与其他受众群体组进行 UNION 操作。系统将忽略具有相同设置的重复群组。 |
includedGoogleAudienceGroup |
已添加的 Google 受众群体组的 Google 受众群体 ID。仅包含 Google 受众群体 ID。 |
includedCustomListGroup |
包含的自定义列表组的自定义列表 ID。仅包含自定义列表 ID。 |
includedCombinedAudienceGroup |
包含的组合受众群体组的组合受众群体 ID。仅包含组合的受众群体 ID。 |
excludedFirstAndThirdPartyAudienceGroup |
已排除的第一方和第三方受众群体组的第一方和第三方受众群体 ID 和新近度。用于排除性定位。该组和其他已排除受众群体组的 UNION 的 COMPLEMENT 会用作任何正向受众群体定位的中心。所有项之间的逻辑“或”关系。 |
excludedGoogleAudienceGroup |
已排除的 Google 受众群体组的 Google 受众群体 ID。用于排除性定位。该组和其他已排除受众群体组的 UNION 的 COMPLEMENT 会用作任何正向受众群体定位的中心。仅包含兴趣相似的受众群体、有购买意向的受众群体和已安装的应用类 Google 受众群体。所有项之间的逻辑“或”关系。 |
FirstAndThirdPartyAudienceGroup
第一方和第三方受众群体群组的详细信息。所有第一方和第三方受众群体定位设置之间的逻辑关系均为“或”。
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 受众群体定位设置之间的逻辑关系均为“或”。
JSON 表示法 |
---|
{
"settings": [
{
object ( |
字段 | |
---|---|
settings[] |
必需。Google 受众群体群组中的所有 Google 受众群体定位设置。具有相同 ID 的重复设置将被忽略。 |
GoogleAudienceTargetingSetting
Google 受众群体定位设置的详细信息。
JSON 表示法 |
---|
{ "googleAudienceId": string } |
字段 | |
---|---|
googleAudienceId |
必需。Google 受众群体定位设置的 Google 受众群体 ID。此 ID 为 |
CustomListGroup
自定义列表组的详细信息。所有自定义名单定位设置之间的逻辑关系为“或”。
JSON 表示法 |
---|
{
"settings": [
{
object ( |
字段 | |
---|---|
settings[] |
必需。自定义名单组中的所有自定义名单定位设置。具有相同 ID 的重复设置将被忽略。 |
CustomListTargetingSetting
有关自定义名单定位设置的详细信息。
JSON 表示法 |
---|
{ "customListId": string } |
字段 | |
---|---|
customListId |
必需。自定义名单定位设置的自定义 ID。此 ID 为 |
CombinedAudienceGroup
组合的受众群体的详细信息。所有组合的受众群体定位设置之间的逻辑关系为“或”。
JSON 表示法 |
---|
{
"settings": [
{
object ( |
字段 | |
---|---|
settings[] |
必需。组合的受众群体群组中的所有组合受众群体定位设置。具有相同 ID 的重复设置将被忽略。组合的受众群体设置的数量不应超过 5 个,否则系统会抛出错误。 |
CombinedAudienceTargetingSetting
组合受众群体定位设置的详细信息。
JSON 表示法 |
---|
{ "combinedAudienceId": string } |
字段 | |
---|---|
combinedAudienceId |
必需。组合受众群体定位设置的组合受众群体 ID。此 ID 为 |
BrowserAssignedTargetingOptionDetails
已分配的浏览器定位选项的详细信息。当 targetingType
为 TARGETING_TYPE_BROWSER
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
JSON 表示法 |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
字段 | |
---|---|
displayName |
仅限输出。浏览器的显示名称。 |
targetingOptionId |
必需。类型为 |
negative |
指明此选项是否为排除性定位。针对同一资源分配的所有浏览器定位选项都必须具有相同的值。 |
HouseholdIncomeAssignedTargetingOptionDetails
已分配的家庭收入定位选项的详细信息。当 targetingType
为 TARGETING_TYPE_HOUSEHOLD_INCOME
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
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
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
JSON 表示法 |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
字段 | |
---|---|
displayName |
仅限输出。运营商或 ISP 的显示名称。 |
targetingOptionId |
必需。类型为 |
negative |
指明此选项是否为排除性定位。针对同一资源分配的所有运营商和 ISP 定位选项都必须具有相同的值。 |
KeywordAssignedTargetingOptionDetails
已分配的关键字定位选项的详细信息。当 targetingType
为 TARGETING_TYPE_KEYWORD
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
JSON 表示法 |
---|
{ "keyword": string, "negative": boolean } |
字段 | |
---|---|
keyword |
必需。关键字,例如 肯定关键字不能是冒犯性字词。必须采用 UTF-8 编码,大小上限为 255 个字节。字符数上限为 80。字词数上限为 10。 |
negative |
指明此选项是否为排除性定位。 |
NegativeKeywordListAssignedTargetingOptionDetails
否定关键字列表的定位详情。当 targetingType
为 TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
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
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
JSON 表示法 |
---|
{
"environment": enum ( |
字段 | |
---|---|
environment |
必需。服务环境。 |
InventorySourceAssignedTargetingOptionDetails
广告资源来源的定位详情。当 targetingType
为 TARGETING_TYPE_INVENTORY_SOURCE
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
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
时,此字段将填充到 AllocationTargetingOption 的 viewabilityDetails
字段中。
JSON 表示法 |
---|
{
"viewability": enum ( |
字段 | |
---|---|
viewability |
必需。预计可见度百分比。 |
AuthorizedSellerStatusAssignedTargetingOptionDetails
表示指定的授权卖方状态。当 targetingType
为 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
如果资源未指定 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
定位选项,则该资源使用的是“授权直销商和转销商”选项。
JSON 表示法 |
---|
{
"authorizedSellerStatus": enum ( |
字段 | |
---|---|
authorizedSellerStatus |
仅限输出。要定位的授权卖方状态。 |
targetingOptionId |
必需。类型为 |
LanguageAssignedTargetingOptionDetails
已分配的语言定位选项的详细信息。当 targetingType
为 TARGETING_TYPE_LANGUAGE
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
JSON 表示法 |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
字段 | |
---|---|
displayName |
仅限输出。语言的显示名(例如,“法语”)。 |
targetingOptionId |
必需。类型为 |
negative |
指明此选项是否为排除性定位。针对同一资源分配的所有语言定位选项都必须具有相同的值。 |
GeoRegionAssignedTargetingOptionDetails
已分配的地理区域定位选项的详细信息。当 targetingType
为 TARGETING_TYPE_GEO_REGION
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
JSON 表示法 |
---|
{
"displayName": string,
"targetingOptionId": string,
"geoRegionType": enum ( |
字段 | |
---|---|
displayName |
仅限输出。地理区域的显示名称(例如,“加拿大安大略省”)。 |
targetingOptionId |
必需。类型为 |
geoRegionType |
仅限输出。地理区域定位的类型。 |
negative |
指明此选项是否为排除性定位。 |
InventorySourceGroupAssignedTargetingOptionDetails
广告资源来源组的定位详情。当 targetingType
为 TARGETING_TYPE_INVENTORY_SOURCE_GROUP
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
JSON 表示法 |
---|
{ "inventorySourceGroupId": string } |
字段 | |
---|---|
inventorySourceGroupId |
必需。广告资源来源组的 ID。应引用 |
DigitalContentLabelAssignedTargetingOptionDetails
数字内容标签的定位详情。当 targetingType
为 TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
JSON 表示法 |
---|
{
"excludedContentRatingTier": enum ( |
字段 | |
---|---|
excludedContentRatingTier |
必需。要排除的数字内容标签分级层级的显示名称。 |
SensitiveCategoryAssignedTargetingOptionDetails
敏感类别的定位详情。当 targetingType
为 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
JSON 表示法 |
---|
{
"excludedSensitiveCategory": enum ( |
字段 | |
---|---|
excludedSensitiveCategory |
必需。归类为“已排除”的 DV360 敏感类别内容的枚举。 |
ExchangeAssignedTargetingOptionDetails
已分配的广告交易平台定位选项的详细信息。当 targetingType
为 TARGETING_TYPE_EXCHANGE
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
JSON 表示法 |
---|
{
"exchange": enum ( |
字段 | |
---|---|
exchange |
必需。广告交易平台的枚举值。 |
SubExchangeAssignedTargetingOptionDetails
已分配的子广告交易平台定位选项的详细信息。当 targetingType
为 TARGETING_TYPE_SUB_EXCHANGE
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
JSON 表示法 |
---|
{ "targetingOptionId": string } |
字段 | |
---|---|
targetingOptionId |
必需。类型为 |
ThirdPartyVerifierAssignedTargetingOptionDetails
已分配的第三方验证程序定位选项详细信息。当 targetingType
为 TARGETING_TYPE_THIRD_PARTY_VERIFIER
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
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”开头,由 8 位数字组成。不能同时指定自定义细分 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。 |
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 可见度选项。
枚举 | |
---|---|
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
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
JSON 表示法 |
---|
{
"displayName": string,
"targetingOptionId": string,
"latitude": number,
"longitude": number,
"proximityRadiusAmount": number,
"proximityRadiusUnit": enum ( |
字段 | |
---|---|
displayName |
仅限输出。地图注点的显示名称,例如“时代广场”、“太空针塔”,后跟完整地址(如有)。 |
targetingOptionId |
必需。类型为 可使用 如果您要定位到从地址或地图注点名称中移除的特定纬度/经度坐标,则可通过将所需坐标值四舍五入到小数点后第 6 位、移除小数以及将字符串值连接起来(以英文分号分隔)来生成必要的定位选项 ID。例如,您可以使用定位选项 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
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
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
时,此字段将填充到 AllocationTargetingOption 的详情字段中。
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 观看页面上显示的 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 |
会话的首次展示。 |
方法 |
|
---|---|
|
获取分配给广告组的单个定位选项。 |
|
列出分配给广告组的定位选项。 |