可见性

CloudX 渲染素材的 Open Measurement（OMID）度量，以及验证代码的配置方法

CloudX 在 CloudX SDK 中集成了 IAB Tech Lab 的 Open Measurement SDK（OM SDK），并尝试对自行渲染的广告素材进行可见性度量。CloudX 在 OM SDK 合规名单中以合作伙伴名称 Cloudxai 拥有有效的 Android 与 iOS 条目。认证覆盖范围取决于版本；依赖认证覆盖前，请根据当前名录条目确认已发布的 SDK 版本。

度量由广告素材驱动。CloudX 会尝试创建广告会话并运行您在素材中提供的供应商验证脚本。会话创建属于尽力而为；如果 OMID 激活、上下文或验证资源配置失败，素材仍会继续渲染。

支持的广告格式

广告格式	HTML / MRAID	VAST 视频
横幅广告（320×50）	✓	—
MREC（300×250）	✓	—
插屏广告	✓	✓
激励视频广告	✓	✓
原生广告	—	—
开屏广告（App Open）	视端点配置而定	视端点配置而定

App Open 的 OM SDK 度量取决于端点配置，仅在 CloudX 从 bid.adm 渲染素材时适用；CloudX 会在接入期间确认支持情况。

面向发布商的广告格式目录中的原生广告通过移动 SDK 网络适配器提供，不在公开 OpenRTB 买方端点约定范围内。因此，原生广告一行并不承诺 CloudX 会为买方返回的原生广告标记提供 OM SDK 度量；合作伙伴 SDK 可能提供自己的度量。

上表中的勾选表示 SDK 会在对应渲染路径尝试创建 OMID 会话，并不保证会话创建成功或供应商一定收到报告。

竞价请求中的信号

CloudX 在受支持的 banner 与视频展示上声明 OMID 支持。API 框架数组中包含 7（OMID-1）：

路径	取值
`imp.banner.api`	`3`（MRAID-1）、`5`（MRAID-2）、`6`（MRAID-3）、`7`（OMID-1）
`imp.video.api`	`3`（MRAID-1）、`5`（MRAID-2）、`6`（MRAID-3）、`7`（OMID-1）

竞价响应中没有用于启用度量的字段。CloudX 不读取 bid.apis；无论出价中是否声明该框架，SDK 都会尝试根据素材和可用的验证资源创建会话。

选择度量供应商

您需要与可见性度量供应商建立直接合作关系。CloudX 不转售或代理度量服务，也不接收您的供应商报告。

请从 IAB Tech Lab 合规企业名单中 OM SDK Compliance 的 Mobile App 类别选择供应商。在投放广告活动之前，请联系供应商验证您的代码：未经供应商验证的代码可能正常渲染，却不上报任何数据。

配置可见性代码

HTML 与 MRAID

请将供应商的 OMID JavaScript 代码嵌入您在 bid.adm 中返回的 HTML。代码在文档中的具体位置请咨询供应商，各家供应商的要求不同。

CloudX 会创建绑定到素材 WebView 的 HTML display 广告会话，并将验证脚本与素材自身的 JavaScript 相互隔离。

VAST

请将 <AdVerifications> 作为 <InLine> 的直接子元素返回。CloudX 渲染的所有 VAST 版本均从该位置读取。链路中 wrapper 上声明的验证信息会与 inline 广告自身的验证信息合并。

<AdVerifications>
  <Verification vendor="vendor-key">
    <JavaScriptResource apiFramework="omid" browserOptional="true">
      <![CDATA[https://vendor.example/omid-verification.js]]>
    </JavaScriptResource>
    <VerificationParameters>
      <![CDATA[vendor-specific-payload]]>
    </VerificationParameters>
  </Verification>
</AdVerifications>

要求

要求	说明
`<JavaScriptResource>`	必需。CloudX 仅根据 JavaScript 资源构建 OMID 验证资源；`<ExecutableResource>` 会被解析，但不参与度量。
`vendor` 属性	请在 `<Verification>` 上设置，取值使用度量供应商提供的 vendor key。
`<VerificationParameters>`	供应商提供负载时请务必设置。只有同时存在 `vendor` 属性与该参数时，CloudX 才会将 vendor key 与参数传递给验证脚本；缺少任意一项时，脚本将不带这些信息加载。
HTTPS	必需。验证资源请通过 `https` 提供。使用其他协议的资源会被跳过，对应供应商将不被度量。

CloudX 追踪的内容

HTML 或 VAST 的 OMID 会话成功启动时进行可见性度量，展示事件由 SDK 拥有。
在相应追踪路径可用时，追踪 VAST 4.1 的 ViewableImpression 与标准 Impression 事件。

不含 <AdVerifications> 的 VAST 素材仍会渲染，CloudX 自身的展示追踪也仍会触发，但您的供应商没有可度量的对象：不会加载验证脚本，供应商侧也不会出现任何报告。

CloudX 自身的发布方展示触发规则与供应商 OMID 报告相互独立。Android 展示广告要求至少 50% 可见并持续 1 秒；VAST 通常要求在渲染器认定至少 50% 可见时累计播放 2 秒。在 Android 上，时长短于 2 秒的 VAST 素材如果完整播放至结束，且结束时渲染器仍认定素材至少 50% 可见，也会达到展示触发条件。iOS 全屏 HTML 另有 1 秒兜底触发器，因此 CloudX 展示并不能证明供应商也度量到了同一次展示。

测试

请与 CloudX 客户经理一起启用测试广告项，并在其上返回您已埋点的广告素材。
在设备上产生测试展示。
在扩大投放之前，请让度量供应商在其日志与报告中确认这些展示。

如果供应商已验证代码但仍缺少度量数据，请联系您的 CloudX 客户经理。

信任与供应质量

了解 OM SDK 支持能够证明什么，以及哪些质量结论需要带日期的证据。