OpenRTB 概述

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

在您的端点符合条件的每个实际执行轮次中，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。

屏蔽类别

以下 IAB Content Taxonomy 1.0 代码列入 CloudX 全平台策略屏蔽列表：

在 OpenRTB 2.6 中，请求的 cattax标明 bcat 使用的分类法：1 表示 IAB Content Taxonomy 1.0，省略时默认为 1。对于这些类别，将出价的 cattax设为 1 或省略该字段；bid.cat 使用相同的默认分类法。

发布商可以添加类别屏蔽。必须遵守每个竞价请求中完整的 bcat 数组，并在 bid.cat 中准确标注素材和落地页类别。不得使用 bcat 中列出的类别出价。

类别按代码精确匹配；父类别代码不会自动匹配其子类别。例如，IAB8 不会匹配 IAB8-5。请返回准确的类别代码，不得为规避屏蔽而使用更宽泛的父类别代码。

发布商还可以在 badv 中配置广告主域名屏蔽，在 bapp 中配置广告推广应用屏蔽。请遵守每个请求中的这两个数组。bapp 使用 Android 包名或数字 iOS App Store ID 标识应用；广告推广应用时，请在 bid.bundle 中返回该应用的标识符。

类别屏蔽使用失败原因代码 209，广告主域名屏蔽使用 6。应用屏蔽使用 215，素材属性屏蔽使用 210，素材或广告活动 ID 屏蔽使用 200。通知含义请参阅失败原因代码。

根据需求合作伙伴策略，博彩、酒类、金融产品或服务等受限内容仍须获得 CloudX 许可并符合监管要求。许可不覆盖请求中的类别屏蔽。参阅受限内容。

接下来