如需了解格式,请参阅概览。
字段 | 必需 | 类型 | 可写入 | 说明 |
---|---|---|---|---|
交换 | 对于非基于代码的有保证交易,此项为必填项 | 字符串 | 是 | 相应广告资源来源的广告交易平台。 |
产品 ID | 创建或修改无代码有保证交易或修改基于代码的有保证交易时,此项为必填项。 | 字符串 | 是 | 相应广告资源来源的广告交易平台专属交易 ID。在创建基于代码的有保证交易时,此值不可写入。 |
广告资源来源 ID | 仅当修改现有广告资源来源时才必须指定这项设置 | 字符串 | 否 | 相应广告资源来源的 DBM ID。如果留空,系统会创建一个具有指定交易平台和交易 ID 的新广告资源来源。 |
产品名称 | 是 | 字符串 | 是 | 广告资源来源名称。 |
承诺类型 | 是 | 字符串 | 是 | 广告资源来源的保证类型。只能在创建时修改。允许的值为 Guaranteed、Nonguaranteed
|
费率类型 | 是 | 字符串 | 是 | 广告资源来源的费率类型。只能在创建时修改。仅允许使用“拍卖”和“固定”值。
|
交付方式 | 是 | 字符串 | 是 | 广告资源来源的投放方式。只能在创建时修改。仅允许使用“标签”和“程序化”..
|
发布商/卖家 | 仅对于基于代码的有保证交易,此项为必填项 | 字符串 | 是 | 相应优惠的发布商名称 |
评分 | 是 | float | 是 | 交易的每千次展示费用(正值)。可以是简单的整数展示价值,也可以是表示货币金额的浮点数。币种将以“币种”列中提供的币种显示。对于非标记有保证的交易或已完全配置标记的有保证的交易,此值无法修改。 |
货币代码 | 是 | 字符串 | 是 | 交易的每千次展示费用中使用的币种
|
开始日期 | 仅对于基于代码的有保证交易,此项为必填项 | 字符串 | 是 | 交易开始日期的相应时间戳,格式为 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。此字段不适用于首选交易或私下竞价 |
订单名称 | 仅对于基于代码的有保证交易,此项为必填。 | 字符串 | 是 | 有保证交易的订单名称。此字段不适用于首选交易或私下竞价。 |
购买的单位数 | 仅对于基于代码的有保证交易,此项为必填项 | 整数 | 是 | 预订型产品的有保证的展示次数。此属性仅可针对基于代码的有保证交易进行写入。此字段不适用于首选交易或私下竞价。 |
格式 | 仅对于基于代码的有保证交易,此项为必填项 | 字符串 | 是 | 交易的广告素材类型,例如展示广告或视频广告。此字段仅在创建基于代码的有保证交易时可写入,且仅适用于未配置的基于代码的有保证交易。此字段不适用于首选交易或私下竞价。
|
尺寸 | 仅对于基于代码的有保证交易,此项为必填项 | 字符串、列表 | 是 | 交易所需的广告素材尺寸。此字段仅在创建基于代码的有保证交易时可写入,且仅适用于未配置的基于代码的有保证交易。如果广告素材类型为 DISPLAY,则内容以 <width>x<height> 形式的列表写入,例如“300x250; 728x90;”。如果广告素材类型为 VIDEO,则内容以秒为单位的时长列表形式写入,例如“15; 20;”。此字段不适用于首选交易或私下竞价 |