如需查看格式说明,请参阅概览。
字段 | 必需 | 类型 | 可写入 | 说明 |
---|---|---|---|---|
交换 | 对于无保证的基于代码的有保证交易,则必须填写此字段 | string | 是 | 广告资源来源的广告交易平台。 |
产品 ID | 创建或修改无保证的基于代码的有保证交易或修改基于代码的有保证交易时,必须填写此字段。 | string | 是 | 广告资源来源的广告交易平台专有交易 ID。创建基于代码的有保证交易时,此值无法写入。 |
广告资源来源 ID | 仅在修改现有广告资源来源时必填 | string | 不支持 | 广告资源来源的 DBM ID。如果您将此项留空,系统会创建具有指定广告交易平台和交易 ID 的新广告资源来源。 |
产品名称 | 是 | string | 是 | 广告资源来源名称。 |
承诺类型 | 是 | string | 是 | 广告资源来源的承诺类型。只能在创建时修改。允许的值有“有保证”和“无保证”
|
费率类型 | 是 | string | 是 | 广告资源来源的费率类型。只能在创建时修改。只允许选择“竞价”和“固定”类型。
|
交付方式 | 是 | string | 是 | 广告资源来源的投放方式。只能在创建时修改。只允许使用“代码”和“程序化”
|
发布商/卖方 | 仅对基于代码的有保证交易是必需的 | string | 是 | 交易的发布商名称 |
评分 | 是 | float | 是 | 交易每千次展示费用的正数金额。这可以是简单的整数展示价值,也可以是表示货币金额的浮点数。币种将以“币种”列中提供的币种显示。对于无保证的基于代码的有保证交易或已全面配置的基于代码的有保证交易,此值无法修改。 |
货币代码 | 是 | string | 是 | 交易的每千次展示费用 (CPM) 中使用的币种
|
开始日期 | 仅对基于代码的有保证交易是必需的 | string | 是 | 交易开始日期的时间戳,格式为 MM/DD/YYYY HH:mm。如果是无保证的基于代码的有保证交易,则无法修改此值。如果是基于代码的有保证交易,则无法修改此值。 |
结束日期 | 仅对基于代码的有保证交易是必需的 | string | 是 | 交易结束日期的时间戳,格式为 MM/DD/YYYY HH:mm。如果为除基于代码的有保证交易之外的交易类型指定结束日期,交易将无限期进行下去。 |
创建日期 | 不支持 | string | 不支持 | 交易达成日期的时间戳,格式为 MM/DD/YYYY HH:mm。 |
状态 | 是 | string | 是 | 条目的状态设置。
|
暂停原因 | 必须执行此操作,才能暂停无保证的无保证交易。 | string | 是 | 买方提供的交易暂停原因。此字段不适用于首选交易或私下竞价。 |
获得授权的合作伙伴 | 如果“有权限的广告客户”字段为空,则必须填写此字段。 | 字符串、列表 | 是 | 此交易已获许可的合作伙伴的合作伙伴 ID 列表。列表格式 = (10; 20; 30;) |
已获权限的广告客户 | 如果“已获授权的合作伙伴”字段为空,则必须填写此字段。 | 字符串、列表 | 是 | 此交易已获许可的广告客户的广告客户 ID 列表。列表格式 = (11; 22; 33;) |
订单 ID | 不支持 | string | 不支持 | 有保证交易的订单 ID。此字段不适用于首选交易或私下竞价 |
订单名称 | 仅对基于代码的有保证交易是必需的。 | string | 是 | 有保证的交易的订单名称。此字段不适用于首选交易或私下竞价。 |
购买的单位数 | 仅对基于代码的有保证交易是必需的 | integer | 是 | 预订产品的有保证展示次数。只能针对基于代码的有保证交易写入此值。此字段不适用于首选交易或私下竞价。 |
形式 | 仅对基于代码的有保证交易是必需的 | string | 是 | 此交易的广告素材类型,例如“展示”或“视频”。此设置只能在创建基于代码的有保证交易以及未配置基于代码的有保证交易时写入。此字段不适用于首选交易或私下竞价。
|
尺寸 | 仅对基于代码的有保证交易是必需的 | 字符串、列表 | 是 | 交易的必需广告素材尺寸。此设置只能在创建基于代码的有保证交易和未配置基于代码的有保证交易时写入。如果广告素材类型为“DISPLAY”,则内容会被写为格式为 <width>x<height> 的列表(例如“300x250; 728x90;”)。如果广告素材类型为“视频”,则内容将被写为以秒为单位的时长列表,例如“15; 20;”。此字段不适用于首选交易或私下竞价 |