如需了解格式说明,请参阅概览。
| 字段 | 必需 | 类型 | 可写入 | 说明 |
|---|---|---|---|---|
| 广告交易平台 | 对于基于代码的有保证交易,此项为必填项 | 字符串 | 是 | 广告资源来源的广告交易平台。 |
| 产品 ID | 对于创建或修改基于代码的有保证交易或修改基于代码的有保证交易,此项为必填项。 | 字符串 | 是 | 广告资源来源的广告交易平台专用交易 ID。在创建基于代码的有保证交易时,无法写入此值。 |
| 广告资源来源 ID | 仅当修改现有广告资源来源时才必须指定此项 | 字符串 | 否 | 广告资源来源的 DBM ID。如果留空,系统将使用给定的广告交易平台和交易 ID 创建新的广告资源来源。 |
| 产品名称 | 是 | 字符串 | 是 | 广告资源来源名称。 |
| 类型 | 是 | 字符串 | 是 | 广告资源来源的交易类型。只能在创建时进行修改。在创建时,只能选择“私下竞价”“首选交易”和“有保证(广告代码)”。
|
| 发布商/卖家 | 仅对于基于代码的有保证交易,此项为必填项 | 字符串 | 是 | 交易的发布商名称 |
| 费率 | 是 | float | 是 | 交易的 CPM 的正金额。这可以是简单的整数展示次数值,也可以是货币金额的 float 值。货币将显示在“币种”列中提供的币种中。对于基于代码的有保证交易或完全配置的基于代码的有保证交易,无法修改此值。 |
| 货币代码 | 是 | 字符串 | 是 | 交易的 CPM 中使用的货币
|
| 开始日期 | 仅对于基于代码的有保证交易,此项为必填项 | 字符串 | 是 | 交易开始日期的时间戳,格式为 MM/DD/YYYY HH:mm。对于基于代码的有保证交易或完全配置的基于代码的有保证交易,无法修改此值。 |
| 结束日期 | 仅对于基于代码的有保证交易,此项为必填项 | 字符串 | 是 | 交易结束日期的时间戳,格式为 MM/DD/YYYY HH:mm。如果未为基于代码的有保证交易以外的交易类型指定结束日期,则交易将无限期运行。 |
| 获取日期 | 否 | 字符串 | 否 | 交易获取日期的时间戳,格式为 MM/DD/YYYY HH:mm。 |
| 状态 | 是 | 字符串 | 是 | 条目的状态设置。
|
| 暂停原因 | 对于暂停基于代码的有保证交易,此项为必填项。 | 字符串 | 是 | 买方提供的交易暂停原因。此字段不适用于首选交易或私下竞价。 |
| 获得授权的合作伙伴 | 如果“获得授权的广告客户”字段为空,则此项为必填项。 | 字符串、列表 | 是 | 此交易的获得授权的合作伙伴的合作伙伴 ID 列表。列表格式 = (10; 20; 30;) |
| 获得授权的广告客户 | 如果“获得授权的合作伙伴”字段为空,则此项为必填项。 | 字符串、列表 | 是 | 此交易的获得授权的广告客户的广告客户 ID 列表。列表格式 = (11; 22; 33;) |
| 订单 ID | 否 | 字符串 | 否 | 有保证的交易的订单 ID。此字段不适用于首选交易或私下竞价 |
| 订单名称 | 仅对于基于代码的有保证交易,此项为必填项。 | 字符串 | 是 | 有保证的交易的订单名称。此字段不适用于首选交易或私下竞价。 |
| 购买的单位数 | 仅对于基于代码的有保证交易,此项为必填项 | 整数 | 是 | 预订产品的有保证的展示次数。只能针对基于代码的有保证交易写入此项。此字段不适用于首选交易或私下竞价。 |
| 格式 | 仅对于基于代码的有保证交易,此项为必填项 | 字符串 | 是 | 交易的广告类型,例如展示广告或视频广告。只能在创建基于代码的有保证交易时以及针对未配置的基于代码的有保证交易写入此项。此字段不适用于首选交易或私下竞价。
|
| 尺寸 | 仅对于基于代码的有保证交易,此项为必填项 | 字符串、列表 | 是 | 交易所需的广告素材尺寸。只能在创建基于代码的有保证交易时以及针对未配置的基于代码的有保证交易写入此项。如果广告素材类型为“展示广告”,则内容将以 <宽度>x<高度> 形式的列表写入,例如“300x250; 728x90;”。如果广告类型为“视频”,则内容将以秒为单位的时长列表写入,例如“15; 20;”。此字段不适用于首选交易或私下竞价 |