WAPS_Android开发者手册_正式版_1.6.4

万普平台Android版SDK开发者手册(Ver1.6.4)平台简介万普世纪移动营销服务平台(以下称为“万普平台”)的Android版SDK提供了一套现成的开发包及Demo源代码，便于开发者在Android应用中方便的集成万普平台的各项功能，包括万普统计、虚拟货币、流量交换、互动广告、推送广告、迷你广告、自定义广告等功能。本文档描述了标准版SDK的用途与用法，并提供了示例代码。您仅需要在现有的应用中加入少量新代码，就可以集成万普平台的各项功能，轻松获得用户量和收入的倍增。使用步骤1.加入jar包将AppOffer_1.6.4.jar包放入工程指定的lib目录2.修改AndroidManifest.xml文件⑴确保应用具有以下几项Permission权限：uses-permissionandroid:name=android.permission.INTERNET/uses-permissionandroid:name=android.permission.ACCESS_NETWORK_STATE/uses-permissionandroid:name=android.permission.ACCESS_WIFI_STATE/uses-permissionandroid:name=android.permission.READ_PHONE_STATE/uses-permissionandroid:name=android.permission.WRITE_EXTERNAL_STORAGE/uses-permissionandroid:name=android.permission.GET_TASKS/!--以下两个权限为可选项，用于支持特殊广告形式--uses-permissionandroid:name=com.android.launcher.permission.INSTALL_SHORTCUT/uses-permissionandroid:name=com.android.browser.permission.WRITE_HISTORY_BOOKMARKS/⑵在application段内添加以下内容：activityandroid:name=com.waps.OffersWebViewandroid:configChanges=keyboardHidden|orientation/!--以下属性为应用ID,从万普后台获取--meta-dataandroid:name=WAPS_IDandroid:value=应用标识/!--以下属性为分发渠道ID,编码表参见本文档末附表--meta-dataandroid:name=WAPS_PIDandroid:value=分发渠道标识/WAPS_ID（或APP_ID）为应用标识，该值由万普平台添加应用后自动生成，点击“应用详情”获取WAPS_PID(或APP_PID)为分发渠道标识，上传到万普平台的版本填“WAPS”，分发给其他渠道的版本填写相应值（比如“Google”）后重新打包即可；不同的分发包应填写不同的渠道标识，才能在万普统计平台区分来自不同渠道的数据。该值必须由英文字母和数字组成，不能是纯数字，不能包含空格或中文。常见WAPS_PID编码表请参见本文档附表《常用渠道编码表》。开发者可以通过代码实现来替代本段设置，详见本文档第4节《自定义代码模式》⑶如果应用进行了混淆编译，需要在混淆的配置文件中加入以下代码，才能确保SDK功能正常使用：-keeppublicclasscom.waps.**{*;}-keeppublicinterfacecom.waps.**{*;}3.接口代码（一）数据统计接口该接口是所有其他接口能正常使用的基础，在每次应用启动时，必须调用该接口，才能保证获得准确的统计数据。步骤1:在的应用中第一个Activity类中(启动的第一个类),添加下面一行代码://方式①：通过AndroidManifest文件读取WAPS_ID和WAPS_PIDAppConnect.getInstance(this);//必须确保AndroidManifest文件内配置了WAPS_ID//方式②：通过代码设置WAPS_ID和WAPS_PIDAppConnect.getInstance(WAPS_ID,WAPS_PID,this);步骤2:在程序退出的处理方法中,添加下面一行代码://以下方法将用于释放SDK占用的系统资源AppConnect.getInstance(this).finalize();（二）虚拟货币接口在应用中合理设置虚拟货币及消费机制，可促进用户参与应用内购买或参与广告活动，增强应用粘性，大幅提升收益。如果您的应用开启了虚拟货币功能，需要使用该接口和服务器同步用户的虚拟货币余额。⑴获取用户虚拟货币步骤1:从服务器端获取用户点数/虚拟货币余额:AppConnect.getInstance(this).getPoints(this);步骤2:确保在this类中实现UpdatePointsNotifier接口，实现下面的两个方法，用于异步接收服务器返回的结果:publicvoidgetUpdatePoints(StringcurrencyName,intpointTotal);//获取成功publicvoidgetUpdatePointsFailed(Stringerror);//获取失败⑵花费用户虚拟货币花费（扣除）用户的虚拟货币接口:AppConnect.getInstance(this).spendPoints(intamount,this);调用此方法的响应结果将通过this中实现的UpdatePointsNotifier接口返回⑶奖励用户虚拟货币授予（增加）用户虚拟货币的接口:AppConnect.getInstance(this).awardPoints(intamount,this);调用此方法的响应结果将通过this中实现的UpdatePointsNotifier接口返回注意，所有通过万普广告获得的虚拟货币将自动给予到用户，无需调用该接口。该接口仅用于用户完成了开发者指定的其他任务的情况下额外给予用户虚拟货币。开发者可通过管理后台禁用该接口。（三）推荐列表接口推荐列表（也称Offer，广告墙）是万普平台提供的一种集中展示型广告。开发者可在应用中合适的位置加入“推荐应用”、“免费赚积分”等类似字样的功能，获取更高的广告收益或参与流量交换。添加如下代码，即可显示万普平台推荐应用列表：AppConnect.getInstance(this).showOffers(this);提示：开发者可通过万普后台的【广告设置】功能，手动设置推荐列表的显示样式和广告内容。（四）互动广告接口互动广告是一个显示在应用内固定位置高度为50像素广告条，将自动显示万普平台提供的广告。结合虚拟货币功能使用，可获得最佳的广告效果和用户体验。步骤1:复制如下代码到相应Activiy的Layout文件中,并放置在合适的位置:LinearLayoutandroid:id=@+id/AdLinearLayoutandroid:layout_width=fill_parentandroid:layout_height=wrap_contentandroid:gravity=center_horizontal/步骤2:在调用样式文件的Activity类中,添加下面的代码:LinearLayoutcontainer=(LinearLayout)findViewById(R.id.AdLinearLayout);newAdView(this,container).DisplayAd();（五）推送广告接口推送广告是一种在Android手机通知栏显示的新型广告形式。其特点是不占用广告位，广告点击率高，极少误点击，不费用户流量，比传统的广告形式收入有大幅提升。万普推送广告采用了纯绿色推送模式，只在应用开启时才接收广告；用户通过推送广告下载应用同样能获得虚拟货币。推送广告分为自动和手动调用两种模式；开发者可通过万普管理平台的“广告设置”随时开启和关闭自动推送广告，设置推送广告播放频度和延时等参数。开发者也可通过手动调用API获取推送广告。⑴手动获取推送广告开发者可通过API手动获取一条推送广告：AppConnect.getInstance(this).getPushAd();该接口限制每个应用2小时内最多调用一次，凌晨0:00-7:00期间禁止调用；开发者也可通过管理后台“广告设置”随时关闭该接口。⑵自定义广告图标和提示音//自定义通知栏图标；res_id参数为图标的ResourceId的值//例如res_id设置为R.drawable.icon值，可使用当前应用的Icon作为通知栏图标AppConnect.getInstance(this).setPushIcon(intres_id);//自定义推送广告是否播放提示音；on_off参数设置true开启，默认false为关闭AppConnect.getInstance(this).setPushAudio(booleanon_off);⑶自定义通知栏广告样式将SDK自带的demo工程中的layout/push_layout.xml文件拷贝到当前工程的layout目录下即可使用自定义广告样式（如果未指定该文件则使用默认的广告样式）；开发者可以通过修改该文件来实现任意的自定义推送广告样式。（六）迷你广告接口迷你广告是一种新的广告形式，每个广告由一个微缩图标和文字链组成，高度仅为24像素，文字颜色、背景颜色及透明度可自定义，特别适用于广告位空间有限的游戏类应用。和传统的Banner大广告条相比，迷你广告采用了流量压缩和本地缓存方式轮换广告，不仅省广告位，而且非常省流量，广告轮换频率更高，相比传统Banner广告条有更高的收益。步骤1:复制如下代码到相应Activiy的Layout文件中,并放置在合适的位置:LinearLayoutandroid:id=@+id/miniAdLinearLayoutandroid:layout_width=wrap_contentandroid:layout_height=wrap_contentandroid:gravity=center_horizontal/步骤2:在调用样式文件的Activity类中,添加下面的代码://设置迷你广告背景颜色AppConnect.getInstance(this).setAdBackColor(Color.argb(50,120,240,120));//设置迷你广告广告语颜色AppConnect.getInstance(this).setAdForeColor(Color.YELLOW);//若未设置以上两个颜色，则默认为黑底白字LinearLayoutminiLayout=(LinearLayout)findViewById(R.id.miniAdLinearLayout);newMiniAdView(this,miniLayout).DisplayAd(10);//默认10秒切换一次广告（七）自定义广告接口开发者可通过自定义广告广告接口获取所有可用广告的元数据，自定义广告的展现方式，便于让广告内容完全和您的应用UI融合，可显著提升广告效果。⑴初始化（预先加载）广告数据AppConnect.getInstance(this).initAdInfo();说明：该接口将在首次调用时，需要预先将所有可用广告的元数据（通常20条左右）全部获取到手机内存，便于程序随时快速调用。广告数据首次加载时间视网络情况决定，通常需要花几秒钟时间，因此，如果应用内需要使用自定义广告功能，建议在程序启动后，尽早先调用initAdInfo()方法预先异步加载一次元数据，便于后续调用getAdInfo()或getAdInfoList()