Viewability

Open Measurement (OMID) on CloudX-rendered creatives, and how to configure verification tags

CloudX embeds the IAB Tech Lab Open Measurement SDK (OM SDK) in the CloudX SDK and measures viewability on creatives it renders itself. CloudX is listed on the OM SDK compliance register as partner Cloudxai, for HTML display and video on both Android and iOS. Every app on a supported CloudX SDK version participates automatically — publishers do no integration work.

Measurement is driven by the creative. CloudX opens the ad session and runs your vendor’s verification script; you supply that script in the creative markup.

Supported formats

FormatHTML / MRAIDVAST video
Banner (320×50)
MREC (300×250)
Interstitial
Rewarded
Native
App Open

Native and App Open are not rendered by CloudX, so no OM session is created for them.

Bid request signal

CloudX advertises OMID support on supported banner and video impressions. The API framework array includes 7 (OMID-1):

PathValues
imp.banner.api3 (MRAID-1), 5 (MRAID-2), 6 (MRAID-3), 7 (OMID-1)
imp.video.api3 (MRAID-1), 5 (MRAID-2), 6 (MRAID-3), 7 (OMID-1)

No bid response field is required to enable measurement. CloudX does not read bid.apis — it derives the session from the creative, so a creative carrying verification resources is measured whether or not you declare the framework on the bid.

Choose a measurement vendor

You need a direct relationship with your viewability vendor. CloudX does not resell or proxy measurement, and does not receive your vendor’s reporting.

Pick a vendor from the IAB Tech Lab compliant companies list under OM SDK Compliance, Mobile App category. Contact the vendor to validate your tags before you launch a campaign — a tag that a vendor has not validated can render correctly and still report nothing.

Configuring viewability tags

HTML and MRAID

Embed your vendor’s OMID JavaScript tag in the HTML you return in bid.adm. Ask the vendor where in the document the tag belongs; placement rules differ by vendor.

CloudX opens an HTML display ad session bound to the creative’s WebView, with verification scripts isolated from the creative’s own JavaScript.

VAST

Return <AdVerifications> as a direct child of <InLine>. CloudX reads it there on every VAST version it renders. Verifications declared on a wrapper in the chain are merged with the inline ad’s own.

<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>

Requirements

RequirementDetail
<JavaScriptResource>Required. CloudX builds OMID verification resources from JavaScript resources only; <ExecutableResource> is parsed but not measured.
vendor attributeSet it on <Verification>. Use the vendor key your measurement vendor gives you.
<VerificationParameters>Set it whenever your vendor supplies a payload. CloudX passes the vendor key and parameters to the verification script only when both the vendor attribute and the parameters are present; with either missing, the script loads without them.
HTTPSRequired. Serve verification resources over https. A resource on any other scheme is skipped, and that vendor is not measured.

What CloudX tracks

  • OMID viewability for HTML and VAST creatives, with the impression event owned by the SDK.
  • VAST 4.1 ViewableImpression events, alongside the standard Impression event.

A VAST creative with no <AdVerifications> still renders and still fires CloudX’s own impression tracking, but there is nothing for your vendor to measure — no verification script is loaded and no vendor reporting appears.

Testing

  1. Enable a test line item with your CloudX account manager and return your instrumented creative on it.
  2. Run test impressions on a device.
  3. Have your measurement vendor confirm the impressions in their logs and reporting before you scale spend.

Contact your CloudX account manager if measurement is missing after your vendor has validated the tags.