MREC 多格式

CloudX 如何在同一个 MREC 展示机会中同时提供横幅和静音的横幅内视频，以及如何标注您的响应类型。

在符合条件的 MREC（300×250）广告资源上，CloudX 可以发送同时包含 imp.banner 和 imp.video 的单个展示机会。您可以针对同一广告位返回 HTML/MRAID 横幅或静音 VAST 视频；无论格式如何，出价最高的合格竞价胜出。

请求结构

多格式 MREC 展示机会就是在常规 MREC 横幅展示机会旁边加上一个静音的横幅内 video 对象：

字段	取值
`imp.banner`	`w: 300`、`h: 250`，与仅横幅请求相同。
`imp.video.w` / `imp.video.h`	MREC 广告位尺寸，`300` × `250`。
`imp.video.mimes`	`["video/mp4", "video/3gpp", "video/3gpp2", "video/x-m4v"]`。CloudX 渲染的 VAST 请使用 `video/mp4` 以确保兼容。
`imp.video.minduration` / `maxduration`	`5` / `30` 秒。
`imp.video.protocols`	包含 `[2, 3, 5, 6, 7]`（VAST 2.0、3.0、4.0 以及 2.0/3.0 Wrapper）。部分请求在 iOS 上还会列出 `8`，在 Android 上还会列出 `4`；CloudX 仅渲染 VAST 2.0–4.x。
`imp.video.api`	`[3, 5, 6]`（MRAID 1–3）。
`imp.video.plcmt`	`4`（无内容 / 独立），即 OpenRTB 2.6 中表示横幅内视频的信号。
`imp.video.placement`	`2`（横幅内），即 OpenRTB 2.5 的旧版信号。
`imp.video.linearity`	`1`（线性）。
`imp.video.startdelay`	`0`（前贴片）。
`imp.video.playbackmethod`	`[6]`：进入可视区域时静音开始播放。
`imp.video.companiontype`	`[1]`（静态）。

请求中不含 imp.instl，且无论您返回哪种格式，imp.bidfloor 都适用于该展示机会。CloudX 只会向能够渲染内嵌 MREC 视频的应用 SDK（CloudX Android SDK 4.7.0+、iOS SDK 3.9.0+）发送 video 对象。

{
  "imp": [
    {
      "id": "1",
      "tagid": "home-mrec",
      "bidfloor": 1.2,
      "bidfloorcur": "USD",
      "displaymanager": "cloudx",
      "banner": { "w": 300, "h": 250 },
      "video": {
        "w": 300,
        "h": 250,
        "mimes": ["video/mp4", "video/3gpp", "video/3gpp2", "video/x-m4v"],
        "minduration": 5,
        "maxduration": 30,
        "protocols": [2, 3, 5, 6, 7],
        "api": [3, 5, 6],
        "placement": 2,
        "plcmt": 4,
        "linearity": 1,
        "startdelay": 0,
        "playbackmethod": [6],
        "companiontype": [1]
      }
    }
  ]
}

响应素材类型

CloudX 无法从请求形态判断您返回的格式，因此请在每次出价中声明：

返回的素材	`bid.mtype`（OpenRTB 2.6）	`bid.ext.crtype`
HTML / MRAID 横幅	`1`	`"html"` 或 `"mraid"`
VAST 视频	`2`	`"vast"`

CloudX 依次读取 mtype、adm 中的 VAST 标记、crtype。未标注类型的 VAST 标记会被识别并按 VAST 渲染；未标注类型的非 VAST 标记按横幅渲染。OpenRTB 2.5 端点没有 mtype，请设置 ext.crtype。

{
  "id": "1",
  "impid": "1",
  "price": 3.10,
  "crid": "creative-mrec-video-1",
  "adomain": ["advertiser.example"],
  "cat": ["IAB9-30"],
  "exp": 3600,
  "mtype": 2,
  "adm": "<VAST version=\"4.2\"> … </VAST>",
  "ext": { "crtype": "vast" }
}

其他出价字段请参阅竞价响应。

渲染路径

CloudX 渲染（无 SDK）的需求

对于服务器到服务器的需求，CloudX SDK 会在 MREC 广告位中内嵌播放您的 VAST。

在 adm 中返回 VAST 2.0–4.3 标记，并设置 crtype: "vast"（OpenRTB 2.6 还需设置 mtype: 2）。渲染路由由 CloudX 自行设置；请勿发送 ext.cloudx.render 字段。
视频以静音状态开始播放，并在保持宽高比的前提下缩放以适应广告位，空白处以黑色填充。
CloudX 无法内嵌渲染的视频出价会被跳过，并收到失败原因代码为 204 的 lurl；竞价回退到最佳的合格横幅。
素材规范中的其他素材规则同样适用，包括 VAST 版本支持、资源限制和回退行为。

合作伙伴 SDK 需求

对于通过 CloudX 网络适配器、由自有移动 SDK 渲染广告的买方（例如 Unity Ads），CloudX 会将您的出价内容原样传给您 SDK 的 MREC 广告视图。视频由您的 SDK 渲染，CloudX 内嵌渲染器不适用。上文的 SDK 版本要求仍适用于所有多格式请求。

在每次出价中设置 bid.mtype（1 横幅，2 视频）；OpenRTB 2.5 请改为设置 ext.crtype。CloudX 会原样传递 adm，无法解析您的 SDK 内容来区分格式。
视频能否在您的 MREC 中投放，由您自己的 SDK 和广告位配置决定。
按照 playbackmethod: [6] 的信号，以静音状态开始播放视频。