android添加KeyMob广告管理库中文教程

集成广告平台能够根据各个广告平台的文档进行，为了迅速快捷 的进行集成测试，咱们选择KeyMob广告管理库。KeyMob有个特色就是能够直接配置 json格式文件来设置各个广告平台的信息，很是快速便捷，也能够配合KeyMob网站来管理配置信息。广告聚合管理库能够在git上下载到。


获取Android广告管理库
要在手机应用里面展现广告须要在应用里面添加广告管理库，KeyMob广告管理库目前的版本是20150801 下载解压后能够看到android工程的目录结构，大部分常规的android工程文件和目录，下面资源是KeyMob管理库相关的。
README.md keymob 英文快速集成文档
README_zh.md keymob 中文快速集成文档

libs
okeymobad.jar keymob 广告管理核心库

assets
ocom_keymob_sdks keymob 备用平台
obiduad_plugin keymob 百度平台须要的资源
ogdt_plugin keymob 广点通平台须要的资源

注 意：assets目录下的三个文件夹以及文件夹下面的文件都不能修更名称com_keymob_sdks 目录下面有个 AdmobAdapter.jar 表示KeyMob使用admob做为没法链接KeyMob时的备用广告平台 若是想改用别的平台 能够下载更多的备用平台。除上面下载的资源外，使用KeyMob支持的平台，无需再单独添加各个平台的代码。

添加管理库到eclipse工程项目
1.复制下载到的 KeyMobad.jar 到本身android工程的libs下

2.复制下载到的 com_KeyMob_sdks 到本身android工程的assets下

3.若是要使用百度广告平台，复制下载到的 biduad_plugin 到本身android工程的assets下

4.若是要使用广点通平台，复制下载到的 gdt_plugin 到本身android工程的assets下

添加广告相关java代码
1.首先import keymob相关的类
import com.keymob.networks.AdManager;
import com.keymob.networks.core.*;
import com.keymob.sdk.core.AdTypes;

 

2.初始化KeyMob
初始化KeyMob管理库是调用其余广告功能函数的前提，必须先初始化才能作别的调用，下面初始化 KeyMob，jsonString是各个广告平台的配置信息 AdManager.getInstance().initFromJSON(active,jsonString,new AdEventListener());

参数说明
this 第一个参数active是广告上下文，非null
jsonString 第二个参数是上面的json配置字符串，包含各个广告平台的配置信息
AdEventListener 广告事件处理类，实现接口IAdEventListener，若是不计划处理广告事件能够为null

 

3.展现广告
下面把显示横幅广告在绝对位置(0,200)示例
AdManager.getInstance().showBannerABS(BannerSizes.BANNER, 0, 200);

 

参数说明
BannerSizes.BANNER 第一个参数广告尺寸，全部默认支持的广告横幅尺寸都在BannerSizes类中
"0" 第二个参数是广告的位置x
"200" 第二个参数是广告的位置y

4.添加广告权限
编辑AndroidManifest.xml 给应用添加须要的权限，例如网络请求，下面是大部分广告平台须要的权限

<!-- base permission -->
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<!-- base permission for location-->


<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> 
<!-- base permission required by chartboost and Baidu-->

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

<!-- permission required by mmedia -->

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

<uses-feature android:name="android.hardware.microphone" android:required="false" />

 

5.添加广告Activity等配置信息
编辑AndroidManifest.xml 给应用添加广告平台的Activity，未添加平台的activity将没法展现平台广告
 <meta-data android:name="com.google.android.gms.version" android:value="7327000" />

<activity android:name="com.google.android.gms.ads.AdActivity" android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize" android:theme="@android :style/Theme.Translucent"/>

    <!-- Amazon Mobile Ads -->
<activity android:name="com.amazon.device.ads.AdActivity"android:configChanges="keyboardHidden|orientation|screenSize"/>

<!-- InMobi -->

<activity android:name="com.inmobi.androidsdk.IMBrowserActivity" android:configChanges="keyboardHidden|orientation|keyboard|smallestScreenSize|screenSize" android:theme="@android :style/Theme.Translucent.NoTitleBar" android:hardwareAccelerated="true" />

<!-- Millennial Media -->
<activity android:name="com.millennialmedia.android.MMActivity"        android:theme="@android :style/Theme.Translucent.NoTitleBar" android:configChanges="keyboardHidden|orientation|keyboard|screenSize" >

</activity>

<!-- KeyMob --> 

<activity android:name="com.keymob.sdk.core.KeymobActivity" android:theme="@android :style/Theme.Dialog" android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize" 
/>

    <!-- Baidu -->
<activity android:name="com.baidu.mobads.AppActivity" android:configChanges="keyboard|keyboardHidden|orientation"/> 
<!-- adcolony --> 

<activity android:name="com.jirbo.adcolony.AdColonyOverlay" android:configChanges="keyboardHidden|orientation|screenSize" 
android:theme="@android :style/Theme.Translucent.NoTitleBar.Fullscreen" />

<activity android:name="com.jirbo.adcolony.AdColonyFullscreen" android:configChanges="keyboardHidden|orientation|screenSize" android:theme="@android:style/Theme.Black.NoTitleBar.Fullscreen" />

<activity android:name="com.jirbo.adcolony.AdColonyBrowser" android:configChanges="keyboardHidden|orientation|screenSize" 
android:theme="@android:style/Theme.Black.NoTitleBar.Fullscreen" />

<!-- guang dian tong --> 
<service android:name="com.qq.e.comm.DownloadService" android:exported="false"/>

<activity android:name="com.qq.e.ads.ADActivity" android:configChanges="keyboard|keyboardHidden|orientation|screenSize"/>