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

有关格式说明，请参阅概览。

字段必填类型可写入说明
广告交易平台对于基于代码的有保证交易而言，是必填项字符串是广告资源来源的广告交易平台。
产品 ID创建或修改基于代码的有保证交易或修改基于代码的有保证交易时必填。字符串是广告资源来源的广告交易平台专属交易 ID。创建基于代码的有保证交易时，此值不可写入。
广告资源来源 ID仅在修改现有广告资源来源时才需要字符串否广告资源来源的 DBM ID。如果您将此字段留空，系统将会使用指定广告交易平台 ID 和交易 ID 创建新的广告资源来源。
产品名称是字符串是广告资源来源名称。
类型是字符串是广告资源来源的交易类型。只能在创建时修改。仅限“私下竞价”“首选交易”和“有保证（代码）”允许创建。
  • 私下竞价
  • 首选交易
  • 有保证
  • 无保证预订
  • 有保证（广告代码）
  • 有保证 (YouTube)
  • 有保证的广告资源包
发布商/卖方仅基于代码的有保证交易需要字符串是交易的发布商名称
评分是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;)
已获权限的广告客户如果“授权合作伙伴”字段为空，则为必需。字符串、列表是此交易中已获许可的广告客户的广告客户 ID 列表。列表格式 = (11; 22; 33;)
订单 ID否字符串否有保证交易的订单 ID。此字段不适用于首选交易或私下竞价
订单名称仅基于代码的有保证交易是必需的。字符串是有保证交易的订单名称。此字段不适用于首选交易或私下竞价。
购买的单位数仅基于代码的有保证交易需要integer是预订产品的有保证展示次数。只有基于代码的有保证交易可写入该值。此字段不适用于首选交易或私下竞价。
格式仅基于代码的有保证交易需要字符串是交易的广告素材类型。例如展示广告或视频广告。只有在创建基于代码的有保证交易以及未配置的基于代码的有保证交易时，才能写入此值。此字段不适用于首选交易或私下竞价。
  • 显示
  • 视频
  • 音频
尺寸仅基于代码的有保证交易需要字符串、列表是交易的必需广告素材尺寸。只有在创建基于代码的有保证交易和未配置基于代码的有保证交易时，才能写入此值。如果广告素材类型为“展示”，则内容编写为 <宽度>x<高度> 形式的列表，例如“300x250”728x90;。如果广告素材类型为“视频”，则内容编写为时长列表（以秒为单位）。例如“15；20;。此字段不适用于首选交易或私下竞价