SDK 6.0 Changes & Enhancements for Buyers

Exciting features and enhancements are available to our buyers using SDK 6.0

Most Recent Changes and Enhancements

VAST 3.0: ONE by AOL: Mobile supports VAST 3.0, which provides buyers with new creative opportunities and opens up more video-enabled inventory on the marketplace.

End Cards: With VAST 3.0, we support the use of companion ads as end cards.

Native: ONE by AOL: MOBILE’s approach to native ads effectively marries supply and demand without sacrificing quantity of inventory or quality of ad experience.

Overview of SDK 6.0 Features

Recognizing Requests from SDK 6.0:

The SDK version will be passed on the bid request in the displaymanagerver attribute. Requests coming from SDK 6.0 will be displayed as 6.0.0. Future SDK releases will follow the same format.

HTML Creative Formatting:

SDK 6.0 does not center align HTML creatives. Buyers must format creatives as they are to appear. 

In addition, we do not apply styling to interstitials. Buyers must format creatives exactly as they are to appear in the full screen ad space.

iFrames: 

ONE by AOL: Mobile does not block iFrames. Due to he complexity of delivering iFrames in mobile environments we recommend buyers avoid using them. If iFrames can not be avoided, follow the best practices listed below when using them with SDK 6.0:

  • SDK 6.0 will not inject the mraid namespace into the iframe, only the top level window will have the mraid namespace. Therefore, if you want to access mraid from within your iframe, the iframe must be on the same domain as the top level window and you will need to access mraid using “window.top.mraid”. Your iframe will be on the same domain as the top level window unless you set the src attribute on the iframe.
  • Use MRAID to resize the creative container. For example, if the creative is in a 320x50 placement and the user taps the banner to expand, simply resizing the iframe to the full size of the screen without calling mraid.expand() will result in only a 320x50 portion of the creative being visible to the user.

MRAID Viewable Flag: 

ONE by AOL:Mobile SDK 6.0 supports VAST 3.0. VAST 3.0 is backwards compatible. Below find the SDK 6.0 updates related to VAST.

Valid Video Formats: The only valid video format for SDK 6.0 is MP4. No other video formats will be considered.

Bitrate Logic: The valid bitrate range is 400-1200 kbps. SDK 6 will pick the compatible format video with the highest bitrate within the given ranges outlined below.

iOS/Android:
   WiFi - Maximum valid bitrate is 1200 kbps
   Cellular - Maximum valid bitrate is 800 kbps
   Floor - Minimum valid bitrate is 400 kbps
   Default - If the network type is not known, the default bitrate is 800 kbps

End Cards ONE by AOL: Moble supports end cards on the marketplace. Supported companion ads for the end card include: static resource (image), iframe, and html content. The minimum size static resource companion ad is 300px x 250px.

Static resource companion ads may (optionally) use background color for letter boxing. The custom extension, in the form of XML attribute "backgroundcolor=", allows the VAST to dictate a background color.

MRAID Viewable Flag: 

In SDK 6.0 ad markup and resources are pre-fetched (most common for interstitial placements) and will fire off a traditional tracking pixel on each occurance. Ensure accurate tracking of display-counts and matching of marketplace delivery counts by utilizing the MRAID viewable status to determine when an ad has been delivered.

Example:

<!-- AD MARKUP HERE -->
 <script src="mraid.js"></script>
   <script type="text/javascript">
    var ts_displayed = false;

    function ts_init() {
        if (window.mraid && window.mraid.getState && window.mraid.addEventListener) {
            if (window.mraid.getState() === 'loading') {
               window.mraid.addEventListener('ready', ts_ready)
           } else {
               ts_ready()
           }
       } else {
           ts_callDisplay()
       }
   };

   function ts_ready() {
       if (window.mraid.isViewable()) {
           ts_view(true)
       } else {
           window.mraid.addEventListener('viewableChange', ts_view)
       }
   };

   function ts_view(viewable) {
       if (viewable == true || 'true') {
           ts_callDisplay()
       }
   };

   function ts_callDisplay() {
       if (!ts_displayed) {
           ts_displayed = true;
           var displayUrl = "http://example.com/impression_tracking_url";
           var xhr = ts_getXMLHttpRequest();
           xhr.open("GET", displayUrl, false);
           xhr.send()
       }
   };

   function ts_getXMLHttpRequest() {
       if (window.XMLHttpRequest) return new XMLHttpRequest();
       else return new ActiveXObject("Microsoft.XMLHTTP")
   };
   ts_init();
</script>
Have more questions? Submit a request