Prerequisites

Before you start to integrate Vpon SDK, please make sure you already have your own Vpon Publisher Account and get your License Key. Register as a Vpon Publisher if you haven’t own your Publisher Account.

Once you have your own Publisher Account, follow the instruction below to integrate Vpon Android SDK:

1. Import SDK to your project
2. Import required 3rd-party Library
3. Add com.vpadn.widget.VpadnActivity to your AndroidManifest.xml
4. Add required Permission to your AndroidManifest.xml
5. Initialize SDK in your Application or MainActivity

Import SDK to your project

Vpon provides two ways to integrate our SDK. Choose one of the following two options:

• Integrate SDK with Maven (Streamlined simple)
• Integrate SDK manually

Note: If you’ve integrated Vpon SDK before, check How to update SDK first.

Integrate SDK with Maven

Note: Maven is a build automation tool used primarily for Java projects. If you haven’t installed Maven in your device for development, please refer to Maven Introduction.

Add Vpon’s Maven repository in allprojects section in the project-level build.gradle file.

allprojects {
    repositories {
        maven{
            url 'https://m.vpon.com/sdk/android/maven'
        }
    }
}

Add the dependency with a specified version of Vpon SDK in the app-level build.gradle file (Here take SDK 4.9.1 for example).

dependencies {
    ...
    implementation 'com.vpon:vpadnSDK:5.3.0'
}

Note

• If you already set targetSdkVersion to 30 in your app, please use SDK v5.1.5 and above version.

Integrate SDK manually

Please follow the instruction below to integrate Vpon SDK to your application manually:

1. Download latest Vpon SDK here
2. Import Vpon SDK to your Android Studio project

Android Studio

1. Find libs in your Android project (Directory：Project Name -> app -> libs)

2. Right click on libs and choose to Reveal in Finder

3. Move the SDK (.jar / .aar) to libs (You can also grab the file into libs in IDE)

4. Go back to your Android project and you will see the SDK (.jar / .aar) we just added shows in the [libs] folder. Right click on the SDK (.jar) and choose Add as library to link reference.

Open build.gradle in App-level, modify dependencies as below:

dependencies {
    ...
    implementation fileTree(include: ['*.jar', '*.aar'], dir: 'libs')
}

Please check the build.gradle to see if the .jar / .aar file show in the dependencies as the picture below:

3rd-party Library

Vpon SDK start to import 3rd-party Library - Retrofit from 4.8.0, please follow the steps below to import Retrofit:

1. Import Retrofit manually: Download Retrofit here and import the .jar file to your project.
2. Import Retrofit with Maven: Please add the snippet below to your build.gradle in App-level to import Retrofit.

dependencies {
    <!-- Import Retrofit v2.6.2 if you are using Vpon SDK v5.0.2 and above -->
    implementation 'com.squareup.retrofit2:retrofit:2.6.2'
    <!-- Import Retrofit v2.4.0 if you are using Vpon SDK v4.9.1 and below -->
    implementation 'com.squareup.retrofit2:retrofit:2.4.0'

    <!-- Import required Google Play Service -->
    implementation 'com.google.android.gms:play-services-ads-identifier:17.0.0'
    <!-- Import required dependency if you are using Vpon SDK v5.3.2 and above -->
    implementation 'com.google.android.gms:play-services-appset:16.0.0'
}

VpadnActivity

Add com.vpadn.widget.VpadnActivity to your AndroidManifest.xml.

<!-- Please add below script if you're using SDK v5.0.2 or above-->
<activity android:name="com.vpon.ads.VponAdActivity"
android:configChanges="orientation|keyboardHidden|navigation|keyboard|screenLayout|uiMode|screenSize|smallestScreenSize"
android:theme="@android:style/Theme.Translucent"
android:hardwareAccelerated="true"/>

<!-- Please add below script if you're using SDK v4.9.1 or below -->
<activity android:name="com.vpadn.widget.VpadnActivity"
android:configChanges="orientation|keyboardHidden|navigation|keyboard|screenLayout|uiMode|screenSize|smallestScreenSize"
android:theme="@android:style/Theme.Translucent"
android:hardwareAccelerated="true"/>

Note: EVERY attribute is required!

Since we started to support Video ads from Vpon SDK 4, we recommend that you can add the scripts below to your Activity which contain ads to accelerate hardward performance.

<activity
  android:name="com.vpadn.example.MainActivity"
  android:label="@string/app_name"
  android:configChanges="keyboardHidden|orientation"
  android:hardwareAccelerated="true">
  <intent-filter>
    <action android:name="android.intent.action.MAIN"/>
    <category android:name="android.intent.category.LAUNCHER"/>
  </intent-filter>
</activity>

Permission

Add permissions below to your AndroidManifest.xml.

<!-- Required Permissions -->
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

<!-- Optional Permissions. Use for optimize ad performance -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>

SDK Initialization

In order to enhance SDK performance, please follow the instruction below to initialize SDK

// Initial SDK in Application
public class CustomApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        VponMobileAds.initialize(getBaseContext());
    }
}

// Initial SDK in MainActivity
public class MainActivity extends AppCompatActivity {

    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        VponMobileAds.initialize(this);
    }
}

Proguard Configuration

If you are using Vpon Android SDK v5.0.2 or below version SDK in your app, please add the setting below in your Proguard Config:

-dontwarn c.**
-dontwarn com.vpon.**
-dontwarn vpadn.**
-keep class c.**{ *; }
-keep class com.vpon.** { *; }
-keep class vpon.** { *; }
-keep class com.vpadn.** { *; }
-keep class vpadn.** { *; }

<!-- ----------- require since 4.8.0 --------- -->
-dontnote retrofit2.Platform
-dontwarn retrofit2.Platform$Java8
-dontwarn okhttp3.internal.platform.*
-keepattributes Exceptions
-keepattributes Signature
-dontwarn okio.**
-dontwarn javax.annotation.**

Tips

For more ad types, please refer to:

• Banner Ad
• Interstitial Ad
• Native Ad
• Out-stream Video Ad
• Mediation