ORTB
MRAID section navigation

2.0 → 3.0 changes

On this page
Data status: manual curation (first-draft). The official spec has no machine-readable source; where this differs from the official text, the official PDF prevails. See data/mraid-spec/PROVENANCE.json.

Added9

Added
TargetDescription
MRAID_ENVHost-provided global object with environment details (version, vendor, supports, placementType, positions, sizes), set before mraid.js loads — reliable MRAID detection and early initialization.
exposureChangeExposure percentage, visible rectangle and occlusion rectangles — the correct basis for viewability measurement.
audioVolumeChangeAudibility measurement: volume changes delivered to the ad.
openOpen URLs / deep links outside the ad (external browser, in-app browser, other apps).
unloadGraceful self-unload and host notification for broken or unwanted ads.
setOrientationPropertiesControl device orientation behavior (with getOrientationProperties).
getCurrentAppOrientationRead the current app orientation and lock state.
getLocationDevice location access behind the location supports feature.
initVpaidVPAID appendix integrated: optional host bridge for MRAID+VPAID creatives.

Deprecated5

Deprecated
TargetDescription
isViewableKept for compatibility; superseded by exposureChange.
viewableChangeSuperseded by exposureChange.
useCustomCloseHosts always provide the close control; customClosePosition governs placement.
playVideoUse open() instead.
expand(url)Two-part creatives remain compatible but new 3.0 features do not support them.

Changed1

Changed
TargetDescription
initializationExplicit guidance for pre-loading and ad readiness: hosts detect ad readiness before showing interstitials, avoiding blank-screen experiences.
Content faithfully follows the IAB Tech Lab MRAID 3.0 official spec (CC-BY 3.0); spec data is in the original English, translations are machine-generated first drafts (draft). · API reference