结构化数据 - v9 - 商品目录来源

如需了解格式说明，请参阅概览。

字段	必需	类型	可写入	说明
交换	对于非基于代码的有保证交易，此项为必填项	字符串	是	广告资源来源的交换。
产品 ID	对于创建或修改非基于代码的有保证交易或修改基于代码的有保证交易，此项为必填项。	字符串	是	广告资源来源的交换专用交易 ID。在创建基于代码的有保证交易时，此值不可写入。
广告资源来源 ID	仅当修改现有广告资源来源时才必须指定此项	字符串	否	广告资源来源的 DBM ID。如果留空，系统将使用给定的交换和交易 ID 创建新的广告资源来源。
产品名称	是	字符串	是	广告资源来源名称。
承诺类型	是	字符串	是	广告资源来源的承诺类型。只能在创建时进行修改。允许的值包括“有保证”和“无保证” 有保证 无保证
费率类型	是	字符串	是	广告资源来源的费率类型。只能在创建时进行修改。仅允许使用“竞价”和“固定”。 竞价 固定
投放方式	是	字符串	是	广告资源来源的投放方式。只能在创建时进行修改。仅允许使用“基于代码”和“程序化”。 基于代码 程序化
发布商/卖家	仅对于基于代码的有保证交易，此项为必填项	字符串	是	交易的发布商名称
费率	是	float	是	交易的 CPM 的正金额。这可以是简单的整数展示价值，也可以是货币金额的 float。币种将显示在“币种”列中提供的币种。对于非基于代码的有保证交易或完全配置的基于代码的有保证交易，此值无法修改。
货币代码	是	字符串	是	交易的 CPM 中使用的币种 美元 ARS 澳元 BRL CAD 瑞士法郎 CLP CNY COP CZK DKK EUR 英镑 HKD HUF IDR ILS INR JPY MXN MYR 挪威克朗 NZD PEN 波兰兹罗提 RON RUB 瑞典克朗 SGD 泰铢 TRY TWD ZAR KRW NGN AED EGP 越南盾
开始日期	仅对于基于代码的有保证交易，此项为必填项	字符串	是	交易开始日期的时间戳，格式为 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;”。此字段不适用于首选交易或私下竞价