Multi-size autoload banner placements are similar to autoload banners, but can present banners of varying sizes. For instance, it is possible to display a banner of the standard size 320x53, followed by a medium rectangle of size 300x250 within the same placement.
It will depend on the server-side configuration on the Dashboard and what actual sizes are getting delivered to your placement.
val placement = AATKit.createAutoLoadMultiSizeBannerPlacement("<PLACEMENT_NAME")
The green background is an ad container (FrameLayout), into which the placement view is added by the app. It represents the space that the app reserves for a multi-size banner placement view (the green colour is just used here for explanatory purposes).
You will receive different placement callbacks by implementing the AutoLoadMultiSizeBannerPlacementListener.
@OverridepublicvoidonHaveAdWithBannerView(@NonNullPlacement placement, @NonNullBannerPlacementLayout bannerView) {// The placement has loaded a new ad// [IMPORTANT] remove the previously displayed banner view// Add the received bannerView on the screen}@OverridepublicvoidonPauseForAd(@NonNullPlacement placement) {// Ad went fullscreen and that application should pause.}@OverridepublicvoidonResumeAfterAd(@NonNullPlacement placement) {// Ad came back from fullscreen and that application should resume.}@OverridepublicvoidonNoAd(@NonNullPlacement placement) {// The placement could not load a new ad}
overridefunonHaveAdWithBannerView(placement: Placement, bannerView: BannerPlacementLayout) {// The placement has loaded a new ad// [IMPORTANT] remove the previously displayed banner view// Add the received bannerView on the screen}overridefunonPauseForAd(placement: Placement) {// Ad went fullscreen and that application should pause.}overridefunonResumeAfterAd(placement: Placement) {// Ad came back from fullscreen and that application should resume.}overridefunonNoAd(placement: Placement) {// The placement could not load a new ad}
Request Ad
Automatic Reload
To automatically load (and reload) the multi-size auto-load banner placement enable auto-reload. If you do not set the refresh time interval seconds explicitly, AATKit will
Reload every 30 seconds (if no refresh time interval is set on the Dashboard)
Respect the refresh time interval setting of the Dashboard (which means, you can configure the interval without having to re-publish your app)
// reload the banner placement every 30 seconds.placement.startAutoReload();
// reload the banner placement every 30 seconds.placement.startAutoReload()
The minimum refresh time is 30 seconds.
This needs to stop the auto-reload when it is no longer needed (e.g. if the view controller presenting ads will disappear):
placement.stopAutoReload();
placement.stopAutoReload()
One Placement for Multiple Screens
If the same placement is used on various different pages of the app and you want to load a new ad every time the user navigates to another page, you can achieve that by calling stopAutoReload() in the first controller and then call startAutoReload() in the next controller. This will immediately load and present a banner ad.
placement.stopAutoReload();// move to next screenplacement.startAutoReload();
placement.stopAutoReload();// move to next screenplacement.startAutoReload();
Complete Code Example
privateAutoLoadMultiSizeBannerPlacement placement =AATKit.createAutoLoadMultiSizeBannerPlacement("<PLACEMENT_NAME");privateBannerPlacementLayout loadedBanner =null;@OverrideprotectedvoidonResume() { super.onResume();// [IMPORTANT] Notify AATKit about activity lifecycleAATKit.onActivityResume(this);// Set placement listener to listen to the callbacksplacement.setListener(this);// reload the banner placement every 30 seconds.placement.startAutoReload();}@OverrideprotectedvoidonPause() {// [IMPORTANT] Stop placement auto-reloadplacement.stopAutoReload();// [IMPORTANT] Notify AATKit about activity lifecycleAATKit.onActivityPause(this); super.onPause();}// AutoLoadMultiSizeBannerPlacementListener implementation@OverridepublicvoidonPauseForAd(@NonNullPlacement placement) {// App is paused after banner got clicked}@OverridepublicvoidonResumeAfterAd(@NonNullPlacement placement) {// Back to the app after clicking on the ad}@OverridepublicvoidonHaveAdWithBannerView(@NonNullPlacement placement, @NonNullBannerPlacementLayout bannerView) {//clear previous bannerbannerFrame.removeAllViews();if (loadedBanner !=null) {loadedBanner.destroy(); }//present new banner loadedBanner = bannerView;bannerFrame.addView(loadedBanner);}@OverridepublicvoidonNoAd(@NonNullPlacement placement) {// The placement could not load a new ad}
privateval placement = AATKit.createAutoLoadMultiSizeBannerPlacement("<PLACEMENT_NAME")privatevar loadedBanner: BannerPlacementLayout? =nullprotectedoverridefunonResume() {super.onResume()// [IMPORTANT] Notify AATKit about activity lifecycleonActivityResume(this)// Set placement listener to listen to the callbacks placement.listener =this// reload the banner placement every 30 seconds. placement.startAutoReload()}protectedoverridefunonPause() {// [IMPORTANT] Stop placement auto-reload placement.stopAutoReload()// [IMPORTANT] Notify AATKit about activity lifecycleonActivityPause(this)super.onPause()}// AutoLoadMultiSizeBannerPlacementListener implementationfunonPauseForAd(placement: Placement) {// App is paused after banner got clicked}funonResumeAfterAd(placement: Placement) {// Back to the app after clicking on the ad}funonHaveAdWithBannerView(placement: Placement, bannerView: BannerPlacementLayout) {//clear previous banner bannerFrame.removeAllViews() loadedBanner?.destroy()//present new banner loadedBanner = bannerView bannerFrame.addView(loadedBanner)}funonNoAd(placement: Placement) {// The placement could not load a new ad}