如需了解格式说明,请参阅概览。
| 字段 | 必需 | 类型 | 可写入 | 说明 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Io Id | 仅当修改现有插播订单时才必须指定这项设置 | 整数 | 否 | 相应广告订单的数字 ID 值。如果留空,系统会创建一个新的插播订单 ID 并为其分配唯一 ID。(可选)创建新广告订单时,您可以使用自定义标识符将订单项分配给新广告订单。自定义标识符的格式为“ext[自定义标识符]”,例如 ext123。待文件被上传并处理后,系统会将所有自定义标识符替换为由 DBM 分配的 ID,并会根据所用的自定义标识符将相关对象(例如订单项与广告订单)关联起来。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 广告系列 ID | 否 | 整数 | 否 | 相应广告系列的数字 ID 值。您可以为要与此插单同时创建的广告系列指定自定义标识符(例如,“ext[自定义广告系列标识符]”)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 名称 | 是 | 字符串 | 是 | 条目的名称。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 时间戳 | 修改现有条目时必须指定 | 整数 | 否 | 相应条目的时间戳,系统会使用此时间戳来验证相应条目在下载和上传期间是否未发生更改。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 状态 | 是 | 字符串 | 是 | 相应条目的状态设置。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Io 类型 | 是 | 字符串 | 是 | 广告订单的类型。只能在创建时设置。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| IO 子类型 | 是 | 字符串 | 是 | 用于区分不同格式的必需字段。如果此字段留空,系统将使用“默认”值。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Io 目标 | 是 | 字符串 | 是 | 插单的目标。 此字段目前处于 Beta 版测试阶段,仅向参与测试的客户提供。对于未参与 Beta 版计划的客户,此列将始终为空。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 费用 | 否 | 字符串,列表的列表 | 是 | 相应条目的所有费用。列表格式 =(费用类别;费用金额;费用类型;已开具账单;)。
示例:'(CPM; 2; Display & Video 360 Fee; False) ; (Media; 13; Default; True);'
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 集成代码 | 否 | 字符串 | 是 | 用于跟踪的可选代码。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 详细信息 | 否 | 字符串 | 是 | 字符串格式的条目详细信息。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 节奏 | 是 | 字符串 | 是 | 用于达到支出节奏金额的时间段。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 支出速率 | 是 | 字符串 | 是 | 相应条目的投放速率。
“尽快”与“投放期”节奏不兼容。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 投放量 | 是 | float | 是 | 根据支出节奏类型设置的每个时间段的支出金额。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 频次已启用 | 是 | 字符串 | 是 | 启用/停用广告订单的基于展示次数的频次上限。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 频次曝光 | 当“Frequency Enabled”(启用频次)为“TRUE”时为必需 | 整数 | 是 | 一个正整数值,表示指定频次金额的展示次数,即“在 y 时间段内展示 x 次”中的 x。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 频次周期 | 当“Frequency Enabled”(启用频次)为“TRUE”时为必需 | 字符串 | 是 | 指定频次上限的时间段单位。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 频次金额 | 当“Frequency Enabled”(启用频次)为“TRUE”时为必需 | 整数 | 是 | 频次上限的时间段长度(正整数),即“在 y 时间段内展示 x 次”中的 y。 频次上限的时间段不得超过 30 天。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| KPI 类型 | 是 | 字符串 | 是 | 相应广告订单的 KPI 单位
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| KPI 值 | 是 | 字符串 | 是 | 以货币(每千次展示费用、每次转化费用、每次点击费用、每次观看费用、每次安装平均转化价值、每次互动费用、每千次可见展示费用)、百分比(可见率、点击率、点击转化率、展示转化率、视频观看率、音频转化率、视频转化率、每次点击带来的潜在客户数、每次点击带来的申请数、TOS10)、无单位数(自定义展示价值 / 费用)或字符串(其他)表示的 KPI 值。如果提供的 KPI 类型为“尽可能提高支出速度”或“无”,则系统会忽略此列。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Kpi Algorithm Id | 当“Kpi Type”为“Custom impression value / cost”时,此字段为必需字段 | 整数 | 是 | 如果 KPI 类型为 CUSTOM_BIDDING_VALUE_COST,则为与 KPI 关联的自定义出价算法 ID。否则,系统会忽略此列。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 预算类型 | 是 | 字符串 | 是 | 指定预算类型,具体形式可以是要支出的“收入”金额(金额)或要购买的展示次数(展示次数)。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 预算细分 | 是 | 字符串,列表的列表 | 是 | 指定具体的预算细分。列表格式 =(预算、开始日期、结束日期、广告系列预算 ID、说明)。预算采用浮动货币格式。日期采用 MM/DD/YYYY 格式。如果未指定,则广告系列预算 ID 为空。所有预算段的说明都不得为空。如果现有预算期说明为空,则需要为相应行提供说明才能上传。示例:"(100.50;01/01/2016;03/31/2016;12345;预算期 1;);(200.00;04/01/2016;06/30/2016;;更新后的预算期 1;)" | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 自动分配预算 | 是 | 字符串 | 是 | 启用/停用自动分配预算
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 广告订单优化 | 是 | 字符串 | 是 | 启用/停用广告订单优化 如果此列设置为“TRUE”,则相应广告订单下的订单项将使用该广告订单的出价策略。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 出价策略单元 | 当“Insertion Order Optimization”为“True”时为必需 | 字符串 | 是 | 选择要优化出价的出价策略单元:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 出价策略上限 | 当“Insertion Order Optimization”为“True”时为必需 | float | 是 | 设置“不得超过”的每千次展示费用值。如果值为 0,则表示未启用“不得超过”功能。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 为交易应用底价 | 当“Insertion Order Optimization”为“True”时为必需 | 字符串 | 是 | 是否优先处理交易而非公开竞价广告资源
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 算法 ID | 当“出价策略单位”为自定义展示价值/费用时,此列为必需列 | 整数 | 是 | 当出价策略单位设置为“自定义每次展示价值/费用”时,必须使用此对应的算法 ID。 分配给此列的算法中使用的任何 Floodlight 活动都必须包含在“转化 Floodlight 活动 ID”列中。如果尝试分配算法,但未正确更新“转化 Floodlight 活动 ID”列,则会导致错误。 |