Show Sidebar

Upgrade Guide for VMAX Android Unity 3.6

Please note that the Upgrade Guide is relevant only for Unity 5. If you are using Unity 4, kindly write to us at

Older VMAX Android SDK versions (prior to 3.6) will be deprecated soon. You are requested to upgrade to version 3.6 at the earliest to continue using VMAX in your apps.

VMAX Android SDK 3.6 has following changes compared to earlier versions:
What’s new?

VMAX SDK initialization

Now it’s not compulsory to use initVmaxSdk() api of VMAXPlugin i.e. VMAXPlugin.initVmaxSdk() for sdk initialization.
If you are integrating Rewarded interstitial then only it is mandatory to call VMAXPlugin.initWithRewardedInterstitial(string accountKey) api

Below is the code snippet for the same

Register reward delegate

To Register above delegate for this ad format, It is required to call below api before caching the ad

Unregister reward delegate

To Unregister above delegate for this ad format, It is recommended to call this api in onDestroy() event of activity


Callbacks has been completely modified

Note: For callbacks like onAdReady, onAdError and onAdEnd you can split the callback parameter with ‘|’ character and make use of requestCode at split index 0. If you are using multiple objects of VMAXPlugin, utilize the request code so as to differentiate callback is coming for which object

Ad States

Corresponding with the listener as mentioned above, for SDK version 3.6.1 onwards you can check for the ad state which now will be set to one of the following possible values depending on the ad lifecycle:

You can query for the ad state by using the getAdState api on the adview as illustrated in the example below:


You can now set the scale for billboard ads

Ad Error

You can query for the error code, description and title of the error.Below are the error states along with its code.

Error handling

Below callback will help to handle errors gracefully

Ad Partner

This is helpful in identifying ad sources during ad delivery as well as erroneous situations. You can query for the partner name and partner SDK version through the adPartner property on VMaxAdView. Below is the list of Vmax supported partners.

To Fetch the partner specific information, use the snippet given below:

 UX for Billboard ads

3.6.1 now has the UX type UX_BILLBOARD for requesting billboard ads. UX_INLINE_DISPLAY is now removed.

API Changes

The following classes and apis are now obsolete.

APIs removed

• WalletElement class

• RewardedVideo class
• RewardedVideo Callbacks