- 资源:TargetingOption
- DigitalContentLabelTargetingOptionDetails
- SensitiveCategoryTargetingOptionDetails
- AppCategoryTargetingOptionDetails
- OnScreenPositionTargetingOptionDetails
- ContentOutstreamPositionTargetingOptionDetails
- ContentInstreamPositionTargetingOptionDetails
- VideoPlayerSizeTargetingOptionDetails
- AgeRangeTargetingOptionDetails
- ParentalStatusTargetingOptionDetails
- UserRewardedContentTargetingOptionDetails
- HouseholdIncomeTargetingOptionDetails
- GenderTargetingOptionDetails
- DeviceTypeTargetingOptionDetails
- BrowserTargetingOptionDetails
- CarrierAndIspTargetingOptionDetails
- CarrierAndIspType
- EnvironmentTargetingOptionDetails
- OperatingSystemTargetingOptionDetails
- DeviceMakeModelTargetingOptionDetails
- ViewabilityTargetingOptionDetails
- CategoryTargetingOptionDetails
- LanguageTargetingOptionDetails
- AuthorizedSellerStatusTargetingOptionDetails
- GeoRegionTargetingOptionDetails
- ExchangeTargetingOptionDetails
- SubExchangeTargetingOptionDetails
- PoiTargetingOptionDetails
- BusinessChainTargetingOptionDetails
- ContentDurationTargetingOptionDetails
- ContentStreamTypeTargetingOptionDetails
- NativeContentPositionTargetingOptionDetails
- OmidTargetingOptionDetails
- AudioContentTypeTargetingOptionDetails
- ContentGenreTargetingOptionDetails
- 方法
资源:TargetingOption
表示单个定位选项,即 DV360 中的可定位概念。
JSON 表示法 |
---|
{ "name": string, "targetingOptionId": string, "targetingType": enum ( |
字段 | |
---|---|
name |
仅限输出。此定位选项的资源名称。 |
targetingOptionId |
仅限输出。此定位选项的唯一标识符。元组 { |
targetingType |
仅限输出。此定位选项的类型。 |
联合字段 details 。有关定位选项的详细信息。您只能填写“details”中的一项,且该项必须与 targeting_type 对应;details 只能是以下各项之一: |
|
digitalContentLabelDetails |
数字内容标签详情。 |
sensitiveCategoryDetails |
敏感类别详情。 |
appCategoryDetails |
应用类别详情。 |
onScreenPositionDetails |
屏幕位置详情。 |
contentOutstreamPositionDetails |
内容外部直播位置详情。 |
contentInstreamPositionDetails |
内容插播广告位置详情。 |
videoPlayerSizeDetails |
视频播放器尺寸详情。 |
ageRangeDetails |
年龄段详细信息。 |
parentalStatusDetails |
育儿状况详情。 |
userRewardedContentDetails |
会激励用户的内容详细信息。 |
householdIncomeDetails |
家庭收入详细信息。 |
genderDetails |
性别详情。 |
deviceTypeDetails |
设备类型详情。 |
browserDetails |
浏览器详细信息。 |
carrierAndIspDetails |
运营商和 ISP 详细信息。 |
environmentDetails |
环境详情。 |
operatingSystemDetails |
操作系统资源详情。 |
deviceMakeModelDetails |
设备品牌和型号资源详情。 |
viewabilityDetails |
可见度资源详情。 |
categoryDetails |
类别资源详情。 |
languageDetails |
语言资源详情。 |
authorizedSellerStatusDetails |
授权卖方状态资源详情。 |
geoRegionDetails |
地理区域资源详细信息。 |
exchangeDetails |
换货详情。 |
subExchangeDetails |
子广告交易平台详情。 |
poiDetails |
地图注点资源详情。 |
businessChainDetails |
商家连锁资源详情。 |
contentDurationDetails |
内容时长资源详细信息。 |
contentStreamTypeDetails |
内容流类型资源详细信息。 |
nativeContentPositionDetails |
原生内容展示位置详情。 |
omidDetails |
已启用 Open Measurement 的广告资源详情。 |
audioContentTypeDetails |
音频内容类型详情。 |
contentGenreDetails |
内容类型资源详细信息。 |
DigitalContentLabelTargetingOptionDetails
表示可定位的数字内容标签分级层级。当 targetingType
为 TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
时,系统会在 TargetingOption 的 digitalContentLabelDetails
字段中填充此值。
JSON 表示法 |
---|
{
"contentRatingTier": enum ( |
字段 | |
---|---|
contentRatingTier |
仅限输出。内容标签品牌保障等级的枚举。 |
SensitiveCategoryTargetingOptionDetails
表示可定位的敏感类别。当 targetingType
为 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
时,系统会在 TargetingOption 的 sensitiveCategoryDetails
字段中填充此值。
JSON 表示法 |
---|
{
"sensitiveCategory": enum ( |
字段 | |
---|---|
sensitiveCategory |
仅限输出。DV360 敏感类别内容分类器的枚举。 |
AppCategoryTargetingOptionDetails
表示可定位到的应用集合。借助集合,您可以定位由平台维护的相关应用的动态群组,例如 All Apps/Google Play/Games
。当 targetingType
为 TARGETING_TYPE_APP_CATEGORY
时,系统会在 appCategoryDetails
字段中填充此值。
JSON 表示法 |
---|
{ "displayName": string } |
字段 | |
---|---|
displayName |
仅限输出。应用集合的名称。 |
OnScreenPositionTargetingOptionDetails
表示可定位的屏幕位置,可供展示广告和视频广告使用。当 targetingType
为 TARGETING_TYPE_ON_SCREEN_POSITION
时,系统会在 onScreenPositionDetails
字段中填充此值。
JSON 表示法 |
---|
{
"onScreenPosition": enum ( |
字段 | |
---|---|
onScreenPosition |
仅限输出。屏幕上的位置。 |
ContentOutstreamPositionTargetingOptionDetails
表示可定位的内容外播位置,可供展示广告和视频广告使用。当 targetingType
为 TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
时,系统会在 contentOutstreamPositionDetails
字段中填充此值。
JSON 表示法 |
---|
{
"contentOutstreamPosition": enum ( |
字段 | |
---|---|
contentOutstreamPosition |
仅限输出。内容外播位置。 |
ContentInstreamPositionTargetingOptionDetails
表示可定位的内容插播位置,可供视频广告和音频广告使用。当 targetingType
为 TARGETING_TYPE_CONTENT_INSTREAM_POSITION
时,系统会在 contentInstreamPositionDetails
字段中填充此值。
JSON 表示法 |
---|
{
"contentInstreamPosition": enum ( |
字段 | |
---|---|
contentInstreamPosition |
仅限输出。内容插播位置。 |
VideoPlayerSizeTargetingOptionDetails
表示可定位到的视频播放器尺寸。当 targetingType
为 TARGETING_TYPE_VIDEO_PLAYER_SIZE
时,系统会在 videoPlayerSizeDetails
字段中填充此值。
JSON 表示法 |
---|
{
"videoPlayerSize": enum ( |
字段 | |
---|---|
videoPlayerSize |
仅限输出。视频播放器尺寸。 |
AgeRangeTargetingOptionDetails
表示可定位的年龄段。当 targetingType
为 TARGETING_TYPE_AGE_RANGE
时,系统会在 ageRangeDetails
字段中填充此值。
JSON 表示法 |
---|
{
"ageRange": enum ( |
字段 | |
---|---|
ageRange |
仅限输出。观众的年龄段。 |
ParentalStatusTargetingOptionDetails
表示可定位到的育儿状况。当 targetingType
为 TARGETING_TYPE_PARENTAL_STATUS
时,系统会在 TargetingOption 的 parentalStatusDetails
字段中填充此值。
JSON 表示法 |
---|
{
"parentalStatus": enum ( |
字段 | |
---|---|
parentalStatus |
仅限输出。受众群体的育儿状况。 |
UserRewardedContentTargetingOptionDetails
仅表示可定位的用户激励内容状态(适用于视频广告)。当 targetingType
为 TARGETING_TYPE_USER_REWARDED_CONTENT
时,系统会在 userRewardedContentDetails
字段中填充此值。
JSON 表示法 |
---|
{
"userRewardedContent": enum ( |
字段 | |
---|---|
userRewardedContent |
仅限输出。视频广告的会激励用户的内容状态。 |
HouseholdIncomeTargetingOptionDetails
表示可定位的家庭收入。当 targetingType
为 TARGETING_TYPE_HOUSEHOLD_INCOME
时,系统会在 TargetingOption 的 householdIncomeDetails
字段中填充此值。
JSON 表示法 |
---|
{
"householdIncome": enum ( |
字段 | |
---|---|
householdIncome |
仅限输出。受众群体的家庭收入。 |
GenderTargetingOptionDetails
表示可定位到的性别。当 targetingType
为 TARGETING_TYPE_GENDER
时,系统会在 TargetingOption 的 genderDetails
字段中填充此值。
JSON 表示法 |
---|
{
"gender": enum ( |
字段 | |
---|---|
gender |
仅限输出。受众群体的性别。 |
DeviceTypeTargetingOptionDetails
表示可定位到的设备类型。当 targetingType
为 TARGETING_TYPE_DEVICE_TYPE
时,系统会在 TargetingOption 的 deviceTypeDetails
字段中填充此值。
JSON 表示法 |
---|
{
"deviceType": enum ( |
字段 | |
---|---|
deviceType |
仅限输出。用于定位的设备类型。 |
BrowserTargetingOptionDetails
表示可定位的浏览器。当 targetingType
为 TARGETING_TYPE_BROWSER
时,系统会在 browserDetails
字段中填充此值。
JSON 表示法 |
---|
{ "displayName": string } |
字段 | |
---|---|
displayName |
仅限输出。浏览器的显示名称。 |
CarrierAndIspTargetingOptionDetails
表示可定位到的运营商或 ISP。当 targetingType
为 TARGETING_TYPE_CARRIER_AND_ISP
时,系统会在 TargetingOption 的 carrierAndIspDetails
字段中填充此值。
JSON 表示法 |
---|
{
"displayName": string,
"type": enum ( |
字段 | |
---|---|
displayName |
仅限输出。运营商或 ISP 的显示名称。 |
type |
仅限输出。类型,表示是运营商还是 ISP。 |
CarrierAndIspType
CarrierAndIspTargetingOption 的类型。
枚举 | |
---|---|
CARRIER_AND_ISP_TYPE_UNSPECIFIED |
在此版本中,如果未指定类型或类型未知,则使用默认值。 |
CARRIER_AND_ISP_TYPE_ISP |
表示此定位资源是指 ISP。 |
CARRIER_AND_ISP_TYPE_CARRIER |
表示此定位资源是指移动运营商。 |
EnvironmentTargetingOptionDetails
表示可定位的环境。当 targetingType
为 TARGETING_TYPE_ENVIRONMENT
时,系统会在 TargetingOption 的 environmentDetails
字段中填充此值。
JSON 表示法 |
---|
{
"environment": enum ( |
字段 | |
---|---|
environment |
仅限输出。投放环境。 |
OperatingSystemTargetingOptionDetails
表示可定位到的操作系统。当 targetingType
为 TARGETING_TYPE_OPERATING_SYSTEM
时,系统会在 TargetingOption 的 operatingSystemDetails
字段中填充此值。
JSON 表示法 |
---|
{ "displayName": string } |
字段 | |
---|---|
displayName |
仅限输出。操作系统的显示名称。 |
DeviceMakeModelTargetingOptionDetails
表示可定位的设备品牌和型号。当 targetingType
为 TARGETING_TYPE_DEVICE_MAKE_MODEL
时,系统会在 TargetingOption 的 deviceMakeModelDetails
字段中填充此值。
JSON 表示法 |
---|
{ "displayName": string } |
字段 | |
---|---|
displayName |
仅限输出。设备品牌和型号的显示名称。 |
ViewabilityTargetingOptionDetails
表示可定位的可见度。当 targetingType
为 TARGETING_TYPE_VIEWABILITY
时,系统会在 TargetingOption 的 viewabilityDetails
字段中填充此值。
JSON 表示法 |
---|
{
"viewability": enum ( |
字段 | |
---|---|
viewability |
仅限输出。预计的可见度百分比。 |
CategoryTargetingOptionDetails
表示可定位的类别。当 targetingType
为 TARGETING_TYPE_CATEGORY
时,系统会在 TargetingOption 的 categoryDetails
字段中填充此值。
JSON 表示法 |
---|
{ "displayName": string } |
字段 | |
---|---|
displayName |
仅限输出。类别的显示名称。 |
LanguageTargetingOptionDetails
表示可定位的语言。当 targetingType
为 TARGETING_TYPE_LANGUAGE
时,系统会在 languageDetails
字段中填充此值。
JSON 表示法 |
---|
{ "displayName": string } |
字段 | |
---|---|
displayName |
仅限输出。语言的显示名称(例如:“法语”)。 |
AuthorizedSellerStatusTargetingOptionDetails
表示可定位到的授权卖家状态。当 targetingType
为 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
时,系统会在 authorizedSellerStatusDetails
字段中填充此值。
JSON 表示法 |
---|
{
"authorizedSellerStatus": enum ( |
字段 | |
---|---|
authorizedSellerStatus |
仅限输出。授权卖方状态。 |
GeoRegionTargetingOptionDetails
表示可定位的地理区域。当 targetingType
为 TARGETING_TYPE_GEO_REGION
时,系统会在 geoRegionDetails
字段中填充此值。
JSON 表示法 |
---|
{
"displayName": string,
"geoRegionType": enum ( |
字段 | |
---|---|
displayName |
仅限输出。地理区域的显示名称(例如 “安大略省,加拿大”)。 |
geoRegionType |
仅限输出。地理区域定位类型。 |
ExchangeTargetingOptionDetails
表示可定位到的广告交易平台。当 targetingType
为 TARGETING_TYPE_EXCHANGE
时,系统会在 TargetingOption 的 exchangeDetails
字段中填充此值。
JSON 表示法 |
---|
{
"exchange": enum ( |
字段 | |
---|---|
exchange |
仅限输出。广告交易平台类型。 |
SubExchangeTargetingOptionDetails
表示可定位到的子广告交易平台。当 targetingType
为 TARGETING_TYPE_SUB_EXCHANGE
时,系统会在 TargetingOption 的 subExchangeDetails
字段中填充此值。
JSON 表示法 |
---|
{ "displayName": string } |
字段 | |
---|---|
displayName |
仅限输出。子广告交易平台的显示名称。 |
PoiTargetingOptionDetails
表示可定位的地图注点(POI)。当 targetingType
为 TARGETING_TYPE_POI
时,系统会在 poiDetails
字段中填充此值。
JSON 表示法 |
---|
{ "latitude": number, "longitude": number, "displayName": string } |
字段 | |
---|---|
latitude |
仅限输出。地图注点的纬度,四舍五入到小数点后 6 位。 |
longitude |
仅限输出。地图注点的经度(四舍五入到小数点后 6 位)。 |
displayName |
仅限输出。地图注点的显示名称(例如“时代广场”“太空针塔”),后跟其完整地址(如果有)。 |
BusinessChainTargetingOptionDetails
表示地理区域内可定位到的连锁商家。当 targetingType
为 TARGETING_TYPE_BUSINESS_CHAIN
时,系统会在 businessChainDetails
字段中填充此值。
JSON 表示法 |
---|
{
"businessChain": string,
"geoRegion": string,
"geoRegionType": enum ( |
字段 | |
---|---|
businessChain |
仅限输出。商家连锁的显示名称,例如“肯德基”“美国银行”。 |
geoRegion |
仅限输出。地理区域的显示名称,例如“加拿大安大略省”。 |
geoRegionType |
仅限输出。地理区域的类型。 |
ContentDurationTargetingOptionDetails
表示可定位的内容时长。当 targetingType
为 TARGETING_TYPE_CONTENT_DURATION
时,系统会在 contentDurationDetails
字段中填充此值。
JSON 表示法 |
---|
{
"contentDuration": enum ( |
字段 | |
---|---|
contentDuration |
仅限输出。内容时长。 |
ContentStreamTypeTargetingOptionDetails
表示可定位的内容流类型。当 targetingType
为 TARGETING_TYPE_CONTENT_STREAM_TYPE
时,系统会在 contentStreamTypeDetails
字段中填充此值。
JSON 表示法 |
---|
{
"contentStreamType": enum ( |
字段 | |
---|---|
contentStreamType |
仅限输出。内容流类型。 |
NativeContentPositionTargetingOptionDetails
表示可定位到的原生内容展示位置。当 targetingType
为 TARGETING_TYPE_NATIVE_CONTENT_POSITION
时,系统会在 nativeContentPositionDetails
字段中填充此值。
JSON 表示法 |
---|
{
"contentPosition": enum ( |
字段 | |
---|---|
contentPosition |
仅限输出。内容位置。 |
OmidTargetingOptionDetails
表示启用了 Open Measurement 的可定位广告资源类型。当 targetingType
为 TARGETING_TYPE_OMID
时,系统会在 omidDetails
字段中填充此值。
JSON 表示法 |
---|
{
"omid": enum ( |
字段 | |
---|---|
omid |
仅限输出。已启用 Open Measurement 的广告资源的类型。 |
AudioContentTypeTargetingOptionDetails
表示可定位到的音频内容类型。当 targetingType
为 TARGETING_TYPE_AUDIO_CONTENT_TYPE
时,系统会在 audioContentTypeDetails
字段中填充此值。
JSON 表示法 |
---|
{
"audioContentType": enum ( |
字段 | |
---|---|
audioContentType |
仅限输出。音频内容类型。 |
ContentGenreTargetingOptionDetails
表示可定位的内容类型。当 targetingType
为 TARGETING_TYPE_CONTENT_GENRE
时,系统会在 contentGenreDetails
字段中填充此值。
JSON 表示法 |
---|
{ "displayName": string } |
字段 | |
---|---|
displayName |
仅限输出。内容类型的显示名称 |
方法 |
|
---|---|
|
获取单个定位选项。 |
|
列出指定类型的定位选项。 |
|
根据给定的搜索字词搜索给定类型的定位选项。 |