wiki:OvaReleaseNote-1.0.0-RC6

Version 13 (modified by paul, 3 years ago) (diff)

--

What's New? (1.0.0 Release Candidate 6)

The following versions have been issued as "release candidates".

  • OVA for AS3 v1.0.0 RC6
  • OVA for JW Player 4 v1.0.0 RC6
  • OVA for JW Player 5 v1.0.0 RC6
  • OVA for Flowplayer v1.0.0 RC6

RC6 follows RC5 - please refer to the RC5 release note for a full account of all changes made up to and including RC5.

IMPORTANT: The following naming changes have occurred in this release:

  • In preparation for the V1.0 production release, the OVA for JW5 and OVA for JW4 SWFs have been renamed to "ova-jw.swf" - in addition the OVA for JW5 Javascript plugin has been renamed to "ova-jw.js". These will be the official names of the OVA for JW V1.0 plugins (renaming them allows the pre V1.0 plugins/setups to continue operating untouched on the Longtail plugin repository). It is also worth noting that existing OVA configurations will work with the new names (e.g. your JW5 external config files do not require change as the <ova.XXXX> tagset will work with the "ova-jw" SWF naming)

The following API changes have occurred in this release:

  • No additional changes over and above those included in RC5

The following functional changes are in this release:

  • Referrer ad tag variable added and VPAID referrer now uses BrowserUtils.getReferrer()

1. Adding the Referrer to an Ad Tag

An extra ad tag variable "referrer" has been created to allow the referrer to be added by OVA to an ad tag.

OVA obtains the referrer via a Javascript callout to "document.referrer"

The value is encoded when added to the ad tag if the URL has any instances of a question mark (?) or ampersand (&).

2. Tracking Event Javascript Callback API

Further to the OVA Javascript callback API described in the RC5 release note (section 17), the following callback APIs have been implemented to allow the tracking events to be traced/actioned via Javascript:

  • onImpressionEvent(event:Object, forced:Boolean)
  • onTrackingEvent(event:Object)
  • onClickTrackingEvent(event:Object)
  • onCustomClickEvent(event:Object)

To enable these callbacks, the OVA general option "canFireEventAPICalls" must be declared as "true". It is false by default.

{
    "canFireEventAPICalls": true
    ...
}