public interface CustomEventBanner implements CustomEvent

A custom event to support banner ads.

The typical life-cycle for a custom event is to have requestBannerAd(Context, CustomEventBannerListener, String, AdSize, MediationAdRequest, Bundle) called once. At this point the adapter should create a View and report to the CustomEventBannerListener either onAdLoaded(View) or onAdFailedToLoad(int). Subsequent requests will be made with a new instance of the custom event. At the end of the life cycle, a best effort is made to call onDestroy(), though this is not guaranteed. Note that requestBannerAd(Context, CustomEventBannerListener, String, AdSize, MediationAdRequest, Bundle) is called on the UI thread so all the standard precautions of writing code on that thread apply. In particular, the code should not call any blocking methods.

The adapter is expected to expose events via the CustomEventBannerListener passed in the requestBannerAd(Context, CustomEventBannerListener, String, AdSize, MediationAdRequest, Bundle) call. All parameters necessary to make an ad request should be passed in the serverParameter, MediationAdRequest, and customEventExtras parameters.

Public Method Summary

abstract void
requestBannerAd(Context context, CustomEventBannerListener listener, String serverParameter, AdSize size, MediationAdRequest mediationAdRequest, Bundle customEventExtras)
Called by the mediation library to request a view from the custom event.

Inherited Method Summary

Public Methods

public abstract void requestBannerAd (Context context, CustomEventBannerListener listener, String serverParameter, AdSize size, MediationAdRequest mediationAdRequest, Bundle customEventExtras)

Called by the mediation library to request a view from the custom event.

If the request is successful, onAdLoaded(View) should be called.

If the request is unsuccessful, onAdFailedToLoad(int) should be called on the listener with an appropriate error cause.

This method is called on the UI thread so all the standard precautions of writing code on that thread apply. In particular your code should not call any blocking methods.

Parameters
context The Context of the AdView which will contain the custom event View. An Activity is preferred.
listener Listener to custom event with callbacks for various events.
serverParameter The string configured in the publisher UI as the parameter for the custom event.
size The size of the view to fetch. The size of the view should be as close as possible to the size specified in this parameter. If this view size is not supported, the request should fail and onAdFailedToLoad(int) should be called.
mediationAdRequest Generic targeting parameters to use when requesting a view.
customEventExtras A Bundle of parameters set by the publisher on a per-request basis.