IMBannerDelegate Protocol Reference
Conforms to | NSObject |
---|---|
Declared in | IMBannerDelegate.h |
Overview
- A listener for receiving notifications during the lifecycle of a banner ad. *
- Note All the events in this listener will be invoked on your application’s UI thread.
In most cases your application will need to listen for the following events on a banner ad
The outcome of an ad request (if the request succeeded or failed); see bannerDidFinishLoading:(IMBanner)banner; and banner:(IMBanner)banner didFailToLoadWithError:(IMRequestStatus*)error;
The ad opened an overlay that covered the screen. This means that the user can no longer interact with your application; see bannerDidPresentScreen:(IMBanner*)banner
The ad overlay opened was dismissed. The user is now free to interact with your application; see bannerDidDismissScreen:(IMBanner*)banner;
A user interaction with the ad will result in the User leaving your application context; see userWillLeaveApplicationFromBanner:(IMBanner*)banner;
If your application involves running rewarded or incentivised ads, then you should, in addition to the above events, also listen for the banner:(IMBanner)banner rewardActionCompletedWithRewards:(NSDictionary)rewards event and handle it appropriately to unlock rewards for the user of your app.
– banner:gotSignals:
The callback used to give the signals to the delegate. This callback is invoked after getSignals method is invoked on the Banner instance.
- (void)banner:(IMBanner *)banner gotSignals:(NSData *)signals
Discussion
The callback used to give the signals to the delegate. This callback is invoked after getSignals method is invoked on the Banner instance.
Declared In
IMBannerDelegate.h
– banner:failedToGetSignalsWithError:
Notifies the delegate that the getSignals call on the IMBanner instance has failed to return the sginals.
- (void)banner:(IMBanner *)banner failedToGetSignalsWithError:(IMRequestStatus *)status
Discussion
Notifies the delegate that the getSignals call on the IMBanner instance has failed to return the sginals.
Declared In
IMBannerDelegate.h
– bannerDidFinishLoading:
Notifies the delegate that the banner has finished loading
- (void)bannerDidFinishLoading:(IMBanner *)banner
Discussion
Notifies the delegate that the banner has finished loading
Declared In
IMBannerDelegate.h
– banner:didFailToLoadWithError:
Notifies the delegate that the banner has failed to load with some error.
- (void)banner:(IMBanner *)banner didFailToLoadWithError:(IMRequestStatus *)error
Discussion
Notifies the delegate that the banner has failed to load with some error.
Declared In
IMBannerDelegate.h
– banner:didInteractWithParams:
Notifies the delegate that the banner was interacted with.
- (void)banner:(IMBanner *)banner didInteractWithParams:(NSDictionary *)params
Discussion
Notifies the delegate that the banner was interacted with.
Declared In
IMBannerDelegate.h
– userWillLeaveApplicationFromBanner:
Notifies the delegate that the user would be taken out of the application context.
- (void)userWillLeaveApplicationFromBanner:(IMBanner *)banner
Discussion
Notifies the delegate that the user would be taken out of the application context.
Declared In
IMBannerDelegate.h
– bannerWillPresentScreen:
Notifies the delegate that the banner would be presenting a full screen content.
- (void)bannerWillPresentScreen:(IMBanner *)banner
Discussion
Notifies the delegate that the banner would be presenting a full screen content.
Declared In
IMBannerDelegate.h
– bannerDidPresentScreen:
Notifies the delegate that the banner has finished presenting screen.
- (void)bannerDidPresentScreen:(IMBanner *)banner
Discussion
Notifies the delegate that the banner has finished presenting screen.
Declared In
IMBannerDelegate.h
– bannerWillDismissScreen:
Notifies the delegate that the banner will start dismissing the presented screen.
- (void)bannerWillDismissScreen:(IMBanner *)banner
Discussion
Notifies the delegate that the banner will start dismissing the presented screen.
Declared In
IMBannerDelegate.h
– bannerDidDismissScreen:
Notifies the delegate that the banner has dismissed the presented screen.
- (void)bannerDidDismissScreen:(IMBanner *)banner
Discussion
Notifies the delegate that the banner has dismissed the presented screen.
Declared In
IMBannerDelegate.h
– banner:rewardActionCompletedWithRewards:
Notifies the delegate that the user has completed the action to be incentivised with.
- (void)banner:(IMBanner *)banner rewardActionCompletedWithRewards:(NSDictionary *)rewards
Discussion
Notifies the delegate that the user has completed the action to be incentivised with.
Declared In
IMBannerDelegate.h