REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

string (int64 format)

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

boolean

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

string

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

string

必需。targetingType 为 TARGETING_TYPE_APP_CATEGORY 时的 targetingOptionId 字段。

boolean

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

string

必需。应用的 ID。

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

string

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

boolean

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

enum (AppPlatform)

指明目标应用的平台。如果未指定此字段，则系统会假定应用平台为移动平台（即 Android 或 iOS），我们会根据应用 ID 推导出适当的移动平台。

string

必需。网址，例如 example.com。

DV360 支持子目录定位（仅限 2 个级别，例如 www.example.com/one-subdirectory-level/second-level），也支持子域名定位（最多 5 个级别，例如 five.four.three.two.one.example.com）。

boolean

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

enum (DayOfWeek)

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

integer

必需。日期和时间定位条件的开始小时。必须介于 0（一天的开始）和 23（一天结束前 1 小时）之间。

integer

必需。日期和时间定位条件的结束小时。必须介于 1（一天开始后 1 小时）和 24（一天结束）之间。

enum (TimeZoneResolution)

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

对于需求开发订单项，此字段始终为 TIME_ZONE_RESOLUTION_ADVERTISER。

enum (AgeRange)

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

string (int64 format)

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

boolean

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

string (int64 format)

必需。邻近位置列表的 ID。应引用类型为 TARGETING_LOCATION_TYPE_PROXIMITY 的 LocationList 资源的 locationListId 字段。

number

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

enum (ProximityRadiusUnit)

必需。半径距离单位。

enum (Gender)

必需。受众群体的性别。

enum (VideoPlayerSize)

必需。视频播放器尺寸。

string

必需。targetingType 为 TARGETING_TYPE_USER_REWARDED_CONTENT 时的 targetingOptionId 字段。

enum (UserRewardedContent)

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

enum (ParentalStatus)

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

enum (ContentInstreamPosition)

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

enum (AdType)

仅限输出。要定位的广告类型。仅适用于广告订单定位，并且支持指定广告类型的新订单项默认会沿用此定位选项。可能的值包括：

• AD_TYPE_VIDEO，当 lineItemType 为 LINE_ITEM_TYPE_VIDEO_DEFAULT 时，新订单项将沿用此设置。
• AD_TYPE_AUDIO，当 lineItemType 为 LINE_ITEM_TYPE_AUDIO_DEFAULT 时，新订单项将沿用此设置。

enum (ContentOutstreamPosition)

必需。内容外播位置。

enum (AdType)

仅限输出。要定位的广告类型。仅适用于广告订单定位，并且支持指定广告类型的新订单项默认会沿用此定位选项。可能的值包括：

• AD_TYPE_DISPLAY，当 lineItemType 为 LINE_ITEM_TYPE_DISPLAY_DEFAULT 时，新订单项将沿用此设置。
• AD_TYPE_VIDEO，当 lineItemType 为 LINE_ITEM_TYPE_VIDEO_DEFAULT 时，新订单项将沿用此设置。

enum (DeviceType)

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

number

仅限输出。利用出价调节系数，您可以根据设备类型提高或降低广告展示频率。它会根据原始出价应用一个调节系数。如果此字段的值为 0，则表示此字段不适用，而不是在原始出价的基础上乘以 0。

例如，如果未应用调节系数的出价为 10.0 美元，而平板电脑的调节系数为 1.5，则平板电脑的最终出价将为 15.0 美元。

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

object (GoogleAudienceGroup)

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

object (CustomListGroup)

可选。所含产品信息组的自定义名单 ID。仅包含自定义名单 ID。

object (CombinedAudienceGroup)

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

object (GoogleAudienceGroup)

可选。已排除的 Google 受众群体组的 Google 受众群体 ID。用于排除性定位。此群组与其他排除的受众群体组的并集的补集，将用作与任何正向受众群体定位的交集。仅包含兴趣相似的受众群体、有购买意向的受众群体和已安装应用的受众群体类型的 Google 受众群体。所有项之间属于逻辑“或”关系。

object (FirstPartyAndPartnerAudienceGroup)

可选。所含第一方和合作伙伴受众群体组的第一方和合作伙伴受众群体 ID 及新近度。每个第一方和合作伙伴受众群体组仅包含第一方和合作伙伴受众群体 ID。每个第一方受众群体组和合作伙伴受众群体组之间的关系是“交集”，结果会与其他受众群体组进行“并集”运算。系统会忽略设置相同的重复群组。

object (FirstPartyAndPartnerAudienceGroup)

可选。排除的第一方和合作伙伴受众群体组的第一方和合作伙伴受众群体 ID 及新近度。用于排除性定位。此群组与其他排除的受众群体组的并集的补集，将用作与任何正向受众群体定位的交集。所有项之间属于逻辑“或”关系。

object (GoogleAudienceTargetingSetting)

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

string (int64 format)

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

object (CustomListTargetingSetting)

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

string (int64 format)

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

object (CombinedAudienceTargetingSetting)

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

string (int64 format)

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

object (FirstPartyAndPartnerAudienceTargetingSetting)

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

string (int64 format)

必需。第一方和合作伙伴受众群体定位设置的第一方和合作伙伴受众群体 ID。此 ID 为 firstPartyAndPartnerAudienceId。

enum (Recency)

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

string

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

string

必需。TARGETING_TYPE_BROWSER 类型的 TargetingOption 的 targetingOptionId。

boolean

指明此选项是否被排除性定位。同一资源上所有已分配的浏览器定位选项都必须为此字段设置相同的值。

enum (HouseholdIncome)

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

string

必需。targetingType 为 TARGETING_TYPE_ON_SCREEN_POSITION 时的 targetingOptionId 字段。

enum (OnScreenPosition)

仅限输出。屏幕上的位置。

enum (AdType)

仅限输出。要定位的广告类型。仅适用于广告订单定位，并且支持指定广告类型的新订单项默认会沿用此定位选项。可能的值包括：

• AD_TYPE_DISPLAY，当 lineItemType 为 LINE_ITEM_TYPE_DISPLAY_DEFAULT 时，新订单项将沿用此设置。
• AD_TYPE_VIDEO，当 lineItemType 为 LINE_ITEM_TYPE_VIDEO_DEFAULT 时，新订单项将沿用此设置。

string

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

string

必需。TARGETING_TYPE_CARRIER_AND_ISP 类型的 TargetingOption 的 targetingOptionId。

boolean

指明此选项是否被排除性定位。同一资源上所有已分配的运营商和 ISP 定位选项都必须为此字段设置相同的值。

string

必需。关键字，例如 car insurance。

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

boolean

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

string

可选。要豁免该关键字的政策名称。

如果尝试定位违反政策的关键字，系统返回的错误消息中会包含相关政策的名称。在此字段中使用该名称，即可让指定关键字免受该政策的约束。

此字段仅适用于分配给需求开发资源的肯定定位关键字。

string (int64 format)

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

string

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

string

必需。当 targetingType 为 TARGETING_TYPE_OPERATING_SYSTEM 时，targetingOptionId 字段中填充的定位选项 ID。

boolean

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

string

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

string

必需。targetingType 为 TARGETING_TYPE_DEVICE_MAKE_MODEL 时的 targetingOptionId 字段。

boolean

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

enum (Environment)

必需。投放环境。

string (int64 format)

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

string

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

string

必需。targetingType 为 TARGETING_TYPE_CATEGORY 时的 targetingOptionId 字段。

boolean

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

enum (Viewability)

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

enum (AuthorizedSellerStatus)

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

string

必需。TARGETING_TYPE_AUTHORIZED_SELLER_STATUS 类型的 TargetingOption 的 targetingOptionId。

string

仅限输出。语言的显示名称（例如“法语”）。

string

必需。TARGETING_TYPE_LANGUAGE 类型的 TargetingOption 的 targetingOptionId。

boolean

指明此选项是否被排除性定位。同一资源上所有已分配的语言定位选项都必须为此字段设置相同的值。

string

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

string

必需。TARGETING_TYPE_GEO_REGION 类型的 TargetingOption 的 targetingOptionId。

enum (GeoRegionType)

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

boolean

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

string (int64 format)

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

enum (ContentRatingTier)

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

此字段仅接受值 CONTENT_RATING_TIER_UNRATED。

enum (SensitiveCategory)

必需。一个枚举，表示要排除的 Display & Video 360 敏感内容类别。

此字段仅接受以下值：

• SENSITIVE_CATEGORY_EMBEDDED_VIDEO
• SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

string

必需。要排除的内容主题的 ID。

enum (ContentTheme)

仅限输出。DV360 内容主题分类器的枚举。

enum (ContentTheme)

必需。一个枚举，表示被归类为“排除”的 DV360 内容主题。

enum (Exchange)

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

string

必需。TARGETING_TYPE_SUB_EXCHANGE 类型的 TargetingOption 的 targetingOptionId。

object (DoubleVerify)

第三方品牌验证机构 - DoubleVerify。

object (IntegralAdScience)

第三方品牌验证机构 - Integral Ad Science。

object (Peer39)

第三方品牌验证机构 - Peer39。

object (BrandSafetyCategories)

DV 品牌保障控制功能。

enum (AgeRating)

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

object (AppStarRating)

避免对具有以下星级的应用出价。

object (DisplayViewability)

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

object (VideoViewability)

视频可见度设置（仅适用于视频订单项）。

object (FraudInvalidTraffic)

避免定位到具有欺诈及无效流量比率记录的网站和应用。

string (int64 format)

DoubleVerify 提供的自定义细分受众群 ID。该 ID 必须以“51”开头，且由 8 位数字组成。自定义细分受众群 ID 不能与以下任何字段一起指定：

• brandSafetyCategories
• avoidedAgeRatings
• appStarRating
• fraudInvalidTraffic

boolean

未知或无法评级。

enum (HighSeverityCategory)

品牌保障高严重性回避类别。

enum (MediumSeverityCategory)

品牌保障中等严重程度回避类别。

enum (StarRating)

避免对具有以下星级的应用出价。

boolean

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

enum (IAB)

定位到网站和应用内广告资源，以最大限度地提升 IAB 可见率。

enum (ViewableDuring)

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

enum (VideoIAB)

定位到网站广告资源，以最大限度地提升 IAB 可见率。

enum (VideoViewableRate)

定位到网站广告资源，以最大限度地提升完全可见率。

enum (PlayerImpressionRate)

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

enum (FraudOption)

避免定位到具有欺诈及无效流量记录的网站和应用。

boolean

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

enum (TRAQScore)

真实广告质量（仅适用于展示广告订单项）。

boolean

品牌保障 - 无法分级。

enum (Adult)

品牌保障 - 成人内容。

enum (Alcohol)

品牌保障 - 酒精饮料。

enum (IllegalDownloads)

品牌保障 - 非法下载。

enum (Drugs)

品牌保障 - 毒品。

enum (HateSpeech)

品牌保障 - 仇恨言论。

enum (OffensiveLanguage)

品牌保障 - 冒犯性语言。

enum (Violence)

品牌保障 - 暴力内容。

enum (Gambling)

品牌保障 - 赌博。

enum (AdFraudPrevention)

广告欺诈设置。

enum (DisplayViewability)

“展示广告可见度”部分（仅适用于展示广告订单项）。

enum (VideoViewability)

“视频可见度”部分（仅适用于视频订单项）。

string (int64 format)

Integral Ad Science 提供的自定义细分 ID。ID 必须介于 1000001 到 1999999 或 3000001 到 3999999 之间（含边界值）。

string (int64 format)

可选。Integral Ad Science 提供的质量同步自定义细分受众群 ID。ID 必须介于 3000000 到 4999999 之间（含 和 ）。

enum (FraudIvtMfaCategory)

可选。要排除的 Peer39 欺诈性 IVT MFA 类别。

enum (GarmRiskExclusion)

可选。要排除的成人内容与露骨色情内容 GARM 风险范围。

enum (GarmRiskExclusion)

可选。要排除的犯罪与有害行为内容 GARM 风险范围。

enum (GarmRiskExclusion)

可选。要排除的武器与弹药内容 GARM 风险范围。

enum (GarmRiskExclusion)

可选。要排除的死亡、受伤或军事冲突内容 GARM 风险范围。

enum (GarmRiskExclusion)

可选。要排除的有争议的敏感社会问题内容 GARM 风险范围。

enum (GarmRiskExclusion)

可选。要排除的违禁药品/酒精饮料内容 GARM 风险范围。

enum (GarmRiskExclusion)

可选。要排除的在线盗版内容 GARM 风险范围。

enum (GarmRiskExclusion)

可选。要排除的仇恨言论与攻击性行为内容 GARM 风险范围。

enum (GarmRiskExclusion)

可选。要排除的淫秽与脏话内容 GARM 风险范围。

enum (GarmRiskExclusion)

可选。要排除的垃圾内容或有害内容 GARM 风险范围。

enum (GarmRiskExclusion)

可选。要排除的恐怖主义内容 GARM 风险范围。

enum (GarmRiskExclusion)

可选。要排除的虚假信息内容 GARM 风险范围。

enum (DisplayIabViewability)

可选。展示广告的 IAB 可见度阈值。

enum (VideoIabViewability)

可选。视频广告的 IAB 可见度阈值。

string

仅限输出。地图注点的显示名称（例如“时代广场”“太空针塔”），后跟其完整地址（如有）。

string

必需。TARGETING_TYPE_POI 类型的 TargetingOption 的 targetingOptionId。

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

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

number

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

number

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

number

必需。要定位的地图注点周围区域的半径。半径的单位由 proximityRadiusUnit 指定。如果单位为 DISTANCE_UNIT_KILOMETERS，则必须为 1 到 800；如果单位为 DISTANCE_UNIT_MILES，则必须为 1 到 500。

enum (DistanceUnit)

必需。用于衡量定位半径的距离单位。

string

仅限输出。连锁企业的显示名称，例如“肯德基”“大通银行”。

string

必需。TARGETING_TYPE_BUSINESS_CHAIN 类型的 TargetingOption 的 targetingOptionId。

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

number

必需。连锁企业周围要定位的区域半径。半径单位由 proximityRadiusUnit 指定。如果单位为 DISTANCE_UNIT_KILOMETERS，则必须为 1 到 800；如果单位为 DISTANCE_UNIT_MILES，则必须为 1 到 500。在这两种情况下，最小增量均为 0.1。如果输入值过于精细，系统会将其四舍五入为可接受的值，例如 15.57 将变为 15.6。

enum (DistanceUnit)

必需。定位半径的距离单位。

string

必需。targetingType 为 TARGETING_TYPE_CONTENT_DURATION 时的 targetingOptionId 字段。

enum (ContentDuration)

仅限输出。内容时长。

string

必需。targetingType 为 TARGETING_TYPE_CONTENT_STREAM_TYPE 时的 targetingOptionId 字段。

enum (ContentStreamType)

仅限输出。内容流类型。

enum (NativeContentPosition)

必需。内容位置。

enum (Omid)

必需。已启用开放式衡量的广告资源的类型。

enum (AudioContentType)

必需。音频内容类型。

string

必需。targetingType 为 TARGETING_TYPE_CONTENT_GENRE 时的 targetingOptionId 字段。

string

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

boolean

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

string

YouTube 视频 ID，如 YouTube 观看页面上所示。

boolean

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

string

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

boolean

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

enum (SessionPosition)

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

string (int64 format)

必需。相似受众群体的 ID。

boolean

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

string (int64 format)

必需。Google 受众群体的 ID。

enum (GoogleAudienceType)

必需。Google 受众群体的类型。

boolean

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

string (int64 format)

必需。自定义名单的 ID。

enum (CustomListType)

必需。自定义名单的类型。

string (int64 format)

必需。组合的受众群体的 ID。

string (int64 format)

必需。第一方或合作伙伴受众群体的 ID。

boolean

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

string

必需。TARGETING_TYPE_AUCTION_PACKAGE 类型的 TargetingOption 的 targetingOptionId。

string

仅限输出。竞价包的显示名称。

string (int64 format)

必需。YouTube 频道包的 ID。

boolean

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