万普世纪移动营销服务平台(以下称为“万普平台”)的Android 版SDK 提供了一套现成的开发包及Demo源代码,便于开发者在Android应用中方便的集成万普平台的各项功能,包括万普统计、虚拟货币、流量交换、互动广告、推送广告、迷你广告、自定义广告等功能。
本文档描述了标准版SDK 的用途与用法,并提供了示例代码。您仅需要在现有的应用中加入少量新代码,就可以集成万普平台的各项功能,轻松获得用户量和收入的倍增。
|
加入jar包
将AppOffer_1.6.3.jar 包放入工程指定的lib目录
|
修改AndroidManifest.xml文件
⑴确保应用具有以下几项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" /> < uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> < uses-permission android:name="android.permission.GET_TASKS" /> < !--以下两个权限为可选项,用于支持特殊广告形式--> < uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT" /> < uses-permission android:name="com.android.browser.permission.WRITE_HISTORY_BOOKMARKS"/>
⑵在< application>段内添加以下内容
< activity android:name="com.waps.OffersWebView" android:configChanges="keyboardHidden|orientation"/>
< !--以下属性为应用ID,从万普后台获取--> < meta-data android:name="WAPS_ID" android:value="应用标识" /> < !--以下属性为分发渠道ID,编码表参见本文档末附表--> < meta-data android:name="WAPS_PID" android:value="分发渠道标识" />
WAPS_ID(或APP_ID)为应用标识,该值由万普平台添加应用后自动生成,点击“应用详情”获取
WAPS_PID(或APP_PID)为分发渠道标识,上传到万普平台的版本填“WAPS”,分发给其他渠道的版本填写相应值(比如“Google”)后重新打包即可;不同的分发包应填写不同的渠道标识,才能在万普统计平台区分来自不同渠道的数据。该值必须由英文字母和数字组成,不能是纯数字,不能包含空格或中文。常见WAPS_PID编码表请参见本文档附表《常用渠道标识编码表》。 开发者可以通过代码实现来替代本段设置,详见本文档第4节《自定义代码模式》 ⑶如果应用进行了混淆编译,需要在混淆的配置文件中加入以下代码,才能确保SDK功能正常使用:
-keep public class com.waps.** {*;}
-keep public interface com.waps.** {*;} |
加入接口代码
|
自定义代码模式
某些不便于在AndroidManifest内添加配置的情况下,可使用自定义代码模式取代原有的配置。原有的常规配置方式为:
< activity android:name="com.waps.OffersWebView" android:configChanges="keyboardHidden|orientation"/>
使用自定义代码模式替代以上配置的方法:
< meta-data android:name="WAPS_ID" android:value="WAPS_ID" /> < meta-data android:name="WAPS_PID" android:value="WAPS_PID" />
步骤1:自定义一个OffersWebView类的子类(类名任意指定):
public class MyAdView extends com.waps.OffersWebView { }
步骤2:在AndroidManifest内注册该子类,在< application>段内添加:
< activity android:name="MyPackage. MyAdView"
其中“MyPackage. MyAdView”值要替换为具体的包名和类名,比如“com.waps.MyAdView”
android:configChanges="keyboardHidden|orientation"/>
步骤3:使用以下方式替代AppConnect.getInstance(this)方法初始化统计器:
//AppConnect.getInstance("WAPS_ID",this); //设置WAPS_ID
此外,也可以通过另外一种在AndroidManifest文件内添加配置的方式,来替代以上步骤3的代码:
AppConnect.getInstance("WAPS_ID","WAPS_PID",this); //设置WAPS_ID和WAPS_PID //在初始化统计器的代码之后,紧接着添加以下代码 ; AppConnect.getInstance(this).setAdViewClassName("MyPackage. MyAdView");
< meta-data android:name="ADVIEW" android:value="MyPackage. MyAdView" />
注意,自定义代码模式仅用于不便于在AndroidManifest文件内添加配置的情况。上传到万普平台的版本建议不要使用该方式,不然可能无法通过万普平台的自动审核。
< meta-data android:name="APP_ID" android:value="应用标识" /> < meta-data android:name="APP_PID" android:value="分发渠道标识" /> |