REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

资源:AssignTargetingOption

分配的单个定位选项,用于定义采用定位设置的实体的定位选项的状态。

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

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

string

仅供输出。已分配的定位选项的资源名称。

assignedTargetingOptionId

string

仅供输出。已分配的定位选项的唯一 ID。该 ID 仅在给定资源和定位类型中是唯一的。可以在其他上下文中重复使用。

assignedTargetingOptionIdAlias

string

仅供输出。assignedTargetingOptionId 的别名。在检索或删除现有定位条件时,此值可用于代替 assignedTargetingOptionId

只有以下定位类型的所有已分配定位选项支持此字段:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

也可为订单项分配的以下定位类型的定位选项支持此字段:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

仅供输出。标识已分配的定位选项的类型。

inheritance

enum (Inheritance)

仅供输出。已分配的定位选项的继承状态。

联合字段 details。与所分配的定位选项相关的详细信息。只能填写详细信息中的一个字段,并且该字段必须与 targeting_type 相对应;details 只能是下列其中一项:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

频道详情。当 targetingTypeTARGETING_TYPE_CHANNEL 时,系统会填充此字段。

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

应用类别详情。当 targetingTypeTARGETING_TYPE_APP_CATEGORY 时,系统会填充此字段。

appDetails

object (AppAssignedTargetingOptionDetails)

应用详情。当 targetingTypeTARGETING_TYPE_APP 时,系统会填充此字段。

urlDetails

object (UrlAssignedTargetingOptionDetails)

网址详细信息。当 targetingTypeTARGETING_TYPE_URL 时,系统会填充此字段。

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

日期和时间详情。当 targetingTypeTARGETING_TYPE_DAY_AND_TIME 时,系统会填充此字段。

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

年龄段详情。当 targetingTypeTARGETING_TYPE_AGE_RANGE 时,系统会填充此字段。

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

单区域位置列表详情。当 targetingTypeTARGETING_TYPE_REGIONAL_LOCATION_LIST 时,系统会填充此字段。

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

邻近位置列表详细信息。当 targetingTypeTARGETING_TYPE_PROXIMITY_LOCATION_LIST 时,系统会填充此字段。

genderDetails

object (GenderAssignedTargetingOptionDetails)

性别详情。当 targetingTypeTARGETING_TYPE_GENDER 时,系统会填充此字段。

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

视频播放器尺寸详细信息。当 targetingTypeTARGETING_TYPE_VIDEO_PLAYER_SIZE 时,系统会填充此字段。

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

用户奖励内容的详细信息。当 targetingTypeTARGETING_TYPE_USER_REWARDED_CONTENT 时,系统会填充此字段。

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

育儿状况详情。当 targetingTypeTARGETING_TYPE_PARENTAL_STATUS 时,系统会填充此字段。

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

插播广告位置详细信息。当 targetingTypeTARGETING_TYPE_CONTENT_INSTREAM_POSITION 时,系统会填充此字段。

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

内容外播广告位置详细信息。当 targetingTypeTARGETING_TYPE_CONTENT_OUTSTREAM_POSITION 时,系统会填充此字段。

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

设备类型详细信息。当 targetingTypeTARGETING_TYPE_DEVICE_TYPE 时,系统会填充此字段。

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

受众群体定位详情。当 targetingTypeTARGETING_TYPE_AUDIENCE_GROUP 时,系统会填充此字段。每项资源只能定位一个目标对象群组选项。

browserDetails

object (BrowserAssignedTargetingOptionDetails)

浏览器详细信息。当 targetingTypeTARGETING_TYPE_BROWSER 时,系统会填充此字段。

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

家庭收入详情。当 targetingTypeTARGETING_TYPE_HOUSEHOLD_INCOME 时,系统会填充此字段。

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

屏幕上位置详情。当 targetingTypeTARGETING_TYPE_ON_SCREEN_POSITION 时,系统会填充此字段。

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

运营商和 ISP 详细信息。当 targetingTypeTARGETING_TYPE_CARRIER_AND_ISP 时,系统会填充此字段。

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

关键字详细信息。当 targetingTypeTARGETING_TYPE_KEYWORD 时,系统会填充此字段。

一项资源最多可以分配 5000 个直接否定关键字。可指定的肯定关键字的数量没有限制。

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

关键字详细信息。当 targetingTypeTARGETING_TYPE_NEGATIVE_KEYWORD_LIST 时,系统会填充此字段。

一项资源最多只能分配 4 个否定关键字列表。

operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

操作系统详细信息。当 targetingTypeTARGETING_TYPE_OPERATING_SYSTEM 时,系统会填充此字段。

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

设备品牌和型号详情。当 targetingTypeTARGETING_TYPE_DEVICE_MAKE_MODEL 时,系统会填充此字段。

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

环境详情。当 targetingTypeTARGETING_TYPE_ENVIRONMENT 时,系统会填充此字段。

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

广告资源来源详细信息。当 targetingTypeTARGETING_TYPE_INVENTORY_SOURCE 时,系统会填充此字段。

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

类别详情。当 targetingTypeTARGETING_TYPE_CATEGORY 时,系统会填充此字段。

定位某个类别的同时,也会定位其子类别。如果某个类别已从定位条件中排除,同时包含子类别,则以排除顺序为准。

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

可见度详情。当 targetingTypeTARGETING_TYPE_VIEWABILITY 时,系统会填充此字段。

每个资源只能定位一个可见度选项。

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

授权卖方状态详情。当 targetingTypeTARGETING_TYPE_AUTHORIZED_SELLER_STATUS 时,系统会填充此字段。

对于每项资源,您只能定位一个授权卖方状态选项。

如果资源没有授权卖方状态选项,则默认情况下,ads.txt 文件中指定为 DIRECT 或 RESELLER 的所有授权卖方都会定位到这些卖方。

languageDetails

object (LanguageAssignedTargetingOptionDetails)

语言详情。当 targetingTypeTARGETING_TYPE_LANGUAGE 时,系统会填充此字段。

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

地理区域详情。当 targetingTypeTARGETING_TYPE_GEO_REGION 时,系统会填充此字段。

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

广告资源来源组详细信息。当 targetingTypeTARGETING_TYPE_INVENTORY_SOURCE_GROUP 时,系统会填充此字段。

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

数字内容标签详细信息。当 targetingTypeTARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION 时,系统会填充此字段。

数字内容标签定位的是排除对象。广告客户级数字内容标签排除对象(若已设置)会始终在投放中应用(即使它们不会在资源设置中显示)。资源设置除了可以排除广告客户之外,还可以排除内容标签,但无法替换它们。如果排除所有数字内容标签,相应订单项将不会投放。

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

敏感类别详细信息。当 targetingTypeTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION 时,系统会填充此字段。

敏感类别定位排除对象。广告客户级敏感类别排除项(若已设置)会始终在投放过程中应用(即使它们不会显示在资源设置中)。资源设置除了可以排除广告客户之外,还可以排除敏感类别,但无法替换它们。

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

广告交易平台详细信息。当 targetingTypeTARGETING_TYPE_EXCHANGE 时,系统会填充此字段。

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

子广告交易平台详情。当 targetingTypeTARGETING_TYPE_SUB_EXCHANGE 时,系统会填充此字段。

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

第三方验证详情。当 targetingTypeTARGETING_TYPE_THIRD_PARTY_VERIFIER 时,系统会填充此字段。

poiDetails

object (PoiAssignedTargetingOptionDetails)

地图注点详情。当 targetingTypeTARGETING_TYPE_POI 时,系统会填充此字段。

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

连锁企业详细信息。当 targetingTypeTARGETING_TYPE_BUSINESS_CHAIN 时,系统会填充此字段。

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

内容时长详情。当 targetingTypeTARGETING_TYPE_CONTENT_DURATION 时,系统会填充此字段。

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

内容时长详情。当 TargetingType 为 TARGETING_TYPE_CONTENT_STREAM_TYPE 时,系统会填充此字段。

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

原生内容位置详情。当 targetingTypeTARGETING_TYPE_NATIVE_CONTENT_POSITION 时,系统会填充此字段。

omidDetails

object (OmidAssignedTargetingOptionDetails)

已启用 Open Measurement 的广告资源详情。当 targetingTypeTARGETING_TYPE_OMID 时,系统会填充此字段。

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

音频内容类型详细信息。当 targetingTypeTARGETING_TYPE_AUDIO_CONTENT_TYPE 时,系统会填充此字段。

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

内容类型详情。当 targetingTypeTARGETING_TYPE_CONTENT_GENRE 时,系统会填充此字段。

youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

YouTube 视频详细信息。当 targetingTypeTARGETING_TYPE_YOUTUBE_VIDEO 时,系统会填充此字段。

youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

YouTube 频道详情。当 targetingTypeTARGETING_TYPE_YOUTUBE_CHANNEL 时,系统会填充此字段。

sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

会话位置详细信息。当 targetingTypeTARGETING_TYPE_SESSION_POSITION 时,系统会填充此字段。

继承

指明分配的定位选项是否继承自更高级别的实体(例如合作伙伴或广告客户)。沿用的已分配定位选项会优先应用,始终优先于在当前级别分配的定位条件进行投放,并且无法通过当前实体服务进行修改。它们必须通过继承的实体服务进行修改。继承设置仅适用于排除性定位的频道、敏感类别排除对象和数字内容标签排除对象,前提是它们是在父级配置的。

枚举
INHERITANCE_UNSPECIFIED 继承未指定或未知。
NOT_INHERITED 分配的定位选项未继承自更高级别的实体。
INHERITED_FROM_PARTNER 分配的定位选项继承自合作伙伴定位设置。
INHERITED_FROM_ADVERTISER 分配的定位选项继承自广告客户定位设置。

ChannelAssignedTargetingOptionDetails

已分配的渠道定位选项的详细信息。当 targetingTypeTARGETING_TYPE_CHANNEL 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "channelId": string,
  "negative": boolean
}
字段
channelId

string (int64 format)

必需。渠道的 ID。应引用合作伙伴拥有的频道广告客户拥有的频道资源中的频道 ID 字段。

negative

boolean

指明此选项是否为排除性定位。对于指定的广告客户级定位选项,此字段必须为 true。

AppCategoryAssignedTargetingOptionDetails

已分配的应用类别定位选项的详细信息。当 targetingTypeTARGETING_TYPE_APP_CATEGORY 时,此字段将填充到 AllocationTargetingOption 的 appCategoryDetails 字段中。

JSON 表示法
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
字段
displayName

string

仅供输出。应用类别的显示名称。

targetingOptionId

string

必需。targetingTypeTARGETING_TYPE_APP_CATEGORY 时的 targetingOptionId 字段。

negative

boolean

指明此选项是否为排除性定位。

AppAssignedTargetingOptionDetails

已分配的应用定位选项的详细信息。当 targetingTypeTARGETING_TYPE_APP 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

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

string

必需。应用的 ID。

Android 的 Play 商店应用会使用软件包 ID,例如 com.google.android.gm。Apple 的 App Store 应用 ID 使用 9 位数的字符串,例如 422689480

displayName

string

仅供输出。应用的显示名称。

negative

boolean

指明此选项是否为排除性定位。

appPlatform

enum (AppPlatform)

指示目标应用的平台。如果未指定此字段,系统会假定该应用平台为移动设备(即Android 或 iOS),我们将根据应用 ID 得出相应的移动平台。

AppPlatform

可能的应用平台定位选项。

枚举
APP_PLATFORM_UNSPECIFIED 此版本中未指定应用平台时的默认值。此枚举是默认值的占位符,并不表示真实的平台选项。
APP_PLATFORM_IOS 应用平台为 iOS。
APP_PLATFORM_ANDROID 应用平台为 Android。
APP_PLATFORM_ROKU 应用平台为 Roku。
APP_PLATFORM_AMAZON_FIRETV 应用平台是 Amazon FireTV。
APP_PLATFORM_PLAYSTATION 应用平台是 Playstation。
APP_PLATFORM_APPLE_TV 应用平台是 Apple TV。
APP_PLATFORM_XBOX 应用平台是 Xbox
APP_PLATFORM_SAMSUNG_TV 应用平台是 Samsung TV。
APP_PLATFORM_ANDROID_TV 应用平台是 Android TV。
APP_PLATFORM_GENERIC_CTV 应用平台是未在其他地方明确列出的联网电视平台。

UrlAssignedTargetingOptionDetails

已分配的网址定位选项的详细信息。当 targetingTypeTARGETING_TYPE_URL 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "url": string,
  "negative": boolean
}
字段
url

string

必需。网址,例如 example.com

DV360 支持 2 个级别的子目录定位(例如 www.example.com/one-subdirectory-level/second-level)和 5 个级别的子网域定位(例如 five.four.three.two.one.example.com)。

negative

boolean

指明此选项是否为排除性定位。

DayAndTimeAssignedTargetingOptionDetails

表示在一周中的某一天定义的时间段,具有开始和结束时间。由 startHour 表示的时间必须早于 endHour 表示的时间。

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

enum (DayOfWeek)

必需。此日期与时间定位设置对应的星期几。

startHour

integer

必需。日期与时间定位的起始小时。必须介于 0(一天起始)和 23(一天结束前 1 小时)之间。

endHour

integer

必需。日期与时间定位的结束时段。必须介于 1(一天开始后 1 小时)和 24(一天结束)之间。

timeZoneResolution

enum (TimeZoneResolution)

必需。用于确定在这一日期和时间定位设置使用哪个时区的机制。

DayOfWeek

表示星期几。

枚举
DAY_OF_WEEK_UNSPECIFIED 未指定星期几。
MONDAY 星期一
TUESDAY 星期二
WEDNESDAY 星期三
THURSDAY 星期四
FRIDAY 星期五
SATURDAY 星期六
SUNDAY 星期日

TimeZoneResolution

可用于解析时区的方法。

枚举
TIME_ZONE_RESOLUTION_UNSPECIFIED 时区分辨率未指定或未知。
TIME_ZONE_RESOLUTION_END_USER 系统会根据看到广告的用户所在的时区解析时间。
TIME_ZONE_RESOLUTION_ADVERTISER 时间按照投放广告的广告客户所在的时区进行解析。

AgeRangeAssignedTargetingOptionDetails

表示可定位的年龄段。当 targetingTypeTARGETING_TYPE_AGE_RANGE 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "ageRange": enum (AgeRange)
}
字段
ageRange

enum (AgeRange)

必需。受众群体的年龄段。我们仅支持定位到一个连续的年龄段的受众群体。因此,此字段中所表示的年龄段可以 1) 单独定位,或 2) 较大的连续年龄段的一部分。通过同时定位到年龄未知的受众群体,可以扩大连续的年龄段定位的覆盖面。

RegionalLocationListAssignedTargetingOptionDetails

地区性地理位置列表的定位详情。当 targetingTypeTARGETING_TYPE_REGIONAL_LOCATION_LIST 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "regionalLocationListId": string,
  "negative": boolean
}
字段
regionalLocationListId

string (int64 format)

必需。地区性地理位置列表的 ID。应引用类型为 TARGETING_LOCATION_TYPE_REGIONALLocationList 资源的 locationListId 字段。

negative

boolean

指明此选项是否为排除性定位。

ProximityLocationListAssignedTargetingOptionDetails

邻近区域地理位置列表的定位详情。当 targetingTypeTARGETING_TYPE_PROXIMITY_LOCATION_LIST 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "proximityLocationListId": string,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}
字段
proximityLocationListId

string (int64 format)

必需。邻近区域地理位置列表的 ID。应引用类型为 TARGETING_LOCATION_TYPE_PROXIMITYLocationList 资源的 locationListId 字段。

proximityRadius

number

必需。半径,以 proximityRadiusUnit 中设置的距离单位表示。这表示所选地理位置周围要定位到的区域范围。半径应介于 1 到 500 英里或 800 公里之间。

proximityRadiusUnit

enum (ProximityRadiusUnit)

必需。半径距离单位。

ProximityRadiusUnit

ProximityRadius 的距离单位枚举。

枚举
PROXIMITY_RADIUS_UNIT_UNSPECIFIED 此版本中未指定距离单位时的默认值。此枚举是默认值的占位符,不表示实际距离单位。
PROXIMITY_RADIUS_UNIT_MILES 半径距离单位(以英里为单位)。
PROXIMITY_RADIUS_UNIT_KILOMETERS 半径距离单位(以公里为单位)

GenderAssignedTargetingOptionDetails

已分配的性别定位选项的详细信息。当 targetingTypeTARGETING_TYPE_GENDER 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "gender": enum (Gender)
}
字段
gender

enum (Gender)

必需。受众群体的性别。

VideoPlayerSizeAssignedTargetingOptionDetails

视频播放器尺寸定位选项的详细信息。当 targetingTypeTARGETING_TYPE_VIDEO_PLAYER_SIZE 时,将填充到 videoPlayerSizeDetails 字段中。不能明确定位到所有选项。若要实现此效果,请移除所有视频播放器尺寸定位选项。

JSON 表示法
{
  "videoPlayerSize": enum (VideoPlayerSize)
}
字段
videoPlayerSize

enum (VideoPlayerSize)

必需。视频播放器尺寸。

UserRewardedContentAssignedTargetingOptionDetails

用户激励内容定位选项的详细信息。当 targetingTypeTARGETING_TYPE_USER_REWARDED_CONTENT 时,将填充到 userRewardedContentDetails 字段中。

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

string

必需。targetingTypeTARGETING_TYPE_USER_REWARDED_CONTENT 时的 targetingOptionId 字段。

userRewardedContent

enum (UserRewardedContent)

仅供输出。视频广告的用户激励内容状态。

ParentalStatusAssignedTargetingOptionDetails

已分配的生育情况定位选项的详细信息。当 targetingTypeTARGETING_TYPE_PARENTAL_STATUS 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "parentalStatus": enum (ParentalStatus)
}
字段
parentalStatus

enum (ParentalStatus)

必需。受众群体的育儿状况。

ContentInstreamPositionAssignedTargetingOptionDetails

已分配内容的插播位置定位选项详细信息。当 targetingTypeTARGETING_TYPE_CONTENT_INSTREAM_POSITION 时,将填充到 contentInstreamPositionDetails 字段中。

JSON 表示法
{
  "contentInstreamPosition": enum (ContentInstreamPosition),
  "adType": enum (AdType)
}
字段
contentInstreamPosition

enum (ContentInstreamPosition)

必需。视频广告或音频广告的内容插播位置。

adType

enum (AdType)

仅供输出。要定位的广告类型。默认情况下,仅适用于广告订单定位和支持指定广告类型的新订单项会沿用此定位选项。可能的值包括:

  • AD_TYPE_VIDEO,当 lineItemTypeLINE_ITEM_TYPE_VIDEO_DEFAULT 时,新订单项将沿用此设置。
  • AD_TYPE_AUDIO,当 lineItemTypeLINE_ITEM_TYPE_AUDIO_DEFAULT 时,新订单项将沿用此设置。

AdType

表示与广告相关联的广告素材类型。

枚举
AD_TYPE_UNSPECIFIED 该版本中未指定或未知广告类型。
AD_TYPE_DISPLAY 展示广告素材,例如图片和 HTML5。
AD_TYPE_VIDEO 视频广告素材,例如在视频播放器中流式传输内容期间播放的视频广告。
AD_TYPE_AUDIO 音频广告素材,例如在音频内容播放期间播放的音频广告。

ContentOutstreamPositionAssignedTargetingOptionDetails

已分配的内容的外播位置定位选项详细信息。当 targetingTypeTARGETING_TYPE_CONTENT_OUTSTREAM_POSITION 时,将填充到 contentOutstreamPositionDetails 字段中。

JSON 表示法
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
字段
contentOutstreamPosition

enum (ContentOutstreamPosition)

必需。内容的外播位置。

adType

enum (AdType)

仅供输出。要定位的广告类型。默认情况下,仅适用于广告订单定位和支持指定广告类型的新订单项会沿用此定位选项。可能的值包括:

  • AD_TYPE_DISPLAY,当 lineItemTypeLINE_ITEM_TYPE_DISPLAY_DEFAULT 时,新订单项将沿用此设置。
  • AD_TYPE_VIDEO,当 lineItemTypeLINE_ITEM_TYPE_VIDEO_DEFAULT 时,新订单项将沿用此设置。

DeviceTypeAssignedTargetingOptionDetails

设备类型的定位详细信息。当 targetingTypeTARGETING_TYPE_DEVICE_TYPE 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "deviceType": enum (DeviceType),
  "youtubeAndPartnersBidMultiplier": number
}
字段
deviceType

enum (DeviceType)

必需。设备类型的显示名称。

youtubeAndPartnersBidMultiplier

number

仅供输出。利用出价调节系数,您可以根据设备类型提高或降低广告展示频率。它会对原出价应用一个调节系数。如果此字段为 0,则表示此字段不适用,而不是将原出价乘以 0。

例如,如果无调节系数的出价为 10.0 美元,平板电脑的调节系数为 1.5,则平板电脑的最终出价为 15.0 美元。

仅适用于 YouTube 和合作伙伴订单项。

AudienceGroupAssignedTargetingOptionDetails

已分配的受众群体群组定位选项详细信息。当 targetingTypeTARGETING_TYPE_AUDIENCE_GROUP 时,此字段将填充到 AllocationTargetingOption 的详情字段中。每组之间的关系均为 UNION,但 excludedFirstAndThirdPartyAudienceGroup 和 excludedGoogleAudienceGroup 除外,其中 COMPLEMENT 用作与其他组的 Polygon 。

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

object (FirstAndThirdPartyAudienceGroup)

已添加的第一方和第三方受众群体组的第一方和第三方受众群体 ID 和新近度。每个第一方和第三方受众群体组仅包含第一方和第三方受众群体 ID。每个第一方受众群体组和第三方受众群体组之间的关系为 Polygon,其结果会与其他受众群体组进行 UNION 操作。系统将忽略具有相同设置的重复群组。

includedGoogleAudienceGroup

object (GoogleAudienceGroup)

已添加的 Google 受众群体组的 Google 受众群体 ID。仅包含 Google 受众群体 ID。

includedCustomListGroup

object (CustomListGroup)

包含的自定义列表组的自定义列表 ID。仅包含自定义列表 ID。

includedCombinedAudienceGroup

object (CombinedAudienceGroup)

包含的组合受众群体组的组合受众群体 ID。仅包含组合的受众群体 ID。

excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

已排除的第一方和第三方受众群体组的第一方和第三方受众群体 ID 和新近度。用于排除性定位。该组和其他已排除受众群体组的 UNION 的 COMPLEMENT 会用作任何正向受众群体定位的中心。所有项之间的逻辑“或”关系。

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

已排除的 Google 受众群体组的 Google 受众群体 ID。用于排除性定位。该组和其他已排除受众群体组的 UNION 的 COMPLEMENT 会用作任何正向受众群体定位的中心。仅包含兴趣相似的受众群体、有购买意向的受众群体和已安装的应用类 Google 受众群体。所有项之间的逻辑“或”关系。

FirstAndThirdPartyAudienceGroup

第一方和第三方受众群体群组的详细信息。所有第一方和第三方受众群体定位设置之间的逻辑关系均为“或”。

JSON 表示法
{
  "settings": [
    {
      object (FirstAndThirdPartyAudienceTargetingSetting)
    }
  ]
}
字段
settings[]

object (FirstAndThirdPartyAudienceTargetingSetting)

必需。第一方和第三方受众群体群组中的所有第一方和第三方受众群体定位设置。不允许使用有相同 ID 的重复设置。

FirstAndThirdPartyAudienceTargetingSetting

第一方和第三方受众群体定位设置的详细信息。

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

string (int64 format)

必需。第一方和第三方受众群体定位设置的第一方和第三方受众群体 ID。此 ID 为 firstAndThirdPartyAudienceId

recency

enum (Recency)

第一方和第三方受众群体定位设置的新近度。仅适用于第一方受众群体,否则将被忽略。如需了解详情,请参阅 https://support.google.com/displayvideo/answer/2949947#recency。如果您未指定新近度限制,系统将不会使用任何新近度限制。

最近一次消费

所有受支持的第一方和第三方受众群体新近度值。

枚举
RECENCY_NO_LIMIT 没有新近度限制。
RECENCY_1_MINUTE 新近度为 1 分钟。
RECENCY_5_MINUTES 新近度为 5 分钟。
RECENCY_10_MINUTES 新近度为 10 分钟。
RECENCY_15_MINUTES 新近度为 15 分钟。
RECENCY_30_MINUTES 新近度为 30 分钟。
RECENCY_1_HOUR 新近度为 1 小时。
RECENCY_2_HOURS 新近度为 2 小时。
RECENCY_3_HOURS 新近度为 3 小时。
RECENCY_6_HOURS 新近度为 6 小时。
RECENCY_12_HOURS 新近度为 12 小时。
RECENCY_1_DAY 新近度为 1 天。
RECENCY_2_DAYS 新近度为 2 天。
RECENCY_3_DAYS 新近度为 3 天。
RECENCY_5_DAYS 新近度为 5 天。
RECENCY_7_DAYS 新近度为 7 天。
RECENCY_10_DAYS 新近度为 10 天。
RECENCY_14_DAYS 新近度为 14 天。
RECENCY_15_DAYS 新近度为 15 天。
RECENCY_21_DAYS 新近度为 21 天。
RECENCY_28_DAYS 新近度为 28 天。
RECENCY_30_DAYS 新近度为 30 天。
RECENCY_40_DAYS 新近度为 40 天。
RECENCY_45_DAYS 新近度为 45 天。
RECENCY_60_DAYS 新近度为 60 天。
RECENCY_90_DAYS 新近度为 90 天。
RECENCY_120_DAYS 新近度为 120 天。
RECENCY_180_DAYS 新近度为 180 天。
RECENCY_270_DAYS 新近度为 270 天。
RECENCY_365_DAYS 新近度为 365 天。

GoogleAudienceGroup

Google 受众群体群组的详细信息。所有 Google 受众群体定位设置之间的逻辑关系均为“或”。

JSON 表示法
{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}
字段
settings[]

object (GoogleAudienceTargetingSetting)

必需。Google 受众群体群组中的所有 Google 受众群体定位设置。具有相同 ID 的重复设置将被忽略。

GoogleAudienceTargetingSetting

Google 受众群体定位设置的详细信息。

JSON 表示法
{
  "googleAudienceId": string
}
字段
googleAudienceId

string (int64 format)

必需。Google 受众群体定位设置的 Google 受众群体 ID。此 ID 为 googleAudienceId

CustomListGroup

自定义列表组的详细信息。所有自定义名单定位设置之间的逻辑关系为“或”。

JSON 表示法
{
  "settings": [
    {
      object (CustomListTargetingSetting)
    }
  ]
}
字段
settings[]

object (CustomListTargetingSetting)

必需。自定义名单组中的所有自定义名单定位设置。具有相同 ID 的重复设置将被忽略。

CustomListTargetingSetting

有关自定义名单定位设置的详细信息。

JSON 表示法
{
  "customListId": string
}
字段
customListId

string (int64 format)

必需。自定义名单定位设置的自定义 ID。此 ID 为 customListId

CombinedAudienceGroup

组合的受众群体的详细信息。所有组合的受众群体定位设置之间的逻辑关系为“或”。

JSON 表示法
{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}
字段
settings[]

object (CombinedAudienceTargetingSetting)

必需。组合的受众群体群组中的所有组合受众群体定位设置。具有相同 ID 的重复设置将被忽略。组合的受众群体设置的数量不应超过 5 个,否则系统会抛出错误。

CombinedAudienceTargetingSetting

组合受众群体定位设置的详细信息。

JSON 表示法
{
  "combinedAudienceId": string
}
字段
combinedAudienceId

string (int64 format)

必需。组合受众群体定位设置的组合受众群体 ID。此 ID 为 combinedAudienceId

BrowserAssignedTargetingOptionDetails

已分配的浏览器定位选项的详细信息。当 targetingTypeTARGETING_TYPE_BROWSER 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
字段
displayName

string

仅供输出。浏览器的显示名称。

targetingOptionId

string

必需。类型为 TARGETING_TYPE_BROWSERTargetingOptiontargetingOptionId

negative

boolean

指明此选项是否为排除性定位。针对同一资源分配的所有浏览器定位选项都必须具有相同的值。

HouseholdIncomeAssignedTargetingOptionDetails

已分配的家庭收入定位选项的详细信息。当 targetingTypeTARGETING_TYPE_HOUSEHOLD_INCOME 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "householdIncome": enum (HouseholdIncome)
}
字段
householdIncome

enum (HouseholdIncome)

必需。受众群体的家庭收入。

OnScreenPositionAssignedTargetingOptionDetails

屏幕上位置定位选项的详细信息。当 targetingTypeTARGETING_TYPE_ON_SCREEN_POSITION 时,将填充到 onScreenPositionDetails 字段中。

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

string

必需。targetingTypeTARGETING_TYPE_ON_SCREEN_POSITION 时的 targetingOptionId 字段。

onScreenPosition

enum (OnScreenPosition)

仅供输出。在屏幕上的位置。

adType

enum (AdType)

仅供输出。要定位的广告类型。默认情况下,仅适用于广告订单定位和支持指定广告类型的新订单项会沿用此定位选项。可能的值包括:

  • AD_TYPE_DISPLAY,当 lineItemTypeLINE_ITEM_TYPE_DISPLAY_DEFAULT 时,新订单项将沿用此设置。
  • AD_TYPE_VIDEO,当 lineItemTypeLINE_ITEM_TYPE_VIDEO_DEFAULT 时,新订单项将沿用此设置。

CarrierAndIspAssignedTargetingOptionDetails

已分配的运营商和 ISP 定位选项的详细信息。当 targetingTypeTARGETING_TYPE_CARRIER_AND_ISP 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
字段
displayName

string

仅供输出。运营商或 ISP 的显示名称。

targetingOptionId

string

必需。类型为 TARGETING_TYPE_CARRIER_AND_ISPTargetingOptiontargetingOptionId

negative

boolean

指明此选项是否为排除性定位。针对同一资源分配的所有运营商和 ISP 定位选项都必须具有相同的值。

KeywordAssignedTargetingOptionDetails

已分配的关键字定位选项的详细信息。当 targetingTypeTARGETING_TYPE_KEYWORD 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "keyword": string,
  "negative": boolean
}
字段
keyword

string

必需。关键字,例如 car insurance

肯定关键字不能是冒犯性字词。必须采用 UTF-8 编码,大小上限为 255 个字节。字符数上限为 80。字词数上限为 10。

negative

boolean

指明此选项是否为排除性定位。

NegativeKeywordListAssignedTargetingOptionDetails

否定关键字列表的定位详情。当 targetingTypeTARGETING_TYPE_NEGATIVE_KEYWORD_LIST 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "negativeKeywordListId": string
}
字段
negativeKeywordListId

string (int64 format)

必需。否定关键字列表的 ID。应引用 NegativeKeywordList 资源的 negativeKeywordListId 字段。

OperatingSystemAssignedTargetingOptionDetails

已分配的操作系统定位选项的详细信息。当 targetingTypeTARGETING_TYPE_OPERATING_SYSTEM 时,将填充到 operatingSystemDetails 字段中。

JSON 表示法
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
字段
displayName

string

仅供输出。操作系统的显示名称。

targetingOptionId

string

必需。当 targetingTypeTARGETING_TYPE_OPERATING_SYSTEM 时,在 targetingOptionId 字段中填充的定位选项 ID。

negative

boolean

指明此选项是否为排除性定位。

DeviceMakeModelAssignedTargetingOptionDetails

已分配的设备品牌和型号定位选项的详细信息。当 targetingTypeTARGETING_TYPE_DEVICE_MAKE_MODEL 时,将填充到 deviceMakeModelDetails 字段中。

JSON 表示法
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
字段
displayName

string

仅供输出。设备品牌和型号的显示名称。

targetingOptionId

string

必需。targetingTypeTARGETING_TYPE_DEVICE_MAKE_MODEL 时的 targetingOptionId 字段。

negative

boolean

指明此选项是否为排除性定位。

EnvironmentAssignedTargetingOptionDetails

已分配的环境定位选项的详细信息。当 targetingTypeTARGETING_TYPE_ENVIRONMENT 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "environment": enum (Environment)
}
字段
environment

enum (Environment)

必需。服务环境。

InventorySourceAssignedTargetingOptionDetails

广告资源来源的定位详情。当 targetingTypeTARGETING_TYPE_INVENTORY_SOURCE 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "inventorySourceId": string
}
字段
inventorySourceId

string (int64 format)

必需。广告资源来源的 ID。应引用 InventorySource 资源的 inventorySourceId 字段。

CategoryAssignedTargetingOptionDetails

已分配的类别定位选项的详细信息。当 targetingTypeTARGETING_TYPE_CATEGORY 时,将填充到 categoryDetails 字段中。

JSON 表示法
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
字段
displayName

string

仅供输出。类别的显示名称。

targetingOptionId

string

必需。targetingTypeTARGETING_TYPE_CATEGORY 时的 targetingOptionId 字段。

negative

boolean

指明此选项是否为排除性定位。

ViewabilityAssignedTargetingOptionDetails

已分配的可见度定位选项的详细信息。当 targetingTypeTARGETING_TYPE_VIEWABILITY 时,此字段将填充到 AllocationTargetingOption 的 viewabilityDetails 字段中。

JSON 表示法
{
  "viewability": enum (Viewability)
}
字段
viewability

enum (Viewability)

必需。预计可见度百分比。

AuthorizedSellerStatusAssignedTargetingOptionDetails

表示指定的授权卖方状态。当 targetingTypeTARGETING_TYPE_AUTHORIZED_SELLER_STATUS 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

如果资源未指定 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS 定位选项,则该资源使用的是“授权直销商和转销商”选项。

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

enum (AuthorizedSellerStatus)

仅供输出。要定位的授权卖方状态。

targetingOptionId

string

必需。类型为 TARGETING_TYPE_AUTHORIZED_SELLER_STATUSTargetingOptiontargetingOptionId

LanguageAssignedTargetingOptionDetails

已分配的语言定位选项的详细信息。当 targetingTypeTARGETING_TYPE_LANGUAGE 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
字段
displayName

string

仅供输出。语言的显示名(例如,“法语”)。

targetingOptionId

string

必需。类型为 TARGETING_TYPE_LANGUAGETargetingOptiontargetingOptionId

negative

boolean

指明此选项是否为排除性定位。针对同一资源分配的所有语言定位选项都必须具有相同的值。

GeoRegionAssignedTargetingOptionDetails

已分配的地理区域定位选项的详细信息。当 targetingTypeTARGETING_TYPE_GEO_REGION 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

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

string

仅供输出。地理区域的显示名称(例如,“加拿大安大略省”)。

targetingOptionId

string

必需。类型为 TARGETING_TYPE_GEO_REGIONTargetingOptiontargetingOptionId

geoRegionType

enum (GeoRegionType)

仅供输出。地理区域定位的类型。

negative

boolean

指明此选项是否为排除性定位。

InventorySourceGroupAssignedTargetingOptionDetails

广告资源来源组的定位详情。当 targetingTypeTARGETING_TYPE_INVENTORY_SOURCE_GROUP 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "inventorySourceGroupId": string
}
字段
inventorySourceGroupId

string (int64 format)

必需。广告资源来源组的 ID。应引用 InventorySourceGroup 资源的 inventorySourceGroupId 字段。

DigitalContentLabelAssignedTargetingOptionDetails

数字内容标签的定位详情。当 targetingTypeTARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "excludedContentRatingTier": enum (ContentRatingTier)
}
字段
excludedContentRatingTier

enum (ContentRatingTier)

必需。要排除的数字内容标签分级层级的显示名称。

SensitiveCategoryAssignedTargetingOptionDetails

敏感类别的定位详情。当 targetingTypeTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "excludedSensitiveCategory": enum (SensitiveCategory)
}
字段
excludedSensitiveCategory

enum (SensitiveCategory)

必需。归类为“已排除”的 DV360 敏感类别内容的枚举。

ExchangeAssignedTargetingOptionDetails

已分配的广告交易平台定位选项的详细信息。当 targetingTypeTARGETING_TYPE_EXCHANGE 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "exchange": enum (Exchange)
}
字段
exchange

enum (Exchange)

必需。广告交易平台的枚举值。

SubExchangeAssignedTargetingOptionDetails

已分配的子广告交易平台定位选项的详细信息。当 targetingTypeTARGETING_TYPE_SUB_EXCHANGE 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "targetingOptionId": string
}
字段
targetingOptionId

string

必需。类型为 TARGETING_TYPE_SUB_EXCHANGETargetingOptiontargetingOptionId

ThirdPartyVerifierAssignedTargetingOptionDetails

已分配的第三方验证程序定位选项详细信息。当 targetingTypeTARGETING_TYPE_THIRD_PARTY_VERIFIER 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
字段
联合字段 verifier。可以定位到某个第三方验证程序,为展示次数设置品牌保障阈值。verifier 只能是下列其中一项:
adloox

object (Adloox)

第三方品牌验证程序 -- Adloox。

doubleVerify

object (DoubleVerify)

第三方品牌验证程序 -- DoubleVerify。

integralAdScience

object (IntegralAdScience)

第三方品牌验证程序 -- Integral Ad Science。

Adloox

Adloox 设置的详细信息。

JSON 表示法
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ]
}
字段
excludedAdlooxCategories[]

enum (AdlooxCategory)

Adloox 的品牌保障设置。

AdlooxCategory

可能的 Adloox 选项。

枚举
ADLOOX_UNSPECIFIED 此枚举只是一个占位符,不指定任何 Adloox 选项。
ADULT_CONTENT_HARD 成人内容(困难)。
ADULT_CONTENT_SOFT 成人内容(轻柔)。
ILLEGAL_CONTENT 非法内容。
BORDERLINE_CONTENT 擦边球内容。
DISCRIMINATORY_CONTENT 歧视性内容。
VIOLENT_CONTENT_WEAPONS 暴力内容和武器。
LOW_VIEWABILITY_DOMAINS 低可见度网域。
FRAUD 欺诈。

DoubleVerify

DoubleVerify 设置的详细信息。

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

object (BrandSafetyCategories)

DV 品牌保障控制。

avoidedAgeRatings[]

enum (AgeRating)

避免对具有年龄分级的应用出价。

appStarRating

object (AppStarRating)

避免对包含星级的应用出价。

displayViewability

object (DisplayViewability)

展示广告可见度设置(仅适用于展示广告订单项)。

videoViewability

object (VideoViewability)

视频广告可见度设置(仅适用于视频广告订单项)。

fraudInvalidTraffic

object (FraudInvalidTraffic)

避免定位到历史欺诈和无效流量比率的网站和应用。

customSegmentId

string (int64 format)

DoubleVerify 提供的自定义细分 ID。此 ID 必须以“51”开头,由 8 位数字组成。不能同时指定自定义细分 ID 和以下任何字段:

BrandSafetyCategories

品牌保障控制设置。

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

boolean

未知或无法分级。

avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

品牌保障“高”严重级别的规避类别。

avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

品牌保障为“中”严重级别的规避类别。

HighSeverityCategory

高严重级别类别的可能选项。

枚举
HIGHER_SEVERITY_UNSPECIFIED 此枚举只是一个占位符,不指定任何严重级别为“高”的类别。
ADULT_CONTENT_PORNOGRAPHY 成人内容:色情、成人话题和裸露内容。
COPYRIGHT_INFRINGEMENT 侵犯版权。
SUBSTANCE_ABUSE 毒品/酒精饮料/管制物品:物质滥用。
GRAPHIC_VIOLENCE_WEAPONS 极端内容图片/露骨暴力内容/武器。
HATE_PROFANITY 仇恨/亵渎性内容。
CRIMINAL_SKILLS 非法活动:犯罪技巧。
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER 利诱性内容/恶意软件/杂乱无章。

MediumSeverityCategory

严重程度为“中”的类别的可能选项。

枚举
MEDIUM_SEVERITY_UNSPECIFIED 此枚举只是一个占位符,未指定任何中等严重级别类别。
AD_SERVERS 广告服务器。
ADULT_CONTENT_SWIMSUIT 成人内容:泳装。
ALTERNATIVE_LIFESTYLES 有争议的主题:另类生活方式。
CELEBRITY_GOSSIP 有争议的主题:名人八卦。
GAMBLING 有争议的主题:赌博。
OCCULT 有争议的主题:神秘、
SEX_EDUCATION 有争议的主题:性教育。
DISASTER_AVIATION 灾难:空难。
DISASTER_MAN_MADE 灾难:人为灾难。
DISASTER_NATURAL 灾难:天灾。
DISASTER_TERRORIST_EVENTS 灾难:恐怖主义事件。
DISASTER_VEHICLE 灾难:车辆。
ALCOHOL 毒品/酒精饮料/管制物质:酒精饮料。
SMOKING 毒品/酒精饮料/管制物质:吸烟。
NEGATIVE_NEWS_FINANCIAL 负面新闻:金融。
NON_ENGLISH 非标准内容:非英语内容。
PARKING_PAGE 非标准内容:停车页。
UNMODERATED_UGC 未加管制的用户生成内容:论坛、图片和视频。
INFLAMMATORY_POLITICS_AND_NEWS 有争议的主题:煽动性政治和新闻。
NEGATIVE_NEWS_PHARMACEUTICAL 负面新闻:医药。

AgeRating

年龄分级的可能选项。

枚举
AGE_RATING_UNSPECIFIED 此枚举只是一个占位符,不指定任何年龄评分选项。
APP_AGE_RATE_UNKNOWN 年龄分级未知的应用。
APP_AGE_RATE_4_PLUS 适合所有人(4 岁以上)的应用。
APP_AGE_RATE_9_PLUS 适合所有人(9 岁以上)的应用。
APP_AGE_RATE_12_PLUS 适合青少年(12 岁以上)的应用。
APP_AGE_RATE_17_PLUS 适合成人(17 岁以上)的应用。
APP_AGE_RATE_18_PLUS 仅限成人(18 岁以上)使用的应用。

AppStarRating

DoubleVerify 星级设置的详细信息。

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

enum (StarRating)

避免对包含星级的应用出价。

avoidInsufficientStarRating

boolean

避免对星级评分不足的应用出价。

StarRating

可能会显示星级的选项。

枚举
APP_STAR_RATE_UNSPECIFIED 此枚举只是一个占位符,不指定任何应用星级选项。
APP_STAR_RATE_1_POINT_5_LESS 1.5 星以下的官方应用。
APP_STAR_RATE_2_LESS 2 星以下的官方应用。
APP_STAR_RATE_2_POINT_5_LESS 2.5 星以下的官方应用。
APP_STAR_RATE_3_LESS 3 星以下的官方应用。
APP_STAR_RATE_3_POINT_5_LESS 3.5 星以下的官方应用。
APP_STAR_RATE_4_LESS 4 星以下的官方应用。
APP_STAR_RATE_4_POINT_5_LESS 4.5 星以下的官方应用。

DisplayViewability

DoubleVerify 展示广告可见度设置的详细信息。

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

enum (IAB)

定位到网站和应用广告资源,以尽可能提高 IAB 可见率。

viewableDuring

enum (ViewableDuring)

定位到网站和应用广告资源,以最大限度地延长 100% 可见时长。

IAB

IAB 可见率的可能选项。

枚举
IAB_VIEWED_RATE_UNSPECIFIED 此枚举只是一个占位符,不指定任何 IAB 查看费率选项。
IAB_VIEWED_RATE_80_PERCENT_HIGHER 定位到网站和应用广告资源,以便最大限度地提升 IAB 可见率(达到 80% 或更高)。
IAB_VIEWED_RATE_75_PERCENT_HIGHER 定位到网站和应用广告资源,以便最大限度地提升 IAB 可见率(不低于 75%)。
IAB_VIEWED_RATE_70_PERCENT_HIGHER 定位到网站和应用广告资源,以便最大限度地提升 IAB 可见率(不低于 70%)。
IAB_VIEWED_RATE_65_PERCENT_HIGHER 定位到网站和应用广告资源,以使 IAB 可见率不低于 65%。
IAB_VIEWED_RATE_60_PERCENT_HIGHER 定位到网站和应用广告资源后,可将 IAB 可见率最大限度地提高 60% 或更高。
IAB_VIEWED_RATE_55_PERCENT_HIGHER 定位到网站和应用内广告资源可最大限度提高 IAB 可见率不低于 55% 的水平。
IAB_VIEWED_RATE_50_PERCENT_HIGHER 定位到网站和应用广告资源,以便最大限度地提升 IAB 可见率(不低于 50%)。
IAB_VIEWED_RATE_40_PERCENT_HIGHER 定位到网站和应用广告资源后,可最大限度提高 IAB 可见率达到 40% 或更高。
IAB_VIEWED_RATE_30_PERCENT_HIGHER 定位到网站和应用广告资源后,可将 IAB 可见率最大限度地提高 30% 或更高。

ViewableDuring

可能的可见时长选项。

枚举
AVERAGE_VIEW_DURATION_UNSPECIFIED 此枚举只是一个占位符,未指定任何平均观看时长选项。
AVERAGE_VIEW_DURATION_5_SEC 定位到网站和应用广告资源,使 100% 可见时长达到 5 秒或更长时间。
AVERAGE_VIEW_DURATION_10_SEC 定位到网站和应用广告资源,使 100% 可见时长达到 10 秒或以上。
AVERAGE_VIEW_DURATION_15_SEC 定位到网站和应用广告资源,使 100% 可见时长达到 15 秒或以上。

VideoViewability

DoubleVerify 视频广告可见度设置的详细信息。

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

enum (VideoIAB)

定位到网站广告资源,以尽可能提高 IAB 可见率。

videoViewableRate

enum (VideoViewableRate)

定位到网站广告资源,以尽可能提高完全可见率。

playerImpressionRate

enum (PlayerImpressionRate)

定位到广告资源以最大限度地增加 400x300 或更大播放器尺寸的展示次数。

VideoIAB

IAB 可见率的可能选项。

枚举
VIDEO_IAB_UNSPECIFIED 此枚举只是一个占位符,不指定任何视频 IAB 可见率选项。
IAB_VIEWABILITY_80_PERCENT_HIGHER 定位到网站和应用广告资源,以便最大限度地提升 IAB 可见率(达到 80% 或更高)。
IAB_VIEWABILITY_75_PERCENT_HIGHER 定位到网站和应用广告资源,以便最大限度地提升 IAB 可见率(不低于 75%)。
IAB_VIEWABILITY_70_PERCENT_HIGHER 定位到网站和应用广告资源,以便最大限度地提升 IAB 可见率(不低于 70%)。
IAB_VIEWABILITY_65_PERCENT_HIHGER 定位到网站和应用广告资源,以使 IAB 可见率不低于 65%。
IAB_VIEWABILITY_60_PERCENT_HIGHER 定位到网站和应用广告资源后,可将 IAB 可见率最大限度地提高 60% 或更高。
IAB_VIEWABILITY_55_PERCENT_HIHGER 定位到网站和应用内广告资源可最大限度提高 IAB 可见率不低于 55% 的水平。
IAB_VIEWABILITY_50_PERCENT_HIGHER 定位到网站和应用广告资源,以便最大限度地提升 IAB 可见率(不低于 50%)。
IAB_VIEWABILITY_40_PERCENT_HIHGER 定位到网站和应用广告资源后,可最大限度提高 IAB 可见率达到 40% 或更高。
IAB_VIEWABILITY_30_PERCENT_HIHGER 定位到网站和应用广告资源后,可将 IAB 可见率最大限度地提高 30% 或更高。

VideoViewableRate

完全可见率的可能选项。

枚举
VIDEO_VIEWABLE_RATE_UNSPECIFIED 此枚举只是一个占位符,不指定任何视频可见率选项。
VIEWED_PERFORMANCE_40_PERCENT_HIGHER 定位到网站广告资源,尽可能提高完全可见率达到 40% 或更高。
VIEWED_PERFORMANCE_35_PERCENT_HIGHER 定位到网站广告资源,以使完全可见率达到或超过 35%。
VIEWED_PERFORMANCE_30_PERCENT_HIGHER 定位到网站广告资源,使全可见率尽可能提高 30% 或更高。
VIEWED_PERFORMANCE_25_PERCENT_HIGHER 定位到网站广告资源,以使完全可见率达到或超过 25%。
VIEWED_PERFORMANCE_20_PERCENT_HIGHER 定位到网站广告资源,尽可能提高完全可见率达到 20% 或更高。
VIEWED_PERFORMANCE_10_PERCENT_HIGHER 定位到网站广告资源,尽可能提高完全可见率达到 10% 或更高。

PlayerImpressionRate

可能的展示次数选项。

枚举
PLAYER_SIZE_400X300_UNSPECIFIED 此枚举只是一个占位符,不指定任何展示选项。
PLAYER_SIZE_400X300_95 能投放 95%+ 的展示次数的网站。
PLAYER_SIZE_400X300_70 能投放 70%+ 的展示次数的网站。
PLAYER_SIZE_400X300_25 能投放 25%+ 的展示次数的网站。
PLAYER_SIZE_400X300_5 能投放 5%+ 的展示次数的网站。

FraudInvalidTraffic

DoubleVerify 欺诈和无效流量设置。

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

enum (FraudOption)

避免定位到存在欺诈和无效流量的网站和应用。

avoidInsufficientOption

boolean

欺诈性及无效流量历史统计数据不足。

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 (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ]
}
字段
traqScoreOption

enum (TRAQScore)

真正的广告质量(仅适用于展示广告订单项)。

excludeUnrateable

boolean

品牌保障 - 无法分级

excludedAdultRisk

enum (Adult)

品牌保障 - 成人内容

excludedAlcoholRisk

enum (Alcohol)

品牌保障 - 酒精饮料

excludedIllegalDownloadsRisk

enum (IllegalDownloads)

品牌保障 - 非法下载

excludedDrugsRisk

enum (Drugs)

品牌保障 - 药品

excludedHateSpeechRisk

enum (HateSpeech)

品牌保障 - 仇恨言论

excludedOffensiveLanguageRisk

enum (OffensiveLanguage)

品牌保障 - 冒犯性语言

excludedViolenceRisk

enum (Violence)

品牌保障 - 暴力内容

excludedGamblingRisk

enum (Gambling)

品牌保障 - 赌博

excludedAdFraudRisk

enum (AdFraudPrevention)

广告欺诈设置。

displayViewability

enum (DisplayViewability)

“展示可见度”部分(仅适用于展示订单项)。

videoViewability

enum (VideoViewability)

视频广告可见度部分(仅适用于视频广告订单项)。

customSegmentId[]

string (int64 format)

Integral Ad Science 提供的自定义细分受众群 ID。ID 必须介于 10000011999999 之间(包括这两个数值)。

TRAQScore

可能的 Integral Ad Science TRAQ(真实广告质量)得分范围。

枚举
TRAQ_UNSPECIFIED 此枚举只是一个占位符,不指定任何真实的广告质量得分。
TRAQ_250 TRAQ 得分 250-1000。
TRAQ_500 TRAQ 得分 500-1000。
TRAQ_600 TRAQ 得分 600-1000。
TRAQ_700 TRAQ 得分 700-1000。
TRAQ_750 TRAQ 得分为 750-1000。
TRAQ_875 TRAQ 得分为 875-1000。
TRAQ_1000 TRAQ 得分 1000。

Adult

可能的 Integral Ad Science 成人选项。

枚举
ADULT_UNSPECIFIED 此枚举只是一个占位符,不指定任何成人选项。
ADULT_HR 成人 - 排除高风险。
ADULT_HMR 成人 - 排除高风险和中等风险。

酒精饮料

可能的 Integral Ad Science 酒精饮料选项。

枚举
ALCOHOL_UNSPECIFIED 此枚举只是一个占位符,不指定任何酒精饮料选项。
ALCOHOL_HR 酒精饮料 - 排除高风险。
ALCOHOL_HMR 酒精饮料 - 排除高风险和中等风险。

IllegalDownloads

可能的 Integral Ad Science Illegal 下载选项。

枚举
ILLEGAL_DOWNLOADS_UNSPECIFIED 此枚举只是一个占位符,未指定任何非法下载选项。
ILLEGAL_DOWNLOADS_HR 非法下载 - 排除高风险。
ILLEGAL_DOWNLOADS_HMR 非法下载 - 排除高风险和中等风险。

毒品

可能的 Integral Ad Science 药品。

枚举
DRUGS_UNSPECIFIED 此枚举只是一个占位符,未指定任何药品选项。
DRUGS_HR 毒品 - 排除高风险。
DRUGS_HMR 毒品 - 排除高风险和中等风险。

HateSpeech

可能的 Integral Ad Science 仇恨言论选项。

枚举
HATE_SPEECH_UNSPECIFIED 此枚举只是一个占位符,未指定任何仇恨言论选项。
HATE_SPEECH_HR 仇恨言论 - 排除高风险。
HATE_SPEECH_HMR 仇恨言论 - 排除高风险和中等风险。

OffensiveLanguage

可能的 Integral Ad Science 冒犯性语言选项。

枚举
OFFENSIVE_LANGUAGE_UNSPECIFIED 此枚举只是一个占位符,不指定任何语言选项。
OFFENSIVE_LANGUAGE_HR 冒犯性语言 - 排除高风险。
OFFENSIVE_LANGUAGE_HMR 冒犯性语言 - 排除高风险和中等风险。

暴力内容

可能的 Integral Ad Science 暴力内容选项。

枚举
VIOLENCE_UNSPECIFIED 此枚举只是一个占位符,未指定任何暴力选项。
VIOLENCE_HR 暴力 - 排除高风险。
VIOLENCE_HMR 暴力 - 排除高风险和中等风险。

赌博

可能的 Integral Ad Science 赌博选项。

枚举
GAMBLING_UNSPECIFIED 此枚举只是一个占位符,不指定任何赌博选项。
GAMBLING_HR 赌博 - 排除高风险。
GAMBLING_HMR 赌博 - 排除高风险和中等风险。

AdFraudPrevention

可能的 Integral Ad Science 广告欺诈防范选项。

枚举
SUSPICIOUS_ACTIVITY_UNSPECIFIED 此枚举只是一个占位符,不指定任何广告欺诈防范选项。
SUSPICIOUS_ACTIVITY_HR 广告欺诈 - 排除高风险。
SUSPICIOUS_ACTIVITY_HMR 广告欺诈 - 排除高风险和中等风险。

DisplayViewability

可能的 Integral Ad Science 展示广告可见度选项。

枚举
PERFORMANCE_VIEWABILITY_UNSPECIFIED 此枚举只是一个占位符,不指定任何显示可见度选项。
PERFORMANCE_VIEWABILITY_40 指定不低于 40% 的可见度。
PERFORMANCE_VIEWABILITY_50 指定不低于 50% 的可见度。
PERFORMANCE_VIEWABILITY_60 指定不低于 60% 的可见度。
PERFORMANCE_VIEWABILITY_70 指定不低于 70% 的可见度。

VideoViewability

可能的 Integral Ad Science Video 可见度选项。

枚举
VIDEO_VIEWABILITY_UNSPECIFIED 此枚举只是一个占位符,不指定任何视频广告可见度选项。
VIDEO_VIEWABILITY_40 40%+ 被观看(IAB 视频可见度标准)。
VIDEO_VIEWABILITY_50 50%+ 被观看(IAB 视频可见度标准)。
VIDEO_VIEWABILITY_60 60%+ 被观看(IAB 视频可见度标准)。
VIDEO_VIEWABILITY_70 70%+ 被观看(IAB 视频可见度标准)。

PoiAssignedTargetingOptionDetails

已分配的地图注点定位选项的详细信息。当 targetingTypeTARGETING_TYPE_POI 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

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

string

仅供输出。地图注点的显示名称,例如“时代广场”、“太空针塔”,后跟完整地址(如有)。

targetingOptionId

string

必需。类型为 TARGETING_TYPE_POITargetingOptiontargetingOptionId

可使用 targetingTypes.targetingOptions.search 检索接受的地图注点定位选项 ID。

如果您要定位到从地址或地图注点名称中移除的特定纬度/经度坐标,则可通过将所需坐标值四舍五入到小数点后第 6 位、移除小数以及将字符串值连接起来(以英文分号分隔)来生成必要的定位选项 ID。例如,您可以使用定位选项 ID“40741469;-74003387”定位纬度/经度对“40.7414691, -74.003387”。创建 后,此字段值将会更新以附加英文分号和 字母数字哈希值(如果仅提供了纬度/经度坐标 )。

latitude

number

仅供输出。地图注点四舍五入到小数点后 6 位的纬度。

longitude

number

仅供输出。地图注点的经度,四舍五入到小数点后 6 位。

proximityRadiusAmount

number

必需。将定位到的地图注点周围区域的半径。半径的单位由 proximityRadiusUnit 指定。如果单位是 DISTANCE_UNIT_KILOMETERS,则必须介于 1 到 800 之间;如果单位是 DISTANCE_UNIT_MILES,则必须为 1 到 500。

proximityRadiusUnit

enum (DistanceUnit)

必需。用于衡量定位半径时所依据的距离单位。

DistanceUnit

可能的距离单位选项。

枚举
DISTANCE_UNIT_UNSPECIFIED 该版本中未指定类型值,或类型值未知。
DISTANCE_UNIT_MILES 英里。
DISTANCE_UNIT_KILOMETERS 公里。

BusinessChainAssignedTargetingOptionDetails

已分配的连锁企业定位选项的详细信息。当 targetingTypeTARGETING_TYPE_BUSINESS_CHAIN 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

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

string

仅供输出。连锁企业的显示名,例如“KFC”“Chase Bank”。

targetingOptionId

string

必需。类型为 TARGETING_TYPE_BUSINESS_CHAINTargetingOptiontargetingOptionId

可以使用 SearchTargetingOptions 检索接受的连锁企业定位选项 ID。

proximityRadiusAmount

number

必需。要定位到的连锁商家周围区域的半径。半径的单位由 proximityRadiusUnit 指定。如果单位是 DISTANCE_UNIT_KILOMETERS,则必须介于 1 到 800 之间;如果单位是 DISTANCE_UNIT_MILES,则必须为 1 到 500。这两种情况的最小增量为 0.1。如果输入值过于精细,系统会将其四舍五入为可接受的值(例如,15.57 将变为 15.6)。

proximityRadiusUnit

enum (DistanceUnit)

必需。用于衡量定位半径时所依据的距离单位。

ContentDurationAssignedTargetingOptionDetails

指定了内容时长的定位选项的详细信息。当 targetingTypeTARGETING_TYPE_CONTENT_DURATION 时,将填充到 contentDurationDetails 字段中。不能明确定位到所有选项。若要实现此效果,请移除所有内容时长定位选项。

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

string

必需。targetingTypeTARGETING_TYPE_CONTENT_DURATION 时的 targetingOptionId 字段。

contentDuration

enum (ContentDuration)

仅供输出。内容的时长。

ContentStreamTypeAssignedTargetingOptionDetails

为内容流类型分配了定位选项的详细信息。当 targetingTypeTARGETING_TYPE_CONTENT_STREAM_TYPE 时,将填充到 contentStreamTypeDetails 字段中。不能明确定位到所有选项。若要实现此效果,请移除所有内容流类型定位选项。

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

string

必需。targetingTypeTARGETING_TYPE_CONTENT_STREAM_TYPE 时的 targetingOptionId 字段。

contentStreamType

enum (ContentStreamType)

仅供输出。内容流的类型。

NativeContentPositionAssignedTargetingOptionDetails

原生内容位置分配的定位选项的详情。当 targetingTypeTARGETING_TYPE_NATIVE_CONTENT_POSITION 时,将填充到 nativeContentPositionDetails 字段中。不能明确定位到所有选项。若要实现此效果,请移除所有原生内容位置定位选项。

JSON 表示法
{
  "contentPosition": enum (NativeContentPosition)
}
字段
contentPosition

enum (NativeContentPosition)

必需。内容位置。

OmidAssignedTargetingOptionDetails

表示启用了 Open Measurement 的可定位广告资源类型。当 targetingTypeTARGETING_TYPE_OMID 时,此字段将填充到 AllocationTargetingOption 的详情字段中。

JSON 表示法
{
  "omid": enum (Omid)
}
字段
omid

enum (Omid)

必需。已启用 Open Measurement 的广告资源的类型。

AudioContentTypeAssignedTargetingOptionDetails

已分配音频内容类型的定位选项的详细信息。当 targetingTypeTARGETING_TYPE_AUDIO_CONTENT_TYPE 时,将填充到 audioContentTypeDetails 字段中。不能明确定位到所有选项。若要实现此效果,请移除所有音频内容类型定位选项。

JSON 表示法
{
  "audioContentType": enum (AudioContentType)
}
字段
audioContentType

enum (AudioContentType)

必需。音频内容类型。

ContentGenreAssignedTargetingOptionDetails

已分配内容类型的定位选项的详细信息。当 targetingTypeTARGETING_TYPE_CONTENT_GENRE 时,将填充到 contentGenreDetails 字段中。不能明确定位到所有选项。若要实现此效果,请移除所有内容类型定位选项。

JSON 表示法
{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}
字段
targetingOptionId

string

必需。targetingTypeTARGETING_TYPE_CONTENT_GENRE 时的 targetingOptionId 字段。

displayName

string

仅供输出。内容类型的显示名称。

negative

boolean

指明此选项是否为排除性定位。

YoutubeVideoAssignedTargetingOptionDetails

为 YouTube 视频指定的定位选项的详细信息。当 targetingTypeTARGETING_TYPE_YOUTUBE_VIDEO 时,将填充到 youtubeVideoDetails 字段中。

JSON 表示法
{
  "videoId": string,
  "negative": boolean
}
字段
videoId

string

YouTube 观看页面上显示的 YouTube 视频 ID。

negative

boolean

指明此选项是否为排除性定位。

YoutubeChannelAssignedTargetingOptionDetails

为 YouTube 频道分配的定位选项的详细信息。当 targetingTypeTARGETING_TYPE_YOUTUBE_CHANNEL 时,将填充到 youtubeChannelDetails 字段中。

JSON 表示法
{
  "channelId": string,
  "negative": boolean
}
字段
channelId

string

YouTube 上传者频道 ID 或 YouTube 频道的频道代码。

negative

boolean

指明此选项是否为排除性定位。

SessionPositionAssignedTargetingOptionDetails

“已分配会话位置”定位选项的详情。当 targetingTypeTARGETING_TYPE_SESSION_POSITION 时,将填充到 sessionPositionDetails 字段中。

JSON 表示法
{
  "sessionPosition": enum (SessionPosition)
}
字段
sessionPosition

enum (SessionPosition)

广告在会话中的展示位置。

SessionPosition

会话中可能出现的位置。

枚举
SESSION_POSITION_UNSPECIFIED 这是一个占位符,不表示任何位置。
SESSION_POSITION_FIRST_IMPRESSION 会话的首次展示。

方法

get

获取分配给广告系列的单个定位选项。

list

列出针对特定定位类型分配给广告系列的定位选项。