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)

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

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 (FirstAndThirdPartyAudienceGroup)

可选。所包含的第一方和第三方受众群体组的第一方和第三方受众群体 ID 及最近访问时间。每个第一方和第三方受众群体组都只包含第一方和第三方受众群体 ID。每个第一方和第三方受众群体组之间的关系为 INTERSECTION，结果会与其余受众群体组进行 UNION 运算。系统会忽略具有相同设置的重复组。

object (GoogleAudienceGroup)

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

object (CustomListGroup)

可选。所包含的自定义名单组的自定义名单 ID。仅包含自定义列表 ID。

object (CombinedAudienceGroup)

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

object (FirstAndThirdPartyAudienceGroup)

可选。被排除的第一方和第三方受众群体组的第一方和第三方受众群体 ID 及最近访问时间。用于排除性定位。此群组与其他排除的受众群体组的并集的补集用作任何正向受众群体定位的交集。所有项在逻辑上彼此“或”的关系。

object (GoogleAudienceGroup)

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

object (FirstAndThirdPartyAudienceTargetingSetting)

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

string (int64 format)

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

enum (Recency)

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

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。

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 (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)

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

enum (SensitiveCategory)

必需。一个枚举，用于表示要排除的 DV360 敏感类别内容。

string

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

enum (ContentTheme)

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

enum (ContentTheme)

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

enum (Exchange)

必需。相应交易所的枚举值。

string

必需。类型为 TARGETING_TYPE_SUB_EXCHANGE 的 TargetingOption 的 targetingOptionId。

object (Adloox)

第三方品牌验证机构 - Scope3（之前称为 Adloox）。

object (DoubleVerify)

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

object (IntegralAdScience)

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

enum (AdlooxCategory)

要排除的 Scope3 类别。

enum (FraudIvtMfaCategory)

可选。要排除的 Scope3 欺诈 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要排除的 GARM 风险范围。

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

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

enum (DisplayIabViewability)

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

enum (VideoIabViewability)

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

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 之间（包含首尾）。

string

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

string

必需。类型为 TARGETING_TYPE_POI 的 TargetingOption 的 targetingOptionId。

可以使用 targetingTypes.targetingOptions.search 检索接受的 POI 定位选项 ID。

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

number

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

number

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

number

必需。将定位到的 POI 周围区域的半径。半径的单位由 proximityRadiusUnit 指定。如果单位为 DISTANCE_UNIT_KILOMETERS，则必须介于 1 到 800 之间；如果单位为 DISTANCE_UNIT_MILES，则必须介于 1 到 500 之间。

enum (DistanceUnit)

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

string

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

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)

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

enum (AudioContentType)

必需。音频内容类型。

string

必需。当 targetingType 为 TARGETING_TYPE_CONTENT_GENRE 时，targetingOptionId 字段。

string

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

boolean

指明相应选项是否被负向定位。

string

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

boolean

指明相应选项是否被负向定位。

string

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

boolean

指明相应选项是否被负向定位。

enum (SessionPosition)

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