Changes between Version 36 and Version 37 of OvaReleaseNote-1.0.1-RC2

Timestamp:

04/11/12 01:56:22 (14 months ago)

Author:

paul

Comment:

--

OvaReleaseNote-1.0.1-RC2

@@ -11 +11 @@
 The RC2 release note follows on from the [wiki:OvaReleaseNote-1.0.1-RC1 1.0.1 RC1 release note].
 
-== 1. Bug Fixes ==
+== 1. Change Summary ==
 
    * Ticket #356 - Reopened ticket to fix bug stopping VAST 2 <AdParameters> being passed into non-linear VPAID ads - parser code error stopped value from being extracted - resolved.
@@ -442 +442 @@
 INCLUDE_BUTTONS = false
 }}}
+
+== 5. Setting the Preferred Non-Linear Display Mode ==
+
+It is now possible to set a "preferred" display mode for non-linear ads. This is useful when two display modes (HTML5 and Flash) are set to run concurrently and one should be given "preference" over the other.
+
+When multiple display modes are set, OVA gives the "flash" display mode preference by default - this means that when a creative is to be displayed in a region, by default OVA searches the enabled "flash" regions for a possible display slot before it assesses the HTML5 regions. 
+
+If you wish to give HTML5 regions preference in the display, use the "preferred:<display-mode>" (e.g. `preferred:"html5"`) option as follows:
+
+{{{
+{
+      "ads": {
+           "overlays": {
+                "regions": {
+                     "preferred": "html5",
+                     "flash": [
+                           {
+                              "region": "auto:bottom",
+                              "enable": true
+                           }
+                     ],
+                     "html5": [
+                           {
+                              "region": "bottom",
+                              "enable": true,
+                              "overlay": false
+                           }
+                     ]
+                 }
+           },
+           "schedule": [
+                 {   
+                     "startTime": "00:00:03",
+                     "duration": 10,
+                     "tag": "http://my-ad-tag/for-an-image-overlay.xml"
+                 },
+                 {   
+                     "startTime": "00:00:15",
+                     "duration": 40,
+                     "tag": "http://my-ad-tag/for-a-vpaid-overlay.xml"
+                 }
+           ]
+      }
+}
+}}}
+
+In the example above, two overlays are to be delivered - one at 3 seconds for 10 seconds, the other at 15 seconds for 40 seconds. The first is an image overlay, the second is a VPAID overlay.
+
+"html5" has been set as the "preferred" display mode. This means that when OVA attempts to display the ad creative, the "html5" regions (with an ID "bottom" in this case) will be given preference. Because VPAID ads cannot be displayed by HTML5 however, OVA will not match the "html5" region and will fallback to the flash display mode in this case.
+
+Flash display mode supports - image, text, vpaid, html and flash (non-VPAID) non-linear creative types while HTML5 mode supports image, text, html, flash (non-VPAID), iframe and Javascript non-linear creative types.
+
+You can see an example with the code snippet above running [http://static.openvideoads.org/qa/latest/ova.jwplayer.5x/examples/pages/overlays/preferred-mode/example03.html here].
+