OpenRTB 概述

CloudX 如何调用您的 OpenRTB 端点：协议版本、传输方式、竞价机制、超时和货币。

在您的端点符合条件的每个实际执行轮次中，CloudX 都可能调用您的服务器。如果前序轮次未填充，同一次展示机会可能向同一端点发送多个请求。您的端点返回竞价响应，获胜的广告素材由 CloudX SDK 渲染。本页介绍协议层面的约定。字段级指南请参阅竞价请求和竞价响应。

协议

• 版本： OpenRTB 2.5 或 2.6，在开通时按端点配置。与您相关的版本差异——source.schain 与 source.ext.schain、user.eids 与 user.ext.eids——已在字段指南中注明。
• 传输： 通过 HTTPS POST 发送 JSON 请求体（Content-Type: application/json）。请保持连接复用；CloudX 可能为每个符合条件且实际执行的轮次发送单独请求。
• 压缩： CloudX 可以按端点压缩请求体。响应只能使用该次请求的 Accept-Encoding 标头所声明的编码进行压缩；否则请发送未压缩响应。默认声明为 gzip, zstd，但端点配置可能不同，因此请检查每个请求。请参阅竞价流量压缩。
• 每个请求一个展示： 每个竞价请求只携带一个 imp 对象。对该展示出价或放弃——CloudX 不会把多个展示合并到一个请求中。

竞价机制

CloudX 采用第一价格竞价：如果您的出价获胜，您将按出价全额支付。竞价按发布商 line item 定义的轮次进行。CloudX 在排序前会应用适用的出价调整和该轮底价；首个产生有效出价的轮次中，调整后的最高出价获胜。出价相同时随机决定。

对于受支持的集成，轮次可以在可信执行环境中对出价进行排序并生成可验证的证明。标准集成继续使用本页所述的请求和响应约定；CloudX 会在接入期间提供可选的 TEE 集成细节。

超时

每个竞价请求都带有 tmax，即您可以响应的毫秒数，从 CloudX 发出请求时开始计时。tmax 按端点设置（默认为 1400 毫秒）。超过截止时间到达的响应会被丢弃，不参与竞价。

不参与竞价

要放弃某次展示，请返回以下任一形式：

• HTTP 204，响应体为空；或
• HTTP 200，seatbid 数组为空。当您想在 nbr（OpenRTB 列表 5.24）中说明原因时使用这种形式——204 无法携带响应体。

货币

所有价格均为美元。请求中的 bidfloor 和响应中的 price 都是以美元计价的 CPM。

接下来