Android AdWall SDK在线文档
SDK包解压后将会得到一个Sample文件夹、一个libs文件夹、一个SDK指导说明文档和change log和README文件。
第一步、注册并获取SDK
1、访问AdAdWall 网站http://www.adview.cn 注册AdView 帐号。
2、登录后在“我的产品”页面选择“发布应用”。
3、应用平台选择“Android”,根据提示完成相关信息,在“广告优化”里边您将获取唯一的SDK key。

4、进入主页,然后点击下载,最后点击立即下载,能获取AdView广告墙SDK包,包括文档和sample。
第二步、添加SDK
1、下载的AdWallSDK_Android.zip包里包括AdWall_AndroidSDK.jar包和安装, libs文件夹里包含所有广告平台的SDK。
(README.txt中有每个jar对应的广告平台的说明,必须使用AdView例子中提供的各个广告平台的SDK,否则将导致广告不能展示)
2、将AdViewAdWallSDK_Android.jar放入到您的应用得工程中。
3、将应用程序可能用到的所有广告商的SDK用同样的方式添加进去。

注意:我们提供的SDK可以让您自由选择您喜欢的广告公司,但我们还是建议您添加我们提供的所有广告公司SDK,因为您可以在后台更自由的选择和配置。
4、如果您还没有注册这些广告平台,请先到这些广告平台注册,添加App,记下对应的 App Key,以便在AdView中绑定和设置。记住,通过AdView的绿色通道可以加快审核速度。
5、如果你是一个新手,对广告平台不怎么了解,也不知道选择哪家广告平台,或者不知道哪家广告平台收入稳定,没关系,AdView 客服全程为您服务。企业QQ 4000131400,详细联系方式请查看README.txt文件。
第三步、AndroidManifest.xml文件配置
1、增加权限代码
(下面代码可以去sample中copy)
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
2、增加Activity声明
2.1, 如果想显示百度推荐墙广告,需要增加如下activity定义:
---注册百度 推荐墙OffersActivity---
<activity android:name="com.baidu.mobads.appoffers.OffersActivity" android:configChanges="keyboard|keyboardHidden|orientation" />
2.2, 如果想显示点金推荐墙广告,需要增加如下activity定义:
注意:点金的下载service的action动作必须要添加自己应用的包名。
---注册点金 OffersActivity---
<activity android:name="com.nd.dianjin.activity.OfferAppActivity" android:configChanges="keyboardHidden|orientation" android:launchMode="singleTask" />
<activity android:name="com.nd.dianjin.activity.DownloadManagerActivity" android:configChanges="keyboardHidden|orientation" android:launchMode="singleTop" />
<android:name="com.nd.dianjin.activity.DetailActivity" android:configChanges="keyboardHidden|orientation" android:launchMode="singleTop" android:theme="@android:style/Theme.Black.NoTitleBar" />
<android:name="com.nd.dianjin.activity.DetailActivity" android:configChanges="keyboardHidden|orientation" android:launchMode="singleTop" android:theme="@android:style/Theme.Black.NoTitleBar" />
<service android:name="com.nd.dianjin.appdownload.DownloadService" >
<intent-filter>
<action android:name="com.adview.adwall"/>
---action中的android:name请输入应用的包名---
</intent-filter>
</service>
<service android:name="com.nd.dianjin.service.PackageChangedService" />
</service>
2.3, 如果想显示米迪积分墙广告,需要增加如下activity定义:
---显示米迪应用列表和详细信息(必须)---
<activity android:name="net.miidi.ad.wall.AdWallActivity" android:configChanges="keyboardHidden|orientation" />
2.4, 显示waps应用列表和详细信息(必须):
<activity android:name="com.waps.OffersWebView" android:configChanges="keyboardHidden|orientation" />
<activity android:name="com.adview.adwall.adapters.WapsAdView" android:configChanges="keyboardHidden|orientation" />
2.5, 显示易积分应用列表和详细信息(必须):
<activity android:name="com.yjfsdk.sdk.show.ShowWallActivity" />
<activity android:name="com.yjfsdk.sdk.show.DetailActivity" />
<activity android:name="com.yjfsdk.sdk.show.CheckActivity" />
<provider android:name="com.yjfsdk.sdk.provider.SaveProvider" android:authorities="3801.saveProvider" />
<meta-data android:name="YJF_APP_ID" android:value="3801" />
<meta-data android:name="YJF_APP_KEY" android:value="EMH7KGEBFE4OAOCBBGAJYAX2RDV478L0EQ" />
<meta-data android:name="YJF_DEV_ID" android:value="1136" />
<meta-data android:name="YJF_APP_CHANNEL" android:value="sdk 2.0.2" />
---渠道号 AdView---
<meta-data android:name="YJF_APP_CHANNEL" android:value="AdView" />
2.6, 显示zhidian应用列表和详细信息(必须):
<activity android:name="com.adzhidian.view.WebViewActivity" android:label="" android:configChanges="keyboardHidden|orientation" />
<receiver android:label="NetWorkReceiver" android:name="com.adzhidian.receiver.NetCheckReceiver">
<intent-filter>
<action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
<action android:name="com.adzhidian.receiver.NetCheckReceiver" />
</intent-filter>
</receiver>
2.7, 注册力美显示积分墙Activity:
<activity android:name="com.adview.adwall.adapters.AdwallActivity" android:configChanges="orientation|keyboardHidden" />
<service android:name="cn.immob.sdk.net.DownloadService" />
<receiver android:name="cn.immob.sdk.brocastreceiver.AppChangeBrocastreceiver" />
<intent-filter>
<action android:name="android.intent.action.BOOT_COMPLETED" />
<action android:name="android.intent.action.PACKAGE_ADDED" />
<data android:scheme="package" />
</intent-filter>
</receiver>
第四步、有积分接口说明
1、初始化:
在设置积分的Activity 的onCreate 函数中调用初始化。该方法确保调用至少一次。
AdViewOffer adViewOffer=new AdViewOffer(this,”SDK20121503031239j94cr27ahhgfn89”);
2、虚拟货币的使用方法:
⑴.积分更新接口AdViewOfferPoint.
首先在设置积分的activity实现这个接口,如下:
Public class Invoker extends Activity implements AdViewOfferPoint
其次添加一个监听器AdViewOfferManager.setInterface(this); 必须实现的
最后在回调方法中,更新UI。
@override Public void updatePoint(float totalMoney) { textview.setText(“您当前的积分为”+totalMoney); }
⑵.显示积分墙:
注释:View arg1参数可自定义,可以自定义view传入,如果使用默认界面则传null(需导入AdView Sample中drawable文件夹里的back_btn_click.xml文件;图片btn_clicked.png,btn_normal.png和adview_singleview_bg2.9.png;values文件夹中的style.xml文件); 自定义样式如果需要获取广告列表信息,可调用adviewoffer.getAdList(AdViewOffer adViewOffer),返回List<Ration> int arg2传入自定义dialog样式,如果使用默认则传 0; String arg4将会显示在dialog的标题位置; String arg5将会显示为每个广告墙的名称;
⑶.显示积分墙:
AdViewOffer.showOffer(Invoker.this);
⑷.查看积分:
AdViewOfferManager.getPoints(Invoker.this);
⑸.奖励积分:
AdViewOfferManager.addPoints(i,Invoker.this);
⑹.消费积分:
AdViewOfferManager.spendPoints(j,Invoker.this);
⑺.刷新积分:
adViewOffer.requestPoints();
3、指定应用渠道:
开发者在AndroidManifest文件中加
<meta-data android:name="AdView_CHANNEL" android:value="GFAN"></meta-data>
可以配置渠道; 目前adview支持的渠道如下:
EOE(优亿市场)
GOOGLEMARKET(谷歌电子市场)
APPCHINA(应用汇)
HIAPK(安卓市场)
GFAN(机锋)
GOAPK(安智)
NDUOA(N多网)
91Store(手机91)
LIQUCN(历趣)
ANDROIDAI(安卓之家)
ANDROIDD(安致)
YINGYONGSO(应用搜)
IMOBILE(手机之家)
MUMAYI(木蚂蚁)
PAOJIAO(泡椒网)
AIBALA(爱扒拉市场)
COOLAPK(酷安网)
ANFONE(安丰)
APKOK(乐致网)
360MARKET(360市场)
如果不配置,或配置其他的值,一律作为"OTHER"处理; 在移动广告观察(http://t.adview.cn/)中有各个市场的链接。
第五步、无积分接口说明
1、初始化:
在设置积分的Activity的onCreate函数中调用初始化。该方法确保调用至少一次。
AdViewOfferadViewOffer=new AdViewOffer(this,”SDK20121503031239j94cr27ahhgfn89”);
2、显示积分墙:
⑴.显示推荐墙:
AdViewOffer.showOffer(Invoker.this);
⑵.显示推荐墙列表:
AdViewOffer.showOfferList(Invoker.this, View arg1, int arg2, AdViewOffer arg3, String arg4, String arg5);
注释:View arg1参数可自定义,可以自定义view传入,如果使用默认界面则传null(需导入AdView Sample中drawable文件夹里的back_btn_click.xml文件;图片btn_clicked.png,btn_normal.png和adview_singleview_bg2.9.png;values文件夹中的style.xml文件); 自定义样式如果需要获取广告列表信息,可调用adviewoffer.getAdList(AdViewOffer adViewOffer),返回List<Ration> int arg2传入自定义dialog样式,如果使用默认则传 0; String arg4将会显示在dialog的标题位置; String arg5将会显示为每个广告墙的名称;
3、释放平台的资源:
点金的adViewOffer.recycling_Resources();易积分YjfSDK.getInstance(mContext, this).recordAppClose(); 百度是平台管理不需要自管理。
第六步、混淆说明
1、在ADT新版中混淆方法如下(可参考无积分【SDK】):
在project.properties里的target=android-15下面添加
proguard.config=$
{sdk.dir
}/tools/proguard/proguard-android.txt:proguard-project.txt
proguard-project.txt中添加-libraryjars /libs/AdWallSDK_AndroidNo.jar -keep public class com.adview.adwall** {*;} -keepclassmembers class * {public *;} -keep public class * {public *;} -dontwarn com.nd.dianjin.** -keep public class com.nd.dianjin.** -keep public class com.nd.dianjin.** { *; } -keep class com.baidu.mobads.**{ public protected *; } -dontwarn com.adview.adwall.adapters.BaiduAdapter -keep class com.adview.adwall.adapters.BaiduAdapter.*{ *;}
2、老版本ADT混淆方法(可参考有积分【SDK】):
AdView是动态调用,不必对其进行混淆,广告公司代码基本已经独立混淆过,如果应用自己代码需要混淆,可以在文件proguard.cfg开头如下增加,如果在libs里有如下文件请注意: android-support-v4.jar。需要添加混淆文件(混淆代码下面) 详情可参考(下面的代码):
-dontwarn -libraryjars /libs/AdWallSDK_Android.jar -keep public class com.adview.adwall** {*;} -keepclassmembers class * {public *;} -dontwarn com.nd.dianjin.** -keep public class com.nd.dianjin.** -keep public class com.nd.dianjin.** { *; } -dontwarn cn.immob.sdk.** -keep class com.baidu.mobads.**{ public protected *; } -optimizationpasses 5 -dontusemixedcaseclassnames -dontskipnonpubliclibraryclasses -dontpreverify -verbose
如果在libs里有如下文件请注意: android-support-v4.jar。需要添加混淆文件
-libraryjars libs/android-support-v4.jar -dontwarn android.support.v4.** -keep class android.support.v4.** { *; } -keep interface android.support.v4.app.** { *; } -keep public class * extends android.support.v4.** -keep public class * extends android.app.Fragment
目前AdViewAdWall SDK混淆支持proguard4.6以上的版本,开发者可以去proguard官方网站http://sourceforge.net/projects/proguard/files/proguard/下载4.6或以上版本; 如果要升级的话,用下载的版本直接替换掉“android-sdk-windows\tools\proguard”就可以了。
第七步、对于onDestroy 的使用
对于recycling_Resources()这个方法,在使用点金,万普平台的时候必须使用,其他平台可以选择性的使用