买方接入
将 OpenRTB 买方接入 CloudX 的公开集成清单。
在交换凭据或测试流量之前，请使用本页确定 OpenRTB 集成范围。您提供买方端点 URL；CloudX 通过非公开渠道配置端点和身份验证信息。协议约定公开记录在此。
能力矩阵
| 项目 | 公开约定 |
|---|---|
| 流量 | 移动应用内流量。网站、CTV、音频及其他渠道不在本公开约定范围内。 |
| 展示类广告 | 横幅、MREC、插屏和激励广告支持 HTML 或 MRAID。 |
| 视频 | 插屏和激励广告支持 VAST。 |
| 原生广告 | 部分发布商集成支持原生广告，但标准买方端点不支持。请联系 CloudX，确认您的集成是否支持原生广告。 |
| 开屏广告（App Open） | 是否由 CloudX 渲染取决于端点配置。符合条件的端点支持全屏 HTML/MRAID 或 VAST 素材；CloudX 会在接入期间确认支持情况。 |
| 协议 | OpenRTB 2.5 或 2.6，按端点配置。 |
| 地区 | 生产竞价服务覆盖美国、欧洲、亚太和南美。CloudX 会确认您的集成启用哪些地区。 |
| 传输 | HTTPS POST，Content-Type 为 application/json。请保持连接复用。 |
| 身份验证 | 如有需要，按端点配置。凭据或固定请求头通过带外安全渠道交换，不会发布在本指南中。 |
| 请求结构 | 每个请求包含一个 imp。同一次展示机会可能在多个竞价轮次中到达您的端点。 |
| 竞价完整性 | 受支持的集成可以在隔离且可生成证明的可信执行环境中对出价排序。可选的 TEE 功能在接入期间协调启用。 |
| 超时 | 每次都读取请求中的 tmax。默认值为 1400 毫秒，但 CloudX 可以按端点配置。 |
| 货币 | 仅支持美元 CPM。非美元竞价响应会被拒绝。 |
| 压缩 | 经双方约定，请求体可不压缩或使用 gzip、zstd；响应可在请求声明支持时使用 gzip 或 zstd。 |
| 测试流量 | 集成测试流量带有 test: 1。上线前由 CloudX 协调受控测试。 |
| 隐私 | TCF、GPP、US Privacy、GPC、DNT 和 LMT 信号都可能影响请求。请参阅 OpenRTB 买方隐私指南。 |
| 度量 | 受支持的 SDK 会尝试对 CloudX 渲染的 HTML 和 VAST 启用 OM SDK 度量。承诺覆盖前应确认已发布 SDK 版本与认证配置一致；请参阅可见性。 |
地区可用性不代表流量、QPS、延迟或 SLA 承诺。商业和容量承诺以双方协议为准。
CloudX 需要的信息
请向 CloudX 客户经理提供：
- 生产和测试 HTTPS 端点 URL
- OpenRTB 2.5 或 2.6
- 支持的展示类和视频格式
- 所需的身份验证请求头或查询参数
- 请求体使用不压缩、gzip 还是 zstd
- 技术和运维联系人
按约定开发
- 实现竞价请求和竞价响应约定。
- 处理请求中的每个隐私信号；切勿根据广告标识符是否存在来推断同意状态。
- 返回符合广告素材规范的 HTML/MRAID 或 VAST。
- 确保
nurl、burl和lurl处理程序具有幂等性，并能容忍异步、尽力而为的投递。 - 使用供应透明度核验发布商路径。
上线清单
- 将每个 HTTP 请求视为独立出价机会，即使前一轮使用了相同的
id。 - 在请求的
tmax内响应；不出价时返回204或空seatbid。 - 原样返回
bidresponse.id和bid.impid，每次响应发送一个 seat 和一个 bid，并使用美元出价。 - 每次出价都包含稳定的
crid和至少一个非空adomain。 - 遵循
bidfloor、bcat、badv、隐私信号以及您自己的策略控制。 - 验证未压缩请求体和双方约定的压缩请求体。
- 验证端点计划发送的每种响应编码。
- 在真实设备上渲染每种支持的素材类型。
- 验证预期的
nurl、burl和lurl结果，不要假设通知只投递一次。 - 对由 CloudX 结算的请求，将
app.publisher.id、app-ads.txt 和 sellers.json 与 OpenRTB 2.6 的source.schain或 2.5 的source.ext.schain核对。 - 上线生产前完成受控的
test: 1流量测试。