Download the Unity Plugin
Before proceeding, ensure that you have downloaded the latest version of the VMAX Unity Plugin for Android from here.
Extract all the files from the Unity Plugin archive into a separate folder. It consists of the following folders and files:
/Unity Package/Unity 5/VmaxEditorPlugin/
This file VmaxEditorPlugin.unitypackage is specifically designed for Unity 5 and above. It will add a menu item VMAX after importing.
/Unity Package/Unity 5/VmaxUnityPlugin/
This file VmaxEditorPlugin.unitypackage is specifically designed for integrating VMAX in Unity 5 and above manually. Read more here.
/Unity Package/Unity 4/VmaxEditorPlugin/
This file VmaxEditorPlugin.unitypackage is specifically designed for Unity 4. It will add a menu item VMAX after importing.
/Unity Package/Unity 4/VmaxUnityPlugin/
This file VmaxEditorPlugin.unitypackage is specifically designed for integrating VMAX in Unity 4 manually. Read more here.
Shows the code snippet for requesting ads. It contains a folder Icon Ad Sample that contains a package for requesting native icon ads and a folder VmaxSample that contains a script for banners, interstitials and rewarded videos.
/Mediation and Support Libraries/
This folder contains all libraries for all supported ad partners.
This is a library project for implementing Frame Ads.
Specifies the current version of SDK.
Import the Unity Editor Plugin
Once, you’ve downloaded the latest version of the VMAX Unity plugin, follow these steps to import the plugin in your application.
- In the Unity workspace, right click on the Assets panel.
- Select Import Package > Custom Package to import the VMAX Android Unity plugin in your Unity workspace. Choose the package ..Vmax-Android-Unity\Unity Package\Unity (version)\VmaxEditorPlugin\VmaxEditorPlugin.unitypackage for Unity 5 or 4.
- After the import is complete, you will see a new menu: VMAX.
Please note that VMAX SDK is already obfuscated, shrunk, and optimised using ProGuard. For more information on ProGuard settings, read more here.
Note: Apps where the included Android framework methods, library methods, and methods in the code referenced in a single DEX file exceed 65,536 might face an error as follows:
Conversion to Dalvik format failed:
Unable to execute dex: method ID not in [0, 0xffff]: 65536
More recent versions of the Android build system display a different error, which is an indication of the same problem:
trouble writing output:
Too many field references: 131000; max is 65536.
You may try using --multi-dex option.
Find more information read more on the Multidex issue here.
From the VMAX menu, choose Configure Mediation. This will open a new dialog box.
Here, click View Code to view program code related to an ad format or click Add Mediation Partner to choose one or more ad networks.
Add/Edit Mediation Partner
Click this button to add one or more ad networks for an ad format. For example, click Add Mediation Partner next to Banners to see an image similar to this one.
Here, you can choose one or more partners and then click Apply Changes to add and display them in the list on the Configure dialog box. To remove a partner, simply remove it from the list here or click Edit Mediation Partner, uncheck it and click Apply Changes.
Click this button to view code related to a certain ad format.
You can use the Copy to Clipboard button to copy the entire code block to your clipboard. Then paste it in a section where you wish to display that ad. Ensure that you add your adspot id and modify the code to suit your requirements.