Deal Sync API 常见问题解答

问:我的 Exchange ID 是什么?

答:广告交易平台 ID 由 DV3 在身份验证设置期间分配。

问:订单和产品层次结构有什么变化?

答:这主要是为了方便发布商和广告客户协商多项交易,并将其作为单个协商对象进行推送。但存在限制,即订单中的所有商品必须具有相同的交易类型和价格类型。** 始终采用“1 个订单 1 个商品”设置完全没问题。**

问:是否有适用于所有广告客户的交易?

答:交易同步 API 适用于私下交易。请参阅“公开交易的竞价包”。

问:如果交易没有结束日期,会怎么样?我们是否应该只包含一个非常遥远的日期,例如 12/31/9999?

答:我们需要结束日期,因此未来的某个日期应该可以。目前允许的最大值为 2030 年 12 月 31 日。您可以在日后更新结束日期。

问:dimensionCreativeConfig 字段是否支持多种尺寸?

答:能。但只能使用一种广告素材类型。

问:您是否接受预留交易的 auctionPricing?

答:不支持。预订型交易支持固定价格。

问:视频 PG 交易是否需要指定时长?

答:不会,如果未设置,系统会将其填充为“任意”时长。

问:“订单”状态是否会导致交易自动停止?例如,有保证的交易的订单是否设置为“待处理”?或者,是否有任何其他订单设置为“待处理”“已归档”“已取消”或“已暂停”?

答:不能,订单纯粹是一个协商对象。在广告客户“接受”订单之前,该状态不会传播。

问:如果广告资源交易平台发送更新调用,已接受的交易会发生什么情况?

答:相应交易会继续按旧条款投放。用户接受后,交易会更新为更新后的条款。

问:如果卖家更改了交易条款(例如提高了固定每千次展示费用),我们会向您推送更新。在交易被接受之前,它会继续投放吗?

答:假设交易平台已更改 CPM,并且出价请求中已反映出这一变化。

  1. 对于预订型交易,在重新接受之前,交易不会被使用。由于订单项是根据交易条款生成的,而此时交易条款更新仍处于“协商”阶段,尚未被广告客户接受。
  2. 对于非预订型交易,这完全取决于定位到该交易的订单项。如果出价请求可以与定位到此交易的订单项匹配,则会继续投放。

问:我们可以在多笔交易中重复使用交易 ID 吗?

答:不可以。ExternalDealId 在所有商品中必须是唯一的。

问:一个交易可以有多个合作伙伴吗?

答:如果您想让交易与多个合作伙伴相关联,请将交易发送给核心合作伙伴。

问:交易创建后,与交易 ID 关联的合作伙伴 ID 是否可以更改?

答:不可以,订单创建后便无法更改合作伙伴。

问:订单中是否支持多个发布商名称?

答:名称字段是一个字符串,供广告客户参考。您可以指定多个发布商名称(以英文逗号分隔),也可以直接说“来自 Exchange X 的多个发布商”。

问:“已取消”和“已归档”订单状态之间有什么区别?

答:用户可以封存和解除封存。取消后,用户无法“撤消取消”。

问:“即时优惠”是什么?由于有许多属性仅在即时交易中是必需的

答:即时优惠是一项单独的集成工作,使用 Seller API 端点,请忽略即时优惠方案的特定属性。与交易同步工作流无关。

问:我在创建订单/商品时收到“错误请求”错误。

答:可能存在多种原因,但下面列出了一些常见原因。

  1. 请参阅参考指南,看看您是否遗漏了某些必填字段。
  2. External_deal_id 在所有商品中必须是唯一的。
  3. 预订型交易不支持竞价

如果上述方法均无效,请尝试使用 HTTP 客户端(例如 Postman)查看响应是否包含有用信息。

如果上述方法均无法解决问题,请与 DV3 Seller API 支持团队联系。