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()这个方法,在使用点金,万普平台的时候必须使用,其他平台可以选择性的使用

反馈