This document provides steps to integrate the Mobvista Ads SDK into an Android application to generate advertising revenue. It describes importing the Mobvista library, configuring the application manifest, and displaying different ad formats like banners, floating ads, and interstitial ads. The SDK can maximize revenue by showing interstitial ads when users press the back or home buttons to exit the app.

1. How to integrate Mobvista Ads SDK
V1.0
Introduction
This document will guide you through the integration process of the Mobvista SDK, which will
help you make money from your Android applications.
It’s time to take several minutes to integrate the Mobvista Ads SDK into your app and try smart
ads to maximize the revenue from your traffic now.
If you have any questions, contact us via publisher@mobvista.com.
Step1. Import Mobvista Ads SDK Library to Eclipse project
Unzip the “MobvistaAdsSdk” folder from the SDK zip to your workspace.
Right click on the ‘Package Explorer’ view in Eclipse and choose ‘Import’
In the ‘Import’ window, go to ‘General’ and then choose ‘Existing Projects into Workspace’.
Then click ‘Next’

2. In the new “Import” window, click ‘Browse’ and navigate to the unzipped mobvistaAdsSdk folder
in your workspace.
Now, your ‘Package Explorer’ should look like this (in this example, YourApp is your project):

3. Step2. Integrate your application with Mobvista Ads SDK
Right click on the MobvistaAdsSdk project, click on ‘Properties’ and choose ‘Android’ from the
navigation pane. Make sure that the MobvistaAdsSdk project is marked as a Library:

4. Add a reference to the MobvistaAdsSdk in your project:
Right click on “your project”, and choose ‘Properties’.
Choose ‘Android’ from the navigation pane.
Click ‘Add’ and choose ‘MobvistaAdsSdk from the new opened window:
Step3. Update your Manifest file
1. Under the main manifest tag, add the following permissions:
<uses-permission android:name="android.permission.INTERNET"/>

5. <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/>
2. Under the application tag, add new activities:
<activity android:name="com.mobvista.sdk.ad.InAppWebView"
android:configChanges="orientation|keyboardHidden|screenSize"
android:windowSoftInputMode="adjustPan" />
<activity android:name="com.mobvista.sdk.ad.RichMediaActivity"
android:configChanges="orientation|keyboardHidden|screenSize"
android:windowSoftInputMode="adjustPan" />
3. Under the application tag, add your developer ID and app ID:
<meta-data android:name="mobvista.ads.sdk.apikey" android:value="your dev id"/>
<meta-data android:name="mobvista.ads.sdk.appid" android:value="your app id"/>
You can find your IDs in the developer’s portal.
Step4. Show Banner Or Text Ads
To add the Banner or Text Ads, add the following view inside your Activity layout XML:
Attribute Description
refreshtime Refresh time should be between 15 to 30
seconds, default value is 20 seconds
adtype banner or text
<com.mobvista.sdk.ad.AdView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
refreshtime="20" adtype="banner"/>

6. Step5 . Show FloatWall Ads
i. In your activity, create a member variable:
private FloatAdView adView = new FloatAdView(this,adListener);
Note: The parameter of adView constructor is the context (activity) and adListener
ii. Override the onPause method and add the call to adView.onPause():
@Override
public void onResume(){
super.onResume();
adView.onPause();
}
Note: Add this call right after the call to super.onPause()
iii. Override the onResume method and add the call to adView.onResume():
@Override
public void onResume(){
super.onResume();
adView.onResume();
}
Note: Add this call right after the call to super.onResume()
iv. Override the onDestroy method and add the call to adView.onDestroy():
@Override
public void onDestroy(){
super.onDestroy();
adView.onDestroy();
}
Note: Add this call right after the call to super.onDestroy()

7. v. Full Example :
public class FloatWallActivity extends Activity {
private FloatAdView adView;
protected void onCreate(Bundle savedInstanceState) {
// TODO Auto-generated method stub
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
adView = new FloatAdView(this,adListener);
}
protected void onPause() {
super.onPause();
adView.onPause();
};
protected void onResume() {
super.onResume();
adView.onResume();
};
protected void onDestroy() {
super.onDestroy();
adView.onDestory();
}
AdListener adListener = new AdListener()
{
public void onAdError(Msg msg) {
}
public void onAdShow() {
}
public void onNoAd() {
}
public void onAdClick() {
}
public void onAdClose() {
}
};
}
Step6. Show Interstitial Ads
In your activity, please add:

8. SDKManager sdkManager = new SDKManager(this);
Example:
private SDKManager sdkManager;
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
if(sdkManager ==null)
sdkManager = new SDKManager(this);
}
Note: The parameter of sdkManager constructor is the context (activity)
Using Interstitial in your application
Mobvista’s Intersitital is comprised of the following three sub Ad Formats:
1.Dialog Overlay Ad
2.AppWall Ad
3.Full Screen Ad
1. Show the Ad in chosen places within the app
You can choose to show the interstitial ad in several locations within your application.
This could be upon entering, between stages, while waiting for an action and more.
We do, however, recommend showing the ad upon exiting the application by using the ‘back’
button or the ‘home’ button, as explained in steps 2 and 3 below.
Add the following code to the appropriate place or places within your activities in which you
would like to show the ad:
sdkManager.showOverlayAd();
sdkManager.showAppWall();
sdkManager.showFullScreenAd();
2. Show the Ad upon exit by pressing the 'back' button
Override the onBackPressed() method and add a call to the
sdkManager.showOverLayAd() or
sdkManager.showAppWall() or
sdkManager.showFullScreenAd():
@Override
public void onBackPressed() {
if(sdkManager!null){
// use only one from below

9. sdkManager.showOverlayAd();
sdkManager.showAppWall();
sdkManager.showFullScreenAd();
}
super.onBackPressed();
}
Note: add this call BEFORE the super.onBackPressed() call.
3. Show the Ad upon exit by pressing 'home' button
The Home button functionality can improve results and revenue.
Override the onPause() method and add a call the
sdkManager.showOverLayAd() or
sdkManager.showAppWall() or
sdkManager.showFullScreenAd():
@Override
public void onPause() {
super.onPause();
if(sdkManager!null){
// use only one from below
sdkManager.showOverlayAd();
sdkManager.showAppWall();
sdkManager.showFullScreenAd();
}
}
Add AdListener
In this SDK version we've added callback listeners for all ads, which can be called using the code
below:
sdkManager.showOverlayAd(adListener);
sdkManager.showAppWall(adListener);
sdkManager.showFullScreenAd(adListener);
AdListener adListener = new AdListener(){
public void onAdError(Msg msg) {
// This will get called if any error occurred during ad serving.
}
public void onAdShow() {
// This will be called by SDK when it’s showing any of the interstitial ad.
}
public void onNoAd() {

10. // This will be called by SDK when no interstitial ad.
}
public void onAdClick() {
// This will be called by SDK when the interstitial ad is click.
}
public void onAdClose() {
// This will be called by SDK when the interstitial ad is close.
}
};