Bidease specs for third-party creatives

Modified on Wed, 14 Dec, 2022 at 6:17 AM

Primary specs:


  • Ads must support MRAID v2.0 protocol
  • MRAID tag must be 10KB max
  • All assets + code downloaded to the device must be 5MB max
  • Bidease will render the timer and the close button. Do not add your own.


Detailed specs:


  • Use this code as an index.html file and do not change it.


<!DOCTYPE HTML>
<html>

<head>
  <script src="mraid.js"></script><!-- mraid is included by default -->
  <meta charset="UTF-8">
  <meta name="mobile-web-app-capable" content="yes">
  <meta name="apple-mobile-web-app-capable" content="yes">
  <meta name="viewport" content="initial-scale=1,maximum-scale=1,user-scalable=0,viewport-fit=cover,minimal-ui" />
</head>
<body>
  <script type="text/javascript">
    var mraid; /* you can use this variable in your js file as a mraid reference */
    var rc = { /* our macros */
      exchange: "{{.Exchange}}",
      s2s: !!{{.S2S}},
      campaignID: "{{.CampaignID}}",
      bidID: "{{.BidID}}",
      country: "{{.Country}}",
      ifa: "{{.IFA}}", 
      rewarded: !!{{.Rewarded}},
      interstitial: !!{{.Interstitial}}
    };
    var showAd = function () {
      if (mraid) {
        mraid.removeEventListener("ready", showAd);
        if (mraid.isViewable()) { /* real impression */
          sendImpression();
          initGame(); /* define and use this method in your js file to init the playable after the real impression. It is recommended to preload all the assets up to this point  */
        } else {
          mraid.addEventListener("viewableChange", trackViewableChange);
        }
      } else {
        initGame();
      }
    };

    var trackClick = function() { /* use this method in your js file on CTA click */
      /* ... */
      console.log("click");
    };

    var trackViewableChange = function (viewable) {
      if (viewable) {
        mraid.removeEventListener("viewableChange", trackViewableChange);
        showAd();
      }
    };

    var sendImpression = function () {
      /* bidease own impression tracking */
      console.log("impression");
    };

    window.onload = function () {
      if (mraid && mraid.getState() === "loading") {
        mraid.addEventListener("ready", showAd);
      } else {
        showAd();
      }
    };
  </script>
  <script src="script.js"></script> <!--  your js file -->
</body>
</html>


  • CTA clicks leading to store page (Google Play Store, Apple App Store) must use trackClick().
  • All external references must be HTTPS instead of HTTP.
  • Include all of your javascript code, css styles, images and audio assets to a single script.js file.


Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons

Feedback sent

We appreciate your effort and will try to fix the article