Skip to main content

Create Android Adapter

Extend Base Adapter Class#

Create a custom adapter class in Java / Kotlin with the naming convention as <AdapterName>SDKAdapter.

class <AdapterName>SDKAdapter : MesonBaseSDKAdapter {
// overrides the methods
}

Initialize the Custom Network SDK#

Override one of the initialization methods provided in the base adapter.

Asynchronous Initialization#

initOnSDKInit(), method is provided by MesonBaseSDKAdapter to initialize custom network SDK asynchronously. The method return type is void.

ParameterDescription
AdapterConfigurationAll the network related information required to initialize the custom network SDK. AdapterSDKConfiguration will have atleast one of the required credentials; Network (Account ID), App (App ID) or Ad Line (Placement ID).
MesonSdkInitializationListenerThis listener contains a single call back method onComplete(Error). Listener object should call onComplete() method with the null value if network SDK is initialized successfully or else pass Error object with the proper error message.
fun initOnSDKInit(adapterSdkConfig: AdapterSdkConfiguration, sdkListener: MesonSdkInitializationListener) {
//Write the code to initialize the SDK asynchronously
}

Synchronous Initialization#

initOnAdLoad(), method is provided by MesonBaseSDKAdapter to initialize network SDK synchronously. The method return type is not void; it should return null if network SDK is initialized successfully or else Error object with the proper error message.

ParameterDescription
AdapterConfigurationAll the network related information required to initialize the custom network SDK. AdapterSDKConfiguration will have atleast one of the required credentials; Network (Account ID), App (App ID) or Ad Line (Placement ID).
fun initOnAdLoad(adapterConfig: AdapterSdkConfiguration): Error?

Set SDK Version#

getSDKVersion(), override this method to return custom network SDK version.
override fun getSDKVersion(): String

Manage Ad Lifecycle#

Create custom network SDK adapter classes per format with naming convention as AdapterNameFormatAdapter by extending the base format adapter classes.

Banner Ad#

To create a custom network SDK Adapter class for Banner format extend the MesonBaseBannerAdapter

Load Ad#

load(), override this method in MesonBaseBannerAdapter to load ad from the custom network SDK.

ParameterDescription
AdapterConfigurationAll the network related information required to initialize the custom network SDK. AdapterSDKConfiguration will have atleast one of the required credentials; Network (Account ID), App (App ID) or Ad Line (Placement ID).
MesonBannerAdapterListenerThis provides the ad lifecycle listener events.
override fun load(adapterConfig: AdapterAdConfiguration,listener: MesonBannerAdapterListener) {
// Write the code to load network sdk ad
}

Return Banner Ad View#

getAdView(), override this method in the MesonBaseBannerAdapter to return custom network SDKs banner ad view.
override fun isReady(): Boolean{
// Write the code to verify whether network sdk is ready to show ad or not
}

Release Resources#

invalidate(), override this method to release the resources.
override fun invalidate()

Interstitial Ad#

To create a custom network SDK Adapter class for Interstitial format extend the MesonBaseInterstitialAdapter

Load Ad#

load(), override this method in MesonBaseBannerAdapter to load ad from the custom network SDK.

ParameterDescription
AdapterConfigurationAll the network related information required to initialize the custom network SDK. AdapterSDKConfiguration will have atleast one of the required credentials; Network (Account ID), App (App ID) or Ad Line (Placement ID).
MesonInterstitialAdapterListenerThis provides the ad lifecycle listener events.
override fun load(adapterConfig: AdapterAdConfiguration,listener: MesonInterstitialAdapterListener) {
// Write the code to load network sdk ad
}

Ad Load Success#

isReady(), override this method to verify whether custom network SDK has successfully loaded an ad. This method returns true if custom network SDK is ready to show the ad or else returns false.
override fun isReady(): Boolean

Show Ad#

show(), override this method to show interstitial or rewarded ad from the custom network SDK.
override fun show(){
// Write the code to show the network sdk ad
}

Release Resources#

invalidate(), override this method to release the resources.
override fun invalidate(){
// Write the code to release the network sdk resources
}

Rewarded Ad#

To create a custom network SDK Adapter class for Rewarded format extend the MesonBaseRewardedAdapter

Load Ad#

load(), override this method in MesonBaseBannerAdapter to load ad from the custom network SDK.

ParameterDescription
AdapterConfigurationAll the network related information required to initialize the custom network SDK. AdapterSDKConfiguration will have atleast one of the required credentials; Network (Account ID), App (App ID) or Ad Line (Placement ID).
MesonRewardedAdapterListenerThis provides the ad lifecycle listener events.
override fun load(adapterConfig: AdapterAdConfiguration,listener: MesonRewardedAdapterListener) {
// Write the code to load network sdk ad
}

Ad Load Success#

isReady(), override this method to verify whether custom network SDK has successfully loaded an ad. This method returns true if custom network SDK is ready to show the ad or else returns false.
override fun isReady(): Boolean

Show Ad#

show(), override this method to show interstitial or rewarded ad from the custom network SDK.
override fun show()

Release Resources#

invalidate(), override this method to release the resources.
override fun invalidate()