竞价响应

CloudX 读取的 OpenRTB 竞价响应字段、广告标记规则，以及带宏的获胜/失败通知 URL。

如需对展示机会出价，请返回标准的 OpenRTB 竞价响应。本页介绍 CloudX 读取的字段、CloudX 渲染素材的标记规则，以及用于跟踪结果的通知 URL。

不参与竞价的响应

要放弃某次展示，请返回 HTTP 204（响应体为空）或 HTTP 200（seatbid 数组为空）。当您想在 nbr（OpenRTB 列表 5.24）中说明原因时使用 200 形式——204 无法携带响应体。

响应对象

Bid 对象

广告标记规则

• 请在 adm 中返回完整标记。CloudX 不会从 nurl 获取标记。
• 所有 URL 必须使用 HTTPS。 HTTP 引用违反合作方契约，并可能被拒绝。
• HTML/MRAID 标记是由 CloudX SDK 在 WebView 中渲染的片段；VAST 标记是完整的 XML 文档。格式、尺寸和渲染行为请参阅广告素材规范。

获胜和失败通知

CloudX 会随着竞价结果和设备端结果的确定，调用您出价中的相应通知 URL：

通知采用异步、尽力而为方式交付，并非恰好一次。通知可能延迟、重试、重复、乱序或丢失。处理程序应具备幂等性：按 URL 类型以及 ${AUCTION_ID}、${AUCTION_IMP_ID} 和 ${AUCTION_BID_ID} 去重，并仅在持久记录事件后返回 2xx。

宏

您可以在通知 URL 中嵌入宏，CloudX 会在调用前替换为实际值。宏区分大小写，请始终使用 ${...} 形式。

当某条通知路径未提供宏所需的上下文时，该宏会以原文保留，例如 nurl 中的 ${AUCTION_LOSS}。如果该路径提供了上下文，但可选来源字段为空，替换结果可能为空值。请确保处理程序能够同时容忍字面宏文本和空值。

价格宏行为

失败原因代码

${AUCTION_LOSS} 携带以下 OpenRTB 代码之一：

超时响应会被丢弃。不要依赖超时响应中的 lurl 收到代码 2；服务器生成的超时通知仅适用于实现该能力的特定端点适配器。

响应示例

{
  "id": "7f3d9a1c2e4b48f0a6d5c8b2e1f40937",
  "cur": "USD",
  "bidid": "b-92f4ac",
  "seatbid": [
    {
      "seat": "your-seat-id",
      "bid": [
        {
          "id": "bid-0001",
          "impid": "1",
          "price": 6.25,
          "crid": "creative-48291",
          "adid": "ad-48291",
          "adomain": ["advertiser.example"],
          "cat": ["IAB1-1"],
          "adm": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><VAST version=\"3.0\">...</VAST>",
          "nurl": "https://events.bidder.example/win?price=${AUCTION_PRICE}",
          "burl": "https://events.bidder.example/bill?price=${AUCTION_PRICE}",
          "lurl": "https://events.bidder.example/loss?reason=${AUCTION_LOSS}&price=${AUCTION_PRICE}",
          "ext": { "crtype": "vast" }
        }
      ]
    }
  ]
}