What
is the difference between playedVDOAd and noVDOAd?
These
functions are called in the following cases
In
response to the API call - (void)playVDOAd; If the video ad is
played and the delegate function playedVDOAd is implemented,
playedVDOAd is called. OR
In
response to the API call - (void)playVDOAd;If the video ad is not
played and the delegate function noVDOAd is implemented,noVDOAd is
called.
In
response to the API call - (void)playPreApp;If the pre-app video ad
is played and the delegate function playedPreApp is NOT
implemented, playedVDOAd is called. OR
In
response to the API call - (void)playPreApp;If the pre-app video ad
is not played and the delegate function noPreApp is NOT
implemented,noVDOAd is called.
In
response to the API call – (void)playInApp; If the in-App
interstitial ad is played and the delegate function playedInApp is
NOT implemented, playedVDOAd is called. OR
In
response to the API call – (void)playInApp; If the in-app
interstitial ad is not played and the delegate function noInApp is
NOT implemented, noVDOAd is called.
What
is the difference between playeInApp and playVDOAd?
The
request to playInApp tries to play any in-app format which can be a
video ad or an interstitial ad with webview. On the other hand, the
request to playVDOAd tries to select an ad from a pool of video ads
only and plays it.
What
does the “message” parameter do in playVDOAd?
The
message parameter sets a user defined string on the top bars that are
shown with video ads. This message stays for as long as the skip
option to skip the ad is not enabled. For example - if skip is
enabled at 0 seconds (means - just at the start of the ad), this
message will not be shown. If skip is enabled after 5 seconds then
this message will stay for 5 seconds and after 5 seconds it will be
replaced by a Skip Ad message.
The
API openWithAppKey has several variations. What is the deal?
The
API has different flags to offer more fine-grained control on serving
of different ad-formats.
- startWithBanners
- TRUE
- This
will enable the default banner serving by the SDK in the frame that
is given at the time of the init call (openWithAppKey). This banner
is rotated at the interval of 30 seconds by the SDK.
- startWithBanners
- FALSE
- This
will disable the default banner serving by the SDK
- startWithPreApp
- TRUE
- This
will enable the pre-app ad serving by the SDK. If a pre-app video is
available , it will be served immediately after the init call.
- startWithPreApp
- FALSE
- This
will disable the pre-app ad serving by the SDK.
The
default API -
(void)openWithAppKey:(NSString*)applicationKey useLocation:(BOOL)use
withFrame:(CGRect) frame; assumes the both the flags to be true and
serves the ads accordingly.
What
is the difference between the default banner serving of the SDK and
on-demand banner serving?
The
SDK allows a developer to control the banner serving capabilities
with the help of default banners and on-demand banners.
The
default banner is the one that is played inside the frame that is
given at the time of init call. This banner gets refreshed at the
interval of 30 seconds.
However,
sometimes a user my require to show banners on-demand (for example
while switching between tab views of an application). In this case,
one can use the API getBannerOfSize(). This API either returns a
UIView object (that has the banner) that can be placed on any parent
view, or returns NULL if no banner is available.
If
I use getBannerOfSize: to obtain a UIView, can I place this ad view
anywhere on the display, not just at the top or bottom of the
display?
This
view can be placed anywhere on the application screen.
If
I request a banner of size 320X50 instead of 320X48, what will I get?
The
SDK internally treats size 320 X 48 and size 320 X 50 as same in the
case of API getBannerOfSize. In the case of default
banner (that is the one that is invoked by setting the flag
startWithBanners to TRUE) the frame that is passed to the init call
should be of the correct size - 320 X 48 in case of iPhone, otherwise
it will create a black space (if the frame size is larger) in the
frame inside after placing the banner.
What
does rotateBanner do and how would one use it?
This
call allows the user to over-ride the default banner rotation of the
SDK. The default banner change interval is 30 seconds. If the user
wishes, he can use the call rotateBanner to instruct the SDK to
change the default banner on-demand.
Under
iOS 4.0 and above, the application has the capability of being pushed
in the background. That being the case, how frequently will I see the
pre-app ads?
The
SDK internally re-tries to play the pre-app ads after the application
is brought back to the foreground.
However,
this depends on certain parameters.
The
time difference between the pushing the app and bringing it back to
the foreground should be sufficiently large (5 minutes by default).
This can be configured to smaller values.
The
SDK re-initiates the connection with the servers to get the ads
list ad there must be a playable pre-app video available to play.
What
is useLocation parameter in openWithAppKey: used for?
As
of now, this flag is ignored. This was done because Apple disabled
location based advertising.
What
is + (int)isEdgeNetwork and how is it used?
This
is a convenience function available in the SDK for the developers to
figure out if the device is on a slow (edge) network. The SDK
internally uses some heuristics to find out if the network connection
is edge.