结构化数据 - v5 - 广告资源来源

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

字段必需类型可写入说明
广告交易平台对于非基于代码的有保证交易，此项为必填字符串是广告资源来源的广告交易平台。
产品 ID若要创建或修改无代码有保证交易或修改基于代码的有保证交易，此字段为必填。字符串是广告资源来源的广告交易平台专用交易 ID。创建代码有保证交易时，此值不可写入。
广告资源来源 ID仅在修改现有广告资源来源时才必须指定字符串否广告资源来源的 DBM ID。如果留空，系统会创建一个具有给定广告交易平台和交易 ID 的新广告资源来源。
产品名称是字符串是广告资源来源名称。
承诺类型是字符串是广告资源来源的保证类型。仅在创建时可修改。允许的值为“Guaranteed”“Nonguaranteed”
  • 有保证
  • 非保证
费率类型是字符串是广告资源来源的费率类型。仅在创建时可修改。仅允许使用“竞价”和“固定”。
  • 竞价
  • 固定
交付方式是字符串是广告资源来源的投放方式。仅在创建时可修改。仅允许使用“代码”和“程序化”选项。
  • 标记
  • 程序化
发布商/卖家仅适用于基于代码的有保证交易字符串是相应交易的发布商的名称
评分是float是交易的每千次展示费用（正值）。这可以是简单的整数展示次数值，也可以是货币金额的浮点值。币种将以“币种”列中提供的币种显示。对于无代码有保证交易或已完全配置的基于代码的有保证交易，无法修改此值。
货币代码是字符串是交易的每千次展示费用中使用的币种
  • 美元
  • ARS
  • AUD
  • BRL
  • CAD
  • CHF
  • CLP
  • CNY
  • COP
  • CZK
  • DKK
  • EUR
  • GBP
  • HKD
  • HUF
  • IDR
  • ILS
  • INR
  • JPY
  • MXN
  • MYR
  • NOK
  • NZD
  • PEN
  • PLN
  • RON
  • RUB
  • SEK
  • SGD
  • THB
  • 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;)
Permissioned Advertisers（获得授权的广告客户）如果“获授权的合作伙伴”字段为空，则此字段为必填字段。字符串、列表是此交易获授权的广告客户的广告客户 ID 列表。列表格式 = (11; 22; 33;)
订单 ID否字符串否有保证交易的订单 ID。此字段不适用于首选交易或私下竞价
订单名称仅适用于基于代码的有保证交易。字符串是有保证交易的订单名称。此字段不适用于首选交易或私下竞价。
购买的单位数仅适用于基于代码的有保证交易integer是预订型产品的有保证展示次数。只有基于代码的有保证交易才可写入此字段。此字段不适用于首选交易或私下竞价。
格式仅适用于基于代码的有保证交易字符串是交易的广告素材类型，例如展示广告素材或视频广告素材。只有在创建基于代码的有保证交易以及未配置基于代码的有保证交易时，此字段才可写入。此字段不适用于首选交易或私下竞价。
  • 展示广告
  • 视频
  • 音频
尺寸仅适用于基于代码的有保证交易字符串、列表是该交易所需的广告素材尺寸。只有在创建基于代码的有保证交易以及未配置基于代码的有保证交易时，此字段才可写入。如果广告素材类型为展示广告，则内容会以“<width>x<height>”的形式列表写入，例如“300x250; 728x90”。如果广告素材类型为“视频”，则内容会以秒为单位的时长列表的形式写入，例如“15; 20;”。此字段不适用于首选交易或私下竞价