Iad.Banner.new

Available since: Gideros 2012.8

Description

Creates an `iad.Banner` instance. If iAd framework is not available, this function gives an error.

The alignment and the orientation of the ad banner are defined by these 4 string constants:

<ul>
<li>`iad.Banner.TOP = "top"`</li>
<li>`iad.Banner.BOTTOM = "bottom"`</li>
<li>`iad.Banner.PORTRAIT = "portrait"`</li>
<li>`iad.Banner.LANDSCAPE = "landscape"`</li>
</ul>

And `iad.Banner` class dispatches these 4 events:

<ul>
<li>`Event.BANNER_AD_LOADED = "bannerAdLoaded"`</li>
<li>`Event.BANNER_AD_FAILED = "bannerAdFailed"`</li>
<li>`Event.BANNER_ACTION_BEGIN = "bannerActionBegin"`</li>
<li>`Event.BANNER_ACTION_FINISHED = "bannerActionFinished"`</li>
</ul>

When an ad banner is created, iAd will start requesting ads. Apple serves ads, and refreshes with new ads, on an automatic timer.
Apple also requires that the ad area be hidden when no ad is available to display. iAd module manages all this behavior for you automatically.

When an ad becomes available, it will be displayed on the screen, the event `Event.BANNER_AD_LOADED` is dispatched when one is about to be displayed,
or the event `Event.BANNER_AD_FAILED` is dispatched when the loading has failed. If the loading has failed, the fields `event.errorCode` and `event.errorDescription`
contains information about the failure reason.

When the user clicks on an ad, the event `Event.BANNER_ACTION_BEGIN` is dispatched. At this time, the user will either be taken out of your application
to view the app store (in this case `event.willLeaveApplication` field will be true), or they will be presented with a fullscreen advertisement to interact with,
and `event.willLeaveApplication` will be false. In the latter case, you may decide to pause the application until the event `Event.BANNER_ACTION_FINISHED` is dispatched.

 iad.Banner.new(alignment,orientation)

'alignment: (string) whether you want ads to show top or bottom of the screen. It can be either iad.Banner.TOP or iad.Banner.BOTTOM. '
'orientation: (string) orientation of the banner. It can be either iad.Banner.PORTRAIT or iad.Banner.LANDSCAPE. '