素材规范

面向 CloudX 渲染（服务器到服务器）需求的素材类型、支持格式与渲染行为

对于服务器到服务器（无 SDK）需求，CloudX 直接从 bid.adm 标记在应用内渲染您的素材——不涉及任何网络 SDK。本页说明 CloudX 接受的素材类型与格式，以及其应用的用户体验行为。

竞价响应

在标准 OpenRTB bid.adm 字段中返回素材标记。可选地在 bid.ext.crtype 中声明素材类型（html、mraid 或 vast）；若省略，CloudX 会根据展示位推断类型。

{
  "seatbid": [
    {
      "bid": [
        {
          "id": "1",
          "impid": "<竞价请求中的 imp id>",
          "price": 2.50,
          "crid": "creative-123",
          "adm": "<!doctype html> …（HTML/MRAID 文档，或 VAST XML）",
          "ext": { "crtype": "html" }
        }
      ]
    }
  ]
}

adm 中的素材必须满足以下要求。请勿发送 ext.cloudx.*；CloudX 会在竞价后填充渲染路由。

素材类型

HTML / MRAID 3.0 — 静态与交互式 HTML 素材。向素材公开 MRAID 3.0 宿主 API。mraid.useCustomClose() 会被接受但无效果（参见关闭控件）；在全屏广告位上，expand() 与 resize() 会被拒绝。
VAST 视频 — 支持 VAST 2.0 至 4.3。VAST 5.x 及无法识别的版本会以“版本不支持”错误安全失败，从而允许交易所投放兜底素材。不支持 VPAID。

支持的格式

格式	HTML (MRAID 3.0)	VAST 视频
Banner（320×50）	✓	—
MREC（300×250）	✓	—
插屏	✓	✓
激励视频	✓	✓

CloudX 不渲染原生（Native）与开屏（App Open）。

用户体验行为

CloudX 采用保守、非侵扰的默认体验，并由其拥有关闭控件，因此素材永远无法困住用户。这些行为由 CloudX 强制执行，需求合作伙伴无法配置。

关闭控件

关闭控件由 SDK 绘制并拥有，位置固定在顶部尾侧安全区，点击区域不小于 50 pt。素材无法替换、隐藏或移动它。
mraid.useCustomClose() 为兼容性而被接受，但为只观察的空操作——SDK 关闭控件始终存在。
发生卡顿时，看门狗会强制显示关闭控件，因此用户永远不会被困住。

插屏

关闭控件在短暂延迟后出现（默认 5 秒）。对于 VAST，在跳过可用前显示跳过倒计时；SDK 关闭控件始终作为兜底可用。

激励视频

激励视频广告位默认不可跳过，且不提供跳过控件；用户观看至完成。
若适用观看得奖阈值，越过阈值后会出现关闭控件（而非跳过控件）。此后用户退出仍保留奖励。
奖励在完成时发放，或在满足资格后退出时发放。卡顿期间的应急退出不发放奖励。
观看得奖资格仅按前台时间累计；将应用切换到后台不会推进计时。

度量

HTML 与 VAST 素材均支持 Open Measurement（OMID）可见性度量。
追踪 VAST 4.1 的 ViewableImpression 与标准 Impression 事件。
遵循 VAST 4.0+ 的 AdVerifications（OMID 验证资源）。

兜底行为

当素材无法渲染时——例如不支持的 VAST 版本、无法解析的负载或素材类型不匹配——CloudX 会安全失败并报告错误，从而允许交易所投放兜底素材，而不是展示损坏的广告。