REST Resource: advertisers.adGroups.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_typedetails 只能是下列其中一项:
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 时,将填充此字段。

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

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

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

每项资源只能定位 1 个授权卖方状态选项。

如果资源没有“授权卖方”状态选项,则默认情况下,系统会在 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 时,此值将会填充到 AssignTargetingOption 的详情字段中。

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

string (int64 format)

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

negative

boolean

指明此选项是否正被否定定位条件。对于在广告客户级指定的定位选项,此字段必须为 true。

AppCategoryAssignedTargetingOptionDetails

已分配的应用类别定位选项的详细信息。当 targetingTypeTARGETING_TYPE_APP_CATEGORY 时,系统会在 AssignTargetingOption 的 appCategoryDetails 字段中填充此字段。

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

string

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

targetingOptionId

string

必需。targetingTypeTARGETING_TYPE_APP_CATEGORY 时的 targetingOptionId 字段。

negative

boolean

指明此选项是否正被否定定位条件。

AppAssignedTargetingOptionDetails

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

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 该应用平台是未在其他地方明确列出的联网电视平台。
APP_PLATFORM_LG_TV 应用平台为 LG TV。
APP_PLATFORM_VIZIO_TV 应用平台为 VIZIO TV。

UrlAssignedTargetingOptionDetails

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

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

string

必需。网址,例如 example.com

DV360 支持两个级别的子目录定位(例如 www.example.com/one-subdirectory-level/second-level)和五个级别的子网域定位(例如 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 时,此值将会填充到 AssignTargetingOption 的详情字段中。

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

enum (AgeRange)

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

RegionalLocationListAssignedTargetingOptionDetails

区域地理位置列表的定位详细信息。当 targetingTypeTARGETING_TYPE_REGIONAL_LOCATION_LIST 时,此值将会填充到 AssignTargetingOption 的详情字段中。

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

string (int64 format)

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

negative

boolean

指明此选项是否正被否定定位条件。

ProximityLocationListAssignedTargetingOptionDetails

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

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 时,此值将会填充到 AssignTargetingOption 的详情字段中。

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 时,此值将会填充到 AssignTargetingOption 的详情字段中。

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 时,此值将会填充到 AssignTargetingOption 的详情字段中。

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 时,此值将会填充到 AssignTargetingOption 的详情字段中。每个组之间的关系为 UNION,但 excludedFirstAndThirdPartyAudienceGroup 和 excludedGoogleAudienceGroup 都相同,其中 COMPLEMENT 用作与其他组的交汇点。

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

object (FirstAndThirdPartyAudienceGroup)

添加的第一方和第三方受众群体组的第一方和第三方受众群体 ID 和新近度。每个第一方和第三方受众群体组都只包含第一方和第三方受众群体 ID。每个第一方受众群体组和每个第三方受众群体组之间的关系均为 更加 ,结果是与其他受众群体组进行 UNION 处理。系统会忽略具有相同设置的重复群组。

includedGoogleAudienceGroup

object (GoogleAudienceGroup)

所含 Google 受众群体组的 Google 受众群体 ID。仅包含 Google 受众群体 ID。

includedCustomListGroup

object (CustomListGroup)

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

includedCombinedAudienceGroup

object (CombinedAudienceGroup)

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

excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

已排除的第一方和第三方受众群体组的第一方和第三方受众群体 ID 和新近度。用于排除性定位。将此群组和其他已排除的受众群体组的“UNION”组合起来将用作任何肯定受众群体定位条件的交集。所有项之间逻辑关系为“或”。

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

已排除的 Google 受众群体组的 Google 受众群体 ID。用于排除性定位。将此群组和其他已排除的受众群体组的“UNION”组合起来将用作任何肯定受众群体定位条件的交集。仅包含“兴趣相似的受众群体”、“有购买意向的受众群体”和“已安装应用”类型的 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 时,此值将会填充到 AssignTargetingOption 的详情字段中。

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

string

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

targetingOptionId

string

必需。TARGETING_TYPE_BROWSER 类型的 TargetingOptiontargetingOptionId

negative

boolean

指明此选项是否正被否定定位条件。对于同一资源,所有已分配的浏览器定位选项的此字段值必须相同。

HouseholdIncomeAssignedTargetingOptionDetails

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

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 时,此值将会填充到 AssignTargetingOption 的详情字段中。

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

string

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

targetingOptionId

string

必需。TARGETING_TYPE_CARRIER_AND_ISP 类型的 TargetingOptiontargetingOptionId

negative

boolean

指明此选项是否正被否定定位条件。针对同一资源的所有已分配的运营商和 ISP 定位选项的此字段必须具有相同的值。

KeywordAssignedTargetingOptionDetails

已分配的关键字定位选项的详情。当 targetingTypeTARGETING_TYPE_KEYWORD 时,此值将会填充到 AssignTargetingOption 的详情字段中。

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

string

必需。关键字,例如 car insurance

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

negative

boolean

指明此选项是否正被否定定位条件。

NegativeKeywordListAssignedTargetingOptionDetails

否定关键字列表的定位详细信息。当 targetingTypeTARGETING_TYPE_NEGATIVE_KEYWORD_LIST 时,此值将会填充到 AssignTargetingOption 的详情字段中。

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 时,此值将会填充到 AssignTargetingOption 的详情字段中。

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

enum (Environment)

必需。投放环境。

InventorySourceAssignedTargetingOptionDetails

广告资源来源的定位详细信息。当 targetingTypeTARGETING_TYPE_INVENTORY_SOURCE 时,此值将会填充到 AssignTargetingOption 的详情字段中。

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 时,系统会在 AssignTargetingOption 的 viewabilityDetails 字段中填充此字段。

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

enum (Viewability)

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

AuthorizedSellerStatusAssignedTargetingOptionDetails

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

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

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

enum (AuthorizedSellerStatus)

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

targetingOptionId

string

必需。TARGETING_TYPE_AUTHORIZED_SELLER_STATUS 类型的 TargetingOptiontargetingOptionId

LanguageAssignedTargetingOptionDetails

指定语言定位选项的详细信息。当 targetingTypeTARGETING_TYPE_LANGUAGE 时,此值将会填充到 AssignTargetingOption 的详情字段中。

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

string

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

targetingOptionId

string

必需。TARGETING_TYPE_LANGUAGE 类型的 TargetingOptiontargetingOptionId

negative

boolean

指明此选项是否正被否定定位条件。对于同一资源,所有已分配的语言定位选项的此字段值必须相同。

GeoRegionAssignedTargetingOptionDetails

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

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

string

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

targetingOptionId

string

必需。TARGETING_TYPE_GEO_REGION 类型的 TargetingOptiontargetingOptionId

geoRegionType

enum (GeoRegionType)

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

negative

boolean

指明此选项是否正被否定定位条件。

InventorySourceGroupAssignedTargetingOptionDetails

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

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

string (int64 format)

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

DigitalContentLabelAssignedTargetingOptionDetails

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

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

enum (ContentRatingTier)

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

SensitiveCategoryAssignedTargetingOptionDetails

敏感类别的定位详细信息。当 targetingTypeTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION 时,此值将会填充到 AssignTargetingOption 的详情字段中。

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

enum (SensitiveCategory)

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

ExchangeAssignedTargetingOptionDetails

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

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

enum (Exchange)

必需。交换的枚举值。

SubExchangeAssignedTargetingOptionDetails

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

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

string

必需。TARGETING_TYPE_SUB_EXCHANGE 类型的 TargetingOptiontargetingOptionId

ThirdPartyVerifierAssignedTargetingOptionDetails

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

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

历史欺诈和IVT 统计信息。

FraudOption

针对既往欺诈和IVT 率。

枚举
FRAUD_UNSPECIFIED 此枚举只是一个占位符,不指定任何欺诈和无效流量选项。
AD_IMPRESSION_FRAUD_100 100% 欺诈和无效流量。
AD_IMPRESSION_FRAUD_50 欺诈和无效流量。
AD_IMPRESSION_FRAUD_25 欺诈和无效流量。
AD_IMPRESSION_FRAUD_10 欺诈和无效流量。
AD_IMPRESSION_FRAUD_8 欺诈和无效流量。
AD_IMPRESSION_FRAUD_6 欺诈和无效流量。
AD_IMPRESSION_FRAUD_4 欺诈和无效流量。
AD_IMPRESSION_FRAUD_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。

成人

可能的 Integral Ad Science 成人内容选项。

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

酒精饮料

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

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

IllegalDownloads

可能的 Integral Ad Science 非法下载选项。

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

药品

可能的 Integral Ad Science Drugs 选项。

枚举
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 选项。

枚举
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_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 时,此值将会填充到 AssignTargetingOption 的详情字段中。

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

string

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

targetingOptionId

string

必需。TARGETING_TYPE_POI 类型的 TargetingOptiontargetingOptionId

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

如果您要定位从地址或地图注点名称中移除的特定纬度/经度坐标,则可以通过以下方式生成所需的定位选项 ID:将所需坐标值四舍五入到小数点后 6 位,移除小数,然后连接以英文分号分隔的字符串值。例如,您可以使用定位选项 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 时,此值将会填充到 AssignTargetingOption 的详情字段中。

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

string

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

targetingOptionId

string

必需。TARGETING_TYPE_BUSINESS_CHAIN 类型的 TargetingOptiontargetingOptionId

您可以使用 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 时,此值将会填充到 AssignTargetingOption 的详情字段中。

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

列出分配给广告组的定位选项。