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)。

反馈