可见性

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

CloudX 在 CloudX SDK 中集成了 IAB Tech Lab 的 Open Measurement SDK（OM SDK），并对自行渲染的广告素材进行可见性度量。CloudX 在 OM SDK 合规名单中登记的合作伙伴名称为 Cloudxai，在 Android 与 iOS 上均覆盖 HTML display 与视频。使用受支持 CloudX SDK 版本的所有应用会自动参与度量，发布商无需进行任何集成工作。

度量由广告素材驱动。CloudX 负责创建广告会话并运行您的供应商验证脚本；该脚本需由您在广告素材中提供。

支持的广告格式

广告格式	HTML / MRAID	VAST 视频
横幅广告（320×50）	✓	—
MREC（300×250）	✓	—
插屏广告	✓	✓
激励视频广告	✓	✓
原生广告	—	—
开屏广告	—	—

原生广告与开屏广告不由 CloudX 渲染，因此不会为其创建 OM 会话。

竞价请求中的信号

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，而是从广告素材中推导会话。因此，只要素材携带验证资源，无论您是否在出价中声明该框架，都会被度量。

选择度量供应商

您需要与可见性度量供应商建立直接合作关系。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 客户经理一起启用测试广告项，并在其上返回您已埋点的广告素材。
在设备上产生测试展示。
在扩大投放之前，请让度量供应商在其日志与报告中确认这些展示。

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