结构化数据 - v7 - 订单项

如需查看格式说明，请参阅概览。

字段必需类型可写入说明
订单项 ID仅在修改现有订单项时必填integer否订单项的数字 ID 值。如果留空，系统会创建一个新订单项并为其分配唯一 ID。（可选）在创建新的订单项时，您可以使用自定义标识符将 TrueView 广告组分配给新的订单项。自定义标识符的格式为“ext[自定义标识符]”，例如 ext123。当该文件被上传并处理后，所有自定义标识符都将替换为由 DBM 分配的 ID，并且系统会根据自定义标识符关联相应对象（例如，从广告组到订单项）。
Io ID是integer否广告订单的数字 ID 值。您可为要与此订单项同时创建的广告订单指定自定义标识符（例如“ext[自定义广告订单标识符]”）。
Io 名称否字符串否广告订单名称
类型是字符串是条目的类型。只能在创建时写入，不能在修改时写入。
  • 显示
  • 视频
  • TrueView
  • 音频
子类型是字符串是订单项区分不同格式的必填字段
  • 简单
  • 不可跳过广告
  • 操作
  • 覆盖面
  • 查看
  • 音频
  • OTT 服务
  • 移动应用安装
  • 移动应用购买
  • 简约 OTT 服务
  • 不可跳过的 OTT 服务
  • 扩大覆盖面
  • 目标频次
名称是字符串是条目的名称。
时间戳修改现有条目时必填integer否条目的时间戳，系统使用它来验证条目在下载和上传之间是否发生更改。
状态是字符串是条目的状态设置。
  • 有效
  • 已暂停
  • 草稿
  • 已归档
开始日期是字符串是条目的排期开始日期的时间戳，格式为 MM/DD/YYYY 或“与广告订单相同”，以便使用与父级广告订单相同的开始日期。
结束日期是字符串是条目的排期结束日期的时间戳，格式为 MM/DD/YYYY 或“与广告订单相同”，以便使用与父级广告订单相同的结束日期。
预算类型是字符串是指定预算是基于金额还是基于展示次数。如果此条目的广告订单启用了“自动分配预算”功能，您可以将此设置设为“自动”，以允许 DBM 自动为此条目设置预算。
  • 金额
  • 展示次数
  • 无限制
  • 自动
  • TrueView 预算
预算金额如果“类型”为“展示”“视频”或“音频”，则必须提供float是预算类型的正预算金额。这可以是简单的整数展示价值，也可以是表示货币金额的浮点数。币种将以标准单位（而不是货币单位的 1/1,000,000）显示，以广告客户的币种显示。如果您在条目中设置了“自动”预算分配，您可以指定支出下限（例如，“至少支出”此金额）。
进度是字符串是根据投放安排金额支出的时间段。
  • 每天
  • 每月
  • 飞机
TrueView 订单项只能是“每日”或“排期”
投放节奏是字符串是此条目的投放节奏。
  • 尽快
  • 均匀
  • 提前
TrueView 订单项只能为“尽快”或“均匀”
投放节奏当“类型”为“展示广告”“视频广告”或“音频”时，必填。当“类型”为“TrueView”且“投放节奏”为“每日”时，为必需项。float是由投放节奏类型设置的每个时间段内的支出金额。
已启用频次是字符串是启用/停用订单项基于展示次数的频次上限。
  • TRUE
  • FALSE
频次曝光次数当“已启用频次”为“TRUE”时，必须填写此字段integer是表示指定频次金额内展示次数的正整数金额，即“显示 y 期的 x 次展示”中的 x。
频次时段当“已启用频次”为“TRUE”时，必须填写此字段字符串是指定频次上限的时间段单位。对于 TrueView 订单项，支持的时间段包括天、周、月。
  • 分钟
  • 小时
  • 星期几
  • 周
  • 月
  • 生命周期
频次金额当“已启用频次”为“TRUE”时，必须填写此字段integer是展示频次时段类型时间长度的正整数，即“在 y 期间显示 x 次展示”中的 y。TrueView 订单项不支持此金额。
已启用 TrueView 观看频次当“类型”为“TrueView”时为必填项字符串是启用/停用 TrueView 订单项基于观看的频次上限
  • TRUE
  • FALSE
TrueView 观看频次曝光次数如果“已启用 TrueView 观看频次”为“TRUE”，则必须提供integer是TrueView 观看次数对应的正整数值，即“在相应时间段内获得 x 次观看”中的 x
TrueView 观看频次时段如果“已启用 TrueView 观看频次”为“TRUE”，则必须提供字符串是指定 TrueView 基于观看的频次上限的时间段单位
  • 星期几
  • 周
  • 月
合作伙伴收入模式否字符串是合作伙伴收入模式是yon控制 Bid Manager 中收入计算方式的机制。使用合作伙伴收入模式可跟踪服务费的加价。如果包含“合作伙伴收入模式”列，则应指定“合作伙伴收入金额”列。
  • TMCM - 总媒体费用加价
  • MCM - 媒体费用加价
  • CPM - 每千次展示费用
合作伙伴收入金额仅当指定“合作伙伴收入模式”列时才需要。float是与合作伙伴收入模式对应的正浮点值。只有在指定了“合作伙伴收入模式”列的情况下，才适用。
转化统计类型当“类型”为“展示”“视频”“音频”或“TrueView”时，必须提供字符串是选择要统计的转化类型。
  • 全部统计
  • 点击后统计
  • 计数 (%)
转化计数百分比当“类型”为“展示”“视频”“音频”或“TrueView”时，必须提供float是指定“计数 %”转化计数类型的百分比。将 % 的格式设置为浮点数 (3.123% = 3.123)，精度限制为千位（小数点后 3 位）。
转化 Floodlight 活动 ID否字符串, 列表列表是

用于转化和相关设置的 Floodlight 活动。

此列使用 Display & Video 360 API FloodlightActivity 资源 ID 以及浏览后和点击后时间范围的衡量数据（以分钟为单位）。

列表格式列表 = ((FloodlightActivity.FloodlightActivityId; view_window_minutes; click_window_minutes;);(FloodlightActivity.FloodlightActivityId; view_window_minutes; click_window_minutes;);)。

主要归因模型 ID否integer是用于所关联订单项的归因模型 ID。
费用否字符串, 列表列表是此参评申请的所有费用。列表格式 =（费用类别；费用金额；费用类型；已开具帐单；）。
  • 费用类别
    • 每千次展示费用
    • 媒体
  • 费用金额
    • 浮点值
    • Pct 为浮点数
  • 费用类型
    • （字符串，参见费用表）
  • 已开具帐单
    • True
    • False
    • 空白

示例 '(CPM; 2; Display & Video 360 费用; False) ; (Media; 13; Default; True);'
下表中提供了可接受的值：

费用类别费用类型“账单结算”选项
每千次展示费用/媒体默认不允许（留空）
每千次展示费用/媒体第三方广告服务器不允许（留空）
每千次展示费用/媒体DoubleVerify允许 (True/False)
每千次展示费用/媒体Adsafe不允许（留空）
每千次展示费用/媒体AdXpose 费用不允许（留空）
每千次展示费用/媒体Vizu 费用不允许（留空）
每千次展示费用/媒体Aggregate Knowledge不允许（留空）
每千次展示费用/媒体Teracent不允许（留空）
每千次展示费用/媒体Evidon 费用不允许（留空）
每千次展示费用/媒体代理机构交易公司费用不允许（留空）
每千次展示费用/媒体Adloox允许 (True/False)
每千次展示费用ShopLocal必需 (True)
每千次展示费用TrustMetrics不允许（留空）
每千次展示费用Integral Ad Science视频允许 (True/False)
每千次展示费用MOAT视频不允许（留空）
媒体Display & Video 360 费用必需 (True)
媒体媒体费用数据不允许（留空）
媒体Scibids 费用必需 (True)
集成代码否字符串是用于跟踪的可选代码。
具体说明否字符串是字符串格式的条目详情。
出价策略类型如果“类型”为“展示”“视频”或“音频”，则必须提供字符串是 选择适用的出价策略
    ：
  • 最大限度地降低：在用尽预算的同时，最大限度地降低 CPA/CPC
  • 最大限度地争取：在用尽预算的同时，最大限度地争取展示机会价值或优质展示机会
  • 优于：达到或超越 X CPA/CPC 的目标
  • 优化每千次可见展示费用：将每千次可见展示费用出价优化为 X
  • 固定：指定 X 的固定出价
出价策略值除非“出价策略类型”为“最小化”“最大化”或“类型”为“TrueView”，否则为必选float是对于“节拍”“优化 VCPM”和“固定策略”类型，请为目标出价选择一个值。
请注意，对于“最小化”或“最大化”出价策略类型，不需要设置出价策略值
出价策略单元如果“出价策略类型”为“节拍”、“最小化”或“最大化”，则必须提供字符串是对于“节拍”“最小化”或“最大化”策略类型，请选择相应的单位：
  • 每次转化费用
  • CPC
  • 自定义展示次数值/费用
  • 完整播放且可见可听
  • IVO_TEN
  • AV_VIEWED
出价策略不得超过如果“类型”为“展示”“视频”或“音频”，则必须提供float是设置“不超过”每千次展示费用值。如果为 0，则未启用“请勿超过”。仅当出价策略为“最小化”“最大化”或“节奏”时，此字段才可用。
为交易应用底价如果“出价策略类型”为“最小化”或“最大化”，则必须提供字符串是是否优先处理交易而非公开竞价广告资源
  • TRUE
  • FALSE
算法 ID在“出价策略单元”自定义展示次数值/费用时必填。integer是如果出价策略单元设置为自定义展示次数值/费用，则必须使用此对应的算法 ID。
广告素材分配否字符串、列表是

要分配给条目的广告素材 ID 列表。

此列使用 Display & Video 360 API Creative 资源 ID。

列表格式 = (Creative.creativeId; Creative.creativeId; 等)。此列表是按数字顺序生成的，

在上传时，用户还可以添加 Campaign Manager 360 展示位置 ID。展示位置 ID 必须以字母“CM”开头，例如“CM789”。

例如：(123;CM789;)。

地理位置定位 - 包含否字符串、列表是

要纳入定位条件中的地理位置的列表。

此列对定位类型“TARGETING_TYPE_GEO_REGION”使用 Display & Video 360 API TargetingOption 资源 ID。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表是按数字顺序生成的，

地理位置定位 - 排除否字符串、列表是

要在定位条件中排除的地理位置的列表。

此列对定位类型“TARGETING_TYPE_GEO_REGION”使用 Display & Video 360 API TargetingOption 资源 ID。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表是按数字顺序生成的，

地理位置、区域位置列表定位 - 包含否字符串、列表是要包含的地理区域位置列表 ID 列表。列表格式 = (11; 22; 33;)。
地理位置 区域位置列表 定位 - 排除否字符串、列表是要排除的地理区域位置列表 ID 列表。列表格式 = (11; 22; 33;)。
邻近区域定位否字符串, 列表列表是每个邻近区域定位目标的列表，格式为“(Latitude; Longitude; Radius; Unit; FullAddress;)。纬度介于 -90 度（含）和 90 度（含）之间；经度介于 -180 度（含）到 180 度（含）之间；半径为 1 到 500（含）之间的距离，以单位表示；单位可以是“mi”或“km”；FullAddress 是可选的。例如："(38.907192; -77.03687; 1.0; mi; 华盛顿特区，美国哥伦比亚特区；）；(40.712775; -74.005972; 20.5; km; 40.712775, -74.005972;); (20.000234; -56.675423; 5.0; mi; ;);"。
邻近地理位置列表定位否字符串, 列表列表是广告订单或非 TrueView 订单项的邻近区域列表定位条件列表，每个定位条件都采用“(ProximityListId; Radius; Unit; );”格式。ProximityListId 是广告客户资源下的地理位置列表 ID。半径是 1 到 500（含）之间的距离，以单位表示；单位可以是“mi”或“km”；您只能为每个实体定位两个地理位置列表以及地理位置区域位置列表。例如：“(10041691678; 20.0; mi;); (10038858567; 20.5; km;);”。
语言定位 - 包含否字符串、列表是

要纳入定位条件的语言的列表。

此列对定位类型“TARGETING_TYPE_LANGUAGE”使用 Display & Video 360 API TargetingOption 资源 ID。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表是按数字顺序生成的，

语言定位 - 排除否字符串、列表是

要在定位条件中排除的语言的列表。

此列对定位类型“TARGETING_TYPE_LANGUAGE”使用 Display & Video 360 API TargetingOption 资源 ID。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表是按数字顺序生成的，

设备定位 - 包含否字符串、列表是

要纳入定位条件的设备的列表。

对于以下定位类型，此列使用 Display & Video 360 API TargetingOption 资源 ID：

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表是按数字顺序生成的，

设备定位 - 排除否字符串、列表是

要在定位条件中排除的设备的列表。

对于以下定位类型，此列使用 Display & Video 360 API TargetingOption 资源 ID：

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表是按数字顺序生成的，

浏览器定位 - 包含否字符串、列表是

要纳入定位条件中的浏览器的列表。

此列对定位类型“TARGETING_TYPE_BROWSER”使用 Display & Video 360 API TargetingOption 资源 ID。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表是按数字顺序生成的，

浏览器定位 - 排除否字符串、列表是

要在定位条件中排除的浏览器列表。

此列对定位类型“TARGETING_TYPE_BROWSER”使用 Display & Video 360 API TargetingOption 资源 ID。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表是按数字顺序生成的，

数字内容标签 - 排除否字符串、列表是要排除的数字内容标签的列表。列表格式 =（G;PG；等等）。
  • G
  • PG
  • T
  • MA
  • ?
品牌保障敏感度设置否字符串是选择敏感度设置可根据广告资源周围内容的主题来屏蔽广告资源。
  • 不屏蔽
  • 使用 Campaign Manager 360 验证
  • 使用自定义
品牌保障自定义设置当“品牌保障自定义设置”为“使用自定义设置”时，必须提供字符串、列表是如果“品牌保障敏感度设置”为“使用自定义内容”，请指定一系列标准敏感内容类别。例如（色情、酒精饮料、烟草等）。
  • 色情内容
  • 诋毁性内容
  • 下载和分享
  • 武器
  • 赌博
  • 暴力内容
  • 挑逗性内容
  • 脏话
  • 酒精饮料
  • 毒品
  • 烟草
  • 政治
  • 宗教
  • 悲剧
  • 交通事故
  • 敏感的社会问题
  • 骇人听闻
第三方验证服务否字符串是第三方验证服务提供商。
  • 无
  • Integral Ad Science
  • DoubleVerify
  • Adloox
第三方验证标签否字符串、列表是如果第三方验证服务不是“无”，请指定所选提供商支持的标签列表。
渠道定位 - 包含否字符串、列表是

要纳入定位条件中的渠道的列表。

此列使用 Display & Video 360 API Channel 资源 ID。

列表格式 = (Channel.channelId; Channel.channelId; 等)。

渠道定位 - 排除否字符串、列表是

要在定位条件中排除的渠道的列表。

此列使用 Display & Video 360 API Channel 资源 ID。

列表格式 = (Channel.channelId; Channel.channelId; 等)。

网站定位 - 包含否字符串、列表是

要纳入定位条件的网站的列表。该列表是网址字符串。

列表格式 = (someurl.com; someurltwo.com; 等)。此列表按字母升序生成，

网站定位 - 排除否字符串、列表是

要在定位条件中排除的网站的列表。该列表是网址字符串。

列表格式 = (someurl.com; someurltwo.com; 等)。此列表按字母升序生成，

应用定位 - 包含否字符串、列表是

要纳入定位条件中的应用的列表。该列表是应用平台和应用平台 ID 的串联字符串。

以下值用于定义应用平台：

  • APP（这包括 Android Play 商店和 Apple App Store 平台）
  • ROKU_APP
  • AMAZON_FIRETV_APP
  • XBOX_APP
  • PLAYSTATION_APP
  • APPLE_TV_APP
  • SAMSUNG_TV_APP
  • ANDROID_TV_APP
  • GENERIC_CTV_APP
该 ID 由相关平台提供，例如 Android Play 商店中的软件包 ID（例如：com.google.android.gm）或 Apple App Store 中的应用 ID（例如：422689480）。

应用平台和 ID 的串联字符串之间以英文冒号分隔，例如：APP:com.google.android.gm。

列表格式 =（APP:com.google.android.gm; APP:422689480; 等）。此列表按字母升序生成，

应用定位 - 排除否字符串、列表是

要在定位条件中排除的应用的列表。该列表是应用平台和应用平台 ID 的串联字符串。

以下值用于定义应用平台：

  • APP（这包括 Android Play 商店和 Apple App Store 平台）
  • ROKU_APP
  • AMAZON_FIRETV_APP
  • XBOX_APP
  • PLAYSTATION_APP
  • APPLE_TV_APP
  • SAMSUNG_TV_APP
  • ANDROID_TV_APP
  • GENERIC_CTV_APP
该 ID 由相关平台提供，例如 Android Play 商店中的软件包 ID（例如：com.google.android.gm）或 Apple App Store 中的应用 ID（例如：422689480）。

应用平台和 ID 的串联字符串之间以英文冒号分隔，例如：APP:com.google.android.gm。

列表格式 =（APP:com.google.android.gm; APP:422689480; 等）。此列表按字母升序生成，

应用合集定位 - 包含否字符串、列表是

要纳入到定位条件中的应用集合的列表。

此列对定位类型“TARGETING_TYPE_APP_CATEGORY”使用 Display & Video 360 API TargetingOption 资源 ID。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。

应用合集定位 - 排除否字符串、列表是

要在定位条件中排除的应用集合的列表。

此列对定位类型“TARGETING_TYPE_APP_CATEGORY”使用 Display & Video 360 API TargetingOption 资源 ID。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。

类别定位 - 包含否字符串、列表是

要包含在定位条件中的类别列表。此列对定位类型“TARGETING_TYPE_CATEGORY”使用 Display & Video 360 API TargetingOption 资源 ID。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表是按数字顺序生成的，

类别定位 - 排除否字符串、列表是要在定位条件中排除的类别列表。此列对定位类型“TARGETING_TYPE_CATEGORY”使用 Display & Video 360 API TargetingOption 资源 ID。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表是按数字顺序生成的，

内容类型定位 - 包含否字符串、列表是

要包含在定位条件中的内容类型的列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID 作为定位类型“TARGETING_TYPE_CONTENT_GENRE”

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表是按数字顺序生成的，

内容类型定位 - 排除否字符串、列表是

要在定位条件中排除的内容类型的列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID 作为定位类型“TARGETING_TYPE_CONTENT_GENRE”

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表是按数字顺序生成的，

关键字定位 - 包含否字符串、列表是

要包含在定位条件中的关键字字符串列表。

此列表按字母升序生成，

关键字定位 - 排除否字符串、列表是

要在定位条件中排除的关键字字符串列表。

此列表按字母升序生成，

关键字列表定位 - 排除否字符串、列表是

要在定位条件中排除的否定关键字列表的列表。

此列使用 Display & Video 360 API NegativeKeywordList 资源 ID。

列表格式 = (NegativeKeywordList.NegativeKeywordListId; NegativeKeywordList.NegativeKeywordListId; 等)。此列表是按数字顺序生成的，

优化型定位否字符串是启用优化型定位。
  • TRUE
  • FALSE
受众群体定位 - 包含否字符串，键值对列表是

要纳入到定位条件中的受众群体名单的列表。

此列使用 Display & Video 360 API FirstAndThirdPartyAudience 资源 ID。

对于第一方受众群体名单，每个受众群体都会列为一对 FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId 和新近度设置。一对是 (1;1d;)，其中 1d 是表示 1 天新近度的样本新近度。新近度不适用于第三方受众群体，因此列表格式为 (3;);(4;);。若要使用“AND”和“OR”两组受众群体，请效仿以下示例：要将有新近度的成对组合与不具有新近度的成对组合使用：'(1;1d;);(2;365d;的主要原因：(3;);(4;5m;);(5;all; AdSense'。这意味着（列表 1 的新近度为 1 天；列表 2 的新近度为 365 天）AND（列表 3 没有指定新近度或列表 4 的新近度为 5 分钟，或者列表 5 包含所有用户）。

有效的新近值为：

  • 全部
  • 100 万
  • 5 分钟
  • 10m
  • 15m
  • 30m
  • 1 小时
  • 2 小时
  • 3 小时
  • 6 小时
  • 12 小时
  • 1 天
  • 2 天
  • 3 天
  • 5 天
  • 7 天
  • 10 天
  • 14 天
  • 15 天
  • 21 天
  • 28天
  • 30 天
  • 45 天
  • 60 天
  • 90 天
  • 120 天
  • 180 天
  • 270 天
  • 365 天
受众群体定位 - 排除否字符串，键值对列表是

要在定位条件中排除的受众群体名单的列表。

此列使用 Display & Video 360 API FirstAndThirdPartyAudience 资源 ID。

如果受众群体名单是第一方受众群体名单，则每个受众群体都会列为一对 FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId 和新近度设置。一对是 (1;1d;)，其中 1d 是表示 1 天新近度的样本新近度。但是，对于第三方受众群体，无法提供新近度，因此列表格式为 (3;);(4;);。

名单格式 = ((FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; recency optional;); (FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; recency optional;);)
示例："(1;1d;);(2;);"。

有效的新近值为：

  • 全部
  • 100 万
  • 5 分钟
  • 10m
  • 15m
  • 30m
  • 1 小时
  • 2 小时
  • 3 小时
  • 6 小时
  • 12 小时
  • 1 天
  • 2 天
  • 3 天
  • 5 天
  • 7 天
  • 10 天
  • 14 天
  • 15 天
  • 21 天
  • 28天
  • 30 天
  • 45 天
  • 60 天
  • 90 天
  • 120 天
  • 180 天
  • 270 天
  • 365 天
兴趣相似和有购买意向的定位 - 包含否字符串、列表是

要包含的兴趣相似受众群体名单和/或有购买意向的受众群体名单。

受众群体名单 ID 可通过 Display & Video 360 界面检索。

名单格式 =（受众群体 ID、受众群体 ID 等）。此列表是按数字顺序生成的，

兴趣相似和有购买意向的定位 - 排除否字符串、列表是

要排除的兴趣相似和/或有购买意向的受众群体名单。

受众群体名单 ID 可通过 Display & Video 360 界面检索。

名单格式 =（受众群体 ID、受众群体 ID 等）。此列表是按数字顺序生成的，

组合的受众群体定位否字符串、列表是

要定位的组合受众群体名单的列表。

此列使用 Display & Video 360 API CombinedAudience 资源 ID。

名单格式 = (CombinedAudience.combinedAudienceId; CombinedAudience.combinedAudienceId；等等)。此列表是按数字顺序生成的，

自定义列表定位否字符串、列表是

要定位的自定义名单的列表。

此列使用 Display & Video 360 API CustomList 资源 ID。

列表格式 = (CustomList.customListId; CustomList.customListId; 等)。此列表是按数字顺序生成的，

广告资源来源定位 - 授权卖方选项如果“类型”为“展示”“视频”或“音频”，则必须提供字符串是设为定位到授权直销商、授权直销商和转销商或授权卖方 + 未知。“授权直接交易”是指仅定位到授权卖方。“授权直销商和转销商”是指定位到授权卖方和转销商。“授权发布商及未参与此计划的发布商”是指其将定位到授权卖方、转销商和未知卖方。
  • 授权直销商
  • 授权直销商和转销商
  • 授权发布商及未参与此计划的发布商
广告资源来源定位 - 包含如果“类型”为“展示”“视频”或“音频”，则必须提供字符串、列表是

要添加到定位条件中的广告资源来源、广告交易平台和子广告交易平台的列表。

此列使用 Display & Video 360 API InventorySource 资源 ID、已发布的广告交易平台 ID 和定位类型 TARGETING_TYPE_SUB_EXCHANGE 的 Display & Video 360 API TargetingOption 资源 ID。

列表格式 = (InventorySource.inventorySourceId; exchangesId; TargetingOption.targetingOptionId; 等)

广告资源来源定位 - 排除否字符串、列表是

要在定位条件中排除的广告资源来源、广告交易平台和子广告交易平台的列表。

此列使用 Display & Video 360 API InventorySource 资源 ID、已发布的广告交易平台 ID 和定位类型 TARGETING_TYPE_SUB_EXCHANGE 的 Display & Video 360 API TargetingOption 资源 ID。

列表格式 = (InventorySource.inventorySourceId; exchangesId; TargetingOption.targetingOptionId; 等)

广告资源来源定位 - 定位新的广告交易平台否字符串是用于定位新的广告交易平台的设置。
  • True
  • False
私下交易组定位包含否字符串、列表是

要包含在定位条件中的已分组交易 ID 的列表。您可以在“我的广告资源”的“已分组的交易”部分以及订单项、广告订单和广告系列中“广告资源来源”设置的“组”部分中找到已分组的交易 ID。

列表格式 = (DealGroupId; DealGroupId; 等)。此列表是按数字顺序生成的，

时段定位否字符串、列表是

ID 列表，其中每个时段 ID 都按以下格式构建：
daypart_id = base_dayparting_id
+ days_since_monday * 10000
+ start * 100
+ end

days_since_monday: 0=Monday, 1=Tuesday: 0 = Monday.




“本地”）。对于现有实体，时区不会更改。

此列表是按数字顺序生成的，

时段定位时区如果包含“时段定位”，则必须提供此值。字符串是用于时段定位的时区。
  • 本地广告系列
  • 广告客户
TrueView 订单项只能是“广告客户”。
环境定位否字符串、列表是要定位的环境的列表。选择一个或多个可接受的值。请注意，必须选择“网络”，才能选择“网络未优化”。
  • Web
  • 网站未优化
  • 应用
已启用可见度 Omid 定位否字符串是仅定位到可通过开放式衡量标准衡量的展示次数。
  • TRUE
  • FALSE
可见度定位 Active View否字符串是达到预计可见度百分比的目标。百分比用浮点数表示。{0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9} 中的一个
位置定位 - 在屏幕上否字符串、列表是屏幕上的广告位置定位。选择一个或多个可接受的值：
  • 首屏
  • 非首屏
  • 未知
位置定位 - 内容中的展示广告位置否字符串、列表是要定位的展示广告内容位置。选择一个或多个可接受的值：
  • 文章内嵌
  • 信息流广告
  • 横幅内嵌广告
  • 插页式广告
  • 未知
位置定位 - 内容中的视频位置否字符串、列表是要定位的视频广告内容位置。选择一个或多个可接受的值：
  • 文章内嵌
  • 信息流广告
  • 横幅内嵌广告
  • 插页式广告
  • 未知外播
  • 前贴片广告
  • 中贴片广告
  • 后贴片广告
  • 未知插播广告
位置定位 - 内容中的音频位置否字符串、列表是要定位的音频广告内容位置。选择一个或多个可接受的值：
  • 前贴片广告
  • 中贴片广告
  • 后贴片广告
  • 未知
视频播放器尺寸定位否字符串、列表是要定位的视频视频播放器的尺寸列表。选择一个或多个可接受的值：
  • 未知
  • small
  • 大
  • 高清
内容时长定位否字符串、列表是要定位的内容时长的列表。单位值为分钟。选择一个或多个可接受的值：
  • 0-1
  • 1-5
  • 5-15
  • 15-30
  • 30-60
  • 60+
  • 未知
内容流类型定位否字符串、列表是要定位的内容流类型的列表。选择一个或多个可接受的值：
  • 直播
  • 按需
音频内容类型定位否字符串、列表是要定位的音频内容类型列表。选择一个或多个可接受的值：
  • 未知
  • 在线电台
  • 在线播放音乐
  • 播客
受众特征定位：性别否字符串、列表是要定位的性别的列表。选择一个或多个可接受的值：
  • 女性
  • 男
  • 未知
受众特征定位 - 年龄否字符串、列表是定位到用户年龄段。通过选择单个“开始”年龄和“到”年龄以及是否包含未知年龄的 true/false 可指定开始/结束范围。请查看可接受的开始/结束年龄列表。
示例 1：要定位 18-55 岁且包含未知年龄，请指定以下格式 {From; To ; Include known True/False} = 18;55;true;
示例 2：如果要仅定位 35 岁以上的用户并排除未知年龄，请指定以下 = 35;+;false;。
可接受以下值：
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

“收件人”的可接受值：
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
受众特征定位家庭收入否字符串、列表是定位家庭收入范围。通过选择一个“Top_of_Range”收入范围和一个“Bottom_of_Range”收入范围，以及是否包括收入未知的家庭（true/false），即可指定起始/结束范围。请查看可接受的 Top_of_Range/Bottom_of_Range 范围列表。
示例 1：要定位收入最高的前 10% 至 50% 的家庭，并包含收入未知的家庭，请指定以下格式 {Top_of_Range; Bottom_of_Range; 包含未知的 True/False} = Top 10%;41-50%;true 以仅定位家庭/值下限；true 表示家庭/值下限；
示例 2：仅定位家庭%
  • 收入最高的前 10%
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • 收入较低的后 50%

受众特征定位 生育情况是字符串、列表是要定位的育儿状况列表。选择一个或多个可接受的值。
  • 育有子女
  • 无子女
  • 未知
连接速度定位否字符串是定位特定的连接速度。请选择以下某个可接受的值：
  • All
  • 2G
  • 3G
  • DSL
  • 4G
运营商定位 - 包含否字符串、列表是

要定位的 ISP 或运营商的列表。

此列对定位类型“TARGETING_TYPE_CARRIER_AND_ISP”使用 Display & Video 360 API TargetingOption 资源 ID。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表是按数字顺序生成的，

运营商定位 - 排除否字符串、列表是

要排除的 ISP 或运营商的列表。

此列对定位类型“TARGETING_TYPE_CARRIER_AND_ISP”使用 Display & Video 360 API TargetingOption 资源 ID。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表是按数字顺序生成的，

出价调节系数否字符串, 列表列表是此条目的所有出价调节系数。列表格式 = (row type;criteria ID;出价调节系数值); (row type;条件 ID;出价调节系数值);。出价调节系数值可在 0.1 到 10.0 之间。下表列出了可接受的行类型及其对应的条件 ID：
行类型维度条件 ID
app应用应用平台和应用平台 ID 的串联字符串。应用平台和 ID 的串联字符串之间以英文冒号分隔，例如：APP:com.google.android.gm。以下值用于定义应用平台：
  • APP（这包括 Android Play 商店和 Apple App Store 平台）
  • ROKU_APP
  • AMAZON_FIRETV_APP
  • XBOX_APP
  • PLAYSTATION_APP
  • APPLE_TV_APP
  • SAMSUNG_TV_APP
  • ANDROID_TV_APP
  • GENERIC_CTV_APP
应用平台和 ID 的串联字符串之间以英文冒号分隔。例如：(app;APP:com.google.android.gm;1.0);(app;APP:422689480;2.5);
网站网址网站网址字符串。例如(site;'someurl.com';1.0);(site;'someurltwo.com';2.5);
user_list受众群体名单用户名单 ID。例如，(user_list;UserList.id;1.0);(user_list;UserList.id;2.5);
user_interest受众群体名单用户兴趣 ID。例如(user_interest;UserList.id;1.0);(user_interest;UserList.id;2.5);
custom_affinity受众群体名单自定义的兴趣相似受众群体 ID。例如(custom_affinity;CustomAffinity.id;1.0);(custom_affinity;CustomAffinity.id;2.5);
day_part广告时段在“时段定位”列中定义时段 ID。例如，314159 表示“星期二，上午 10:15 - 下午 2:45”。例如：(day_part;314159;1.0);(day_part;302312;2.5);
age_range受众特征年龄段，以“从”-“到”分隔。可接受的值包括：
  • 18-24
  • 25-34
  • 35-44
  • 45-54
  • 55-64 岁
  • 65 岁以上
  • 未知
例如(age_range;55-64;1.0);(age_range;65+;2.5);
gender受众特征性别。可接受的值包括：
  • 男
  • 女性
  • 未知
例如(gender;Male;1.0);(gender;Female;2.5);
parental_status受众特征育儿状况。可接受的值包括：
  • 育有子女
  • 无子女
  • 未知
例如(parental_status;Not a parent;1.0);
household_income受众特征家庭收入百分位范围。可接受的值包括：
  • 收入最高的前 10%
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • 收入较低的后 50%
  • 未知
例如(household_income;Top 10%;1.0);(household_income;未知;2.5);
device_type设备类型设备类型。可接受的值包括：
  • 计算机
  • 智能手机游戏
  • 平板电脑
  • 联网电视
  • 连接的设备
例如(device_type;Computer;1.0);(device_type;Tablet;2.5);
geo地理位置地理位置 ID。例如，(geo;2840;1.0);
private_deal私下交易私下交易定位 ID，例如(private_deal;1016301;1.0);
private_deal私下交易私下交易定位 ID，例如(private_deal;1016301;1.0);
public_exchange公开广告交易平台公开广告交易平台 ID。例如，(public_Exchange;17;1.0);
unclassified_exchange未分类的广告交易平台未分类的广告交易平台目标 ID (= 5000 + Exchange_id)。例如，(unClassification_Exchange;5017;1.0);
sub_exchange子广告交易平台格式为 [Exchange_id]-[sub_Exchange_targeting_id].例如。(sub_Exchange;38-4515403;1.0);
TrueView 视频广告格式支持 TrueView 订单项字符串是订单项的视频广告格式。

插播广告 / 信息流视频广告是按每次观看费用 (CPV) 出售的 TrueView 视频广告类型。插播广告 / 导视广告是按每千次展示费用出售的 TrueView 视频广告类型。导视广告是按照每千次展示费用 (CPM) 出售的时长不超过 6 秒的视频广告。不可跳过的视频广告是按照每千次展示费用 (CPM) 出售的时长为 6 到 15 秒的插播广告。对于按 CPM 出售、设有“目标频次”的订单项，可接受的 TrueView 视频广告类型包括插播广告 / 导视广告 / 不可跳过的视频广告。
  • 插播广告
  • 插播视频广告 / 信息流视频广告
  • 插播广告 / 导视广告
  • 导视广告
  • 不可跳过广告
  • 插播广告 / 导视广告 / 不可跳过式广告
TrueView 出价策略类型支持 TrueView 订单项字符串是选择适用的 TrueView 出价策略
    ：
  • 每次观看费用人工出价：基于观看次数的人工出价，即按观看次数付费。
  • 每千次展示费用人工出价：基于展示次数的人工出价，按每千次展示付费。新的 TrueView 订单项不支持此值。
  • 目标每千次展示费用：一种自动出价策略，它会优化出价，在确定了您愿意为广告获得的每千次展示支付的目标金额的前提下，帮助您争取尽可能多的展示次数。
  • 尽可能提高转化次数：一种自动出价策略，用于优化出价以帮助您争取尽可能多的转化。
  • 目标每次转化费用：一种自动出价策略，它会优化出价，在将每次转化费用控制在您愿意支付的目标金额的前提下，帮助您争取尽可能多的转化。
  • 尽可能提高转化价值：基于价值的自动出价策略，以争取更高价值的转化为目标进行优化。
  • 目标广告支出回报率：基于价值的出价策略，以提高转化价值为目标进行优化。
TrueView 出价策略值支持 TrueView 订单项float是对于“目标每次转化费用”或“目标广告支出回报率”出价策略类型，请选择一个目标出价值。对于其他“TrueView 出价策略类型”值或非 TrueView 订单项，在上传时，此列应为 0。对于“目标广告支出回报率”，此列应为小数形式的百分比。例如，如果您希望目标广告支出回报率为 150%，请在此列中输入 1.5。
TrueView 移动设备出价调整选项否字符串是“提高”或“降低”
  • 增加
  • 减少
TrueView 移动设备出价调整百分比当 TrueView 出价策略类型为“目标每次转化费用”或“尽可能提高转化次数”时，是integer是用于提高在移动设备上展示广告的机会的出价调整。可接受的调整有：出价调整选项“提高”为 [0;900%]；“降低”为 [0;90%] 或 100%。
如果 TrueView 出价策略类型为“目标每次转化费用”或“尽可能提高转化次数”，则可以接受出价调整选项“提高”为 0；“降低”为 100%。
TrueView 桌面设备出价调整选项否字符串是“提高”或“降低”
  • 增加
  • 减少
TrueView 桌面设备出价调整百分比当 TrueView 出价策略类型为“目标每次转化费用”或“尽可能提高转化次数”时，是integer是一种出价调整，用于提高在桌面设备上展示广告的几率。可接受的调整有：出价调整选项“提高”为 [0;900%]；“降低”为 [0;90%] 或 100%。
如果 TrueView 出价策略类型为“目标每次转化费用”或“尽可能提高转化次数”，则可以接受出价调整选项“提高”为 0；“降低”为 100%。
TrueView 平板电脑出价调整选项否字符串是“提高”或“降低”
  • 增加
  • 减少
TrueView 平板电脑出价调整百分比当 TrueView 出价策略类型为“目标每次转化费用”或“尽可能提高转化次数”时，是integer是出价调整，用于提高在平板电脑上展示广告的几率。可接受的调整有：出价调整选项“提高”为 [0;900%]；“降低”为 [0;90%] 或 100%。
如果 TrueView 出价策略类型为“目标每次转化费用”或“尽可能提高转化次数”，则可以接受出价调整选项“提高”为 0；“降低”为 100%。
TrueView 联网电视出价调整选项否字符串是“提高”或“降低”
  • 增加
  • 减少
TrueView 联网电视出价调整百分比当 TrueView 出价策略类型为“目标每次转化费用”或“尽可能提高转化次数”时，是integer是用于提高在联网电视上展示广告的机会的出价调整。可接受的调整有：出价调整选项“提高”为 [0;900%]；“降低”为 [0;90%] 或 100%。
如果 TrueView 出价策略类型为“目标每次转化费用”或“尽可能提高转化次数”，则可以接受出价调整选项“提高”为 0；“降低”为 100%。
TrueView 类别排除定位否字符串、列表是要排除的类别列表。列表格式 = 游戏；悲剧和冲突；等等
  • 嵌入式视频
  • 直播
  • 游戏
  • 家庭
  • 所有受众群体
  • 青少年
  • 青少年
  • 成人
  • 尚未分级
TrueView 内容过滤器否字符串是TrueView 内容过滤器。
  • 受限
  • 标准
  • 已展开
TrueView 广告资源来源定位否字符串、列表是要添加的 TrueView 广告资源来源的列表
  • YouTube
  • 视频合作伙伴
TrueView 第三方可见度衡量服务供应商仅在修改现有 TrueView 订单项时必填字符串, 列表列表是第三方供应商衡量 TrueView 订单项的可见度。如果在创建 TrueView 订单项时将此字段留空，且广告客户级启用了默认的可见度衡量服务供应商，则系统在创建订单项时将启用广告客户级默认供应商。
  • 无
  • Moat
  • DoubleVerify
  • Integral Ad Science
TrueView 第三方可见度报表 ID如果第三方可见度衡量服务供应商不是“无”，则为是。字符串是您的第三方可见度衡量服务供应商用于标识特定报告中事件的 ID。对于此列，空字符串会导致报告 ID 为空。
TrueView 第三方品牌保障服务供应商仅在修改现有 TrueView 订单项时必填字符串, 列表列表是衡量 TrueView 订单项的品牌保障情况的第三方供应商。如果在创建 TrueView 订单项时将此字段留空，并且广告客户级启用了一个默认品牌保障供应商，则系统在创建订单项时将启用了广告客户级的默认供应商。
  • 无
  • DoubleVerify
  • Integral Ad Science
  • Zefr
TrueView 第三方品牌保障报告 ID如果第三方品牌保障服务供应商不是“无”，则为“是”。字符串是您的第三方品牌保障服务供应商用于标识特定报告事件的 ID。对于此列，空字符串会导致报告 ID 为空。
TrueView 第三方覆盖面衡量服务供应商仅在更新现有 TrueView 订单项时才需要字符串, 列表列表是第三方供应商衡量 TrueView 订单项的覆盖面。如果在创建 TrueView 订单项时将此字段留空，且广告客户级启用了一个默认覆盖面供应商，则系统在创建订单项时将启用了广告客户级的默认供应商。
  • 无
  • Nielsen
  • Comscore
  • Kantar
  • Gemius
  • Video Research
  • 媒体范围
  • AudienceProject
  • iSpot 电视
  • VideoAmp
TrueView 第三方覆盖面报告 ID如果第三方覆盖面衡量服务供应商不是“无”，则为是。字符串是您的第三方覆盖面衡量服务供应商用于标识特定报告中事件的 ID。对于此列，空字符串会导致报告 ID 为空。
TrueView 第三方品牌提升效果衡量服务供应商仅在更新现有 TrueView 订单项时才需要字符串, 列表列表是第三方供应商衡量 TrueView 订单项的品牌提升效果。如果在创建 TrueView 订单项时将此字段留空，且广告客户级启用了默认品牌提升效果衡量服务供应商，则系统在创建订单项时将启用了广告客户级默认供应商。
  • 无
  • Kantar
  • Dynata
  • Intage
  • Nielsen
  • Macromill
TrueView 第三方品牌提升效果报表 ID如果第三方品牌提升效果衡量服务供应商不是“无”，则为是。字符串是您的第三方品牌提升效果衡量服务供应商用于标识特定报告的事件的 ID。对于此列，空字符串会导致报告 ID 为空。
TrueView 目标频次计数当订单项子类型为“目标频次”时，是integer是为“目标频次”类型的 YouTube 订单项设置的目标频次计数。此字段只能设为 2、3 或 4 值。对于不属于“目标频次”类型的 YouTube 订单项，此字段应留空。
TrueView 目标频次时间范围当订单项子类型为“目标频次”时，是字符串是“目标频次”类型的 YouTube 订单项的目标频次时间范围。目前，此字段只能设置为“每周”。对于不属于“目标频次”类型的 YouTube 订单项，此字段应为空。
  • 每周