Android SDK在线文档
SDK包解压后将会得到一个AdViewSample文件夹、一个libs文件夹、一个SDK指导说明文档和change log文件。
第一步、注册并获取AdView SDK
要使用AdView提供的功能,需要先注册AdView帐号,并发布应用获取SDK-KEY
第二步、在项目中集成AdView SDK
1、将从网站获取AdView SDK开发包解压,libs文件夹里包含所有广告平台的SDK
2、将libs目录下的所有文档放入到应用工程中
3、 将应用程序可能用到的所有广告商的SDK用同样的方式添加进去

注意:我们提供的SDK可以让您自由选择您喜欢的广告公司,但我们还是建议您添加我们提供的所有广告公司SDK,因为您可以在后台更自由的选择和配置。
4、如果您还没有注册这些广告平台,请先到这些广告平台注册,添加App,记下对应的 App Key,以便在AdView中绑定和设置。另外,通过AdView的绿色通道可以加快审核速度。
第三步、AndroidManifest.xml文件配置
1、增加权限代码
⑴. AdView SDK mandatory or important permissions,用户需要添加的
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
⑵.optional permissions,用户可以选择,不是必要的属性,针对某些sdk的特殊需求,可以在sample中copy
2、增加Activity声明
一些广告平台需要声明Activity,才能正常工作,在application标签中包含; 还有一些广告配置比较特殊,需要特别说明,包括AdTouch和Baidu,Wooboo, Greystripe的广告,添加的时候一定要注意看说明;所需代码可以去sample中copy。
2.1, 如果要使用Adview,必须要增加如下service定义:
<service android:name="com.kyview.DownloadService" />
2.2, 如果想显示多盟广告,需要增加如下activity定义:
<activity android:name="cn.domob.android.ads.DomobActivity" android:theme = "@android:style/Theme.Translucent" />
其他广告平台可参考sample
第四步、嵌入广告位
AdView支持code和xml两种布局方式,方法如下:
1、使用xml布局嵌入广告
⑴. 在布局文件中指定广告位Layout
<?xml version=”1.0″ encoding=”utf-8″?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
/>
<TextView
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="@string/hello"
/>
<LinearLayout
android:id="@+id/adLayout"
android:layout_width="fill_parent"
android:layout_height="wrap_content" />
</LinearLayout>
⑵. 在Activity中的onCreate方法中添加如下代码,并替换为在AdView上申请的SDK-KEY
LinearLayout layout = (LinearLayout)findViewById(R.id.adLayout);
if (layout == null)
return;
/*下面两行只用于测试,完成后一定要去掉,参考文挡说明*/
AdViewTargeting.setUpdateMode(UpdateMode.EVERYTIME); //保证每次都从服务器取配置
AdViewTargeting.setRunMode(RunMode.NORMAL); //保证所有选中的广告公司都为测试状态
/*下面这句方便开发者进行发布渠道统计,详细调用可以参考java doc */
//AdViewTargeting.setChannel(Channel.GOOGLEMARKET);
AdViewLayout adViewLayout = new AdViewLayout(this, "adview sdk key");
adViewLayout.setAdViewInterface(this);
layout.addView(adViewLayout);
layout.invalidate();
2、使用code嵌入广告
LinearLayout layout = new LinearLayout(this);
LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(
LinearLayout.LayoutParams.WRAP_CONTENT,
LinearLayout.LayoutParams.WRAP_CONTENT);
……
layout.addView(adViewLayout,params);
addContentView(layout);
注意事项:
⑴. AdViewTargeting.setRunMode(RunMode.TEST)功能为您提供调试状态,当为true您的所有的广告都和广告公司之间处与测试状态,当完成后,一定要去掉这句话,因为系统默认为非测试状态。
⑵. AdViewTargeting.setUpdateMode(UpdateMode.EVERYTIME)功能为每次都从服务器获取最新的设置,方便您的调试,当调试结束后,一定要去掉这句话,因为系统已经为您优化成最佳时间,同时不影响应用本身的性能。
⑶. 通过adViewLayout.setAdViewInterface用户可以监听广告显示(onDisplayAd)和用户点击事件(onClickAd)。