Adding Kii Ads SDK to your Application

Kii Advertising SDK gives you the ability to add multiple advertising networks with only a few lines of client code. Ad networks are managed in real-time from the developer portal, so changing ad networks , adding new ones and balancing the distribution of ads among networks no longer requires you to update your client-side code.

Configuring Ads Service on the Developer Portal

To be able to use ads mediation and direct ads functionality with our SDKs, you need to first configure the Ad service for your application on the Developer Portal. If you haven't created an application yet, please create an application on the developer portal as explained in "Adding Kii Cloud SDK to your Application".

Enabling Ads

  • Click on your application name in the left hand navigation of the Developer Portal -- and select Ads.
  • Select the "Config" tab.
  • Set the toggle switch UI to "On" to enable ads.

Configuring Regions

Kii Ad Network offers you the ability to configure ad network selection based on the region the app user is from. For instance, an app developer might want to serve ads from SmartMAD ad network for app users in China but use AdMob or Direct Ads (or a combination of those) for app users in USA. The following steps will show you how to set this up.

  • You will notice that by default a region called "default" has already been created for you. The Default region configuration is used when our Ads system can't find any specific regional configuration to apply for a given instance. For example, if the app user is from South Korea and there is no "South Korea" region set up then the configuration in Default is used.
  • If you want to create a region (say "China) click on the "+ (plus)" button, select Country and press the "Create Region" button.

  • Once you have Regions configured, you can edit and toggle them off as well.

Configuring Networks

Within each region, you can select one or more ad networks. For each network you add, you will have to configure additional settings depending on the network.

  • To add a network, click on the "+ (plus)" button.

  • Afterwards select the ad network from the list of supported networks and then provide additional settings relevant to the network. For instance, for AdMob, you will have to enter your AdMob Publisher Key.

  • The "Site->" button enables you to go to the ad network's website to sign-up and go through additional configuration steps on the ad network site.

  • For Direct selling, you are taken to the amobee site which requires your login info (as described in the "Enabling Ads" section above).

  • Once your ad networks are enabled, you can set the weight (percentage of ads delivered through the network) for each ad network by configuring the slider.

Configuring your Project

Follow the steps below to enable Kii Ads in your application.

Add to your Project

  1. Add the following permission to AndroidManifest.xml:

    <uses-permission android:name="android.permission.INTERNET" />
    
  2. Add KiiAdNetSDK_Android_1.0.0.jar to "libs" folder.

  3. If you want to use KiiAdNetSDK with proguard, please add the following settings to your proguard-project.txt or proguard.cfg.

    -dontwarn com.kii.ad.adapters.* 
    
    -keep class com.kii.ad.adapters.* {
        public *;
    }
    

Adding Ad Networks

AdMob

  1. Add GoogleAdMobAdsSdk-4.3.1.jar to your "libs" folder.

  2. Add the following permission to AndroidManifest.xml.

    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    
  3. Change the target version to Android 3.2 or above.

  4. Add the following activity info to AndroidManifest.xml.

    <activity android:name="com.google.ads.AdActivity"
              android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize">
    

MdotM

  1. Add MdotM-Android-SDK-2.0.6.jar to your "libs" folder.

SmartMAD

  1. Add smartmad-sdk-android.jar to your "libs" folder.

  2. Add the following permission to AndroidManifest.xml

    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    

Millenial Media

  1. Add MMAdView.jar to your "libs" folder.

  2. Add the following permissions to AndroidManifest.xml

    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="android:permission.ACCESS_NETWORK_STATE" />
    
  3. Add the following activity info to AndroidManifest.xml

    <activity android:name="com.millennialmedia.android.MMAdViewOverlayActivity"
            android:theme="@android:style/Theme.Translucent.NoTitleBar"
            android:configChanges="keyboardHidden|orientation|keyboard"/>
    
    <activity android:name="com.millennialmedia.android.VideoPlayer"
           android:configChanges="keyboardHidden|orientation|keyboard"/>
    

InMobi

  1. Add InMobiAndroidSDK.jar to your "libs" folder.

  2. Add the following activity info to AndroidManifest.xml

    <activity android:name="com.inmobi.androidsdk.IMBrowserActivity"
            android:configChanges="keyboardHidden|orientation|keyboard"/>
    

Leadbolt

  • No specific configuration needed.  Kii Cloud will start distributing ads as soon as your application is validated.

AMoAd

  • No specific configuration needed.  Kii Cloud will start distributing ads as soon as your application is validated.