WAPS_ANDROID开发者手册_正式版.doc

万普平台android版sdk开发者手册(ver1.5.3)平台介绍万普世纪移动营销服务平台(以下称为“万普平台”)的android 版sdk 提供了一套现成的开发包及demo源代码，便于开发者在android应用中方便的集成万普平台的各项功能，包括万普统计、虚拟货币、流量交换、互动广告、推送广告等功能。本文档描述了标准版sdk 的用途与用法，并提供了示例代码。您仅需要在现有的应用中加入少量新代码，就可以集成万普平台的各项功能，轻松获得用户量和收入的倍增。使用步骤1.加入jar包将appoffer_1.5.3.jar 包放入工程指定的lib目录2.修改androidmanifest.xml文件确保应用具有以下几项permission权限：在段内添加以下内容：waps_id为应用标识，该值由万普平台添加应用后自动生成，点击“应用详情”获取；waps_pid为分发渠道标识，上传到万普平台的版本填“waps”，分发给其他的版本填写相应值（比如“google”）后重新打包即可；不同的分发包应填写不同的渠道标识，才能在万普统计平台区分来自不同渠道的数据。该值必须由英文字母和数字组成，不能是纯数字，不能包含空格或中文。常见waps_pid编码表请参见后续文档。3.加入接口代码1.数据统计接口该接口是所有其他接口能正常使用的基础，在每次应用启动时，必须调用该接口，才能保证获得准确的统计数据。步骤 1:在的应用中第一个activity类中(启动的第一个类),添加下面一行代码:appconnect.getinstance(this);步骤 2:在程序退出的处理方法中, 添加下面一行代码:appconnect.getinstance(this).finalize();2.虚拟货币接口在应用中合理设置虚拟货币及消费机制，可促进用户参与应用内购买或参与广告活动，增强应用粘性，大幅提升收益。如果您的应用开启了虚拟货币功能，需要使用该接口和服务器同步用户的虚拟货币余额。获取用户虚拟货币步骤 1: 从服务器端获取用户点数/虚拟货币余额:appconnect.getinstance(this).getpoints(this);步骤 2: 确保在this类中实现 updatepointsnotifier接口，实现下面的两个方法用来接收来自服务器的响应:public void getupdatepoints(string currencyname, int pointtotal);/获取成功public void getupdatepointsfailed(string error);/获取失败花费用户虚拟货币花费（扣除）用户的虚拟货币接口:appconnect.getinstance(this).spendpoints(int amount, this);调用此方法的响应结果将通过this中实现的updatepointsnotifier接口返回奖励用户虚拟货币授予（增加）用户虚拟货币的接口:appconnect.getinstance(this).awardpoints(int amount, this);调用此方法的响应结果将通过this中实现的updatepointsnotifier接口返回;注意，所有通过万普推荐列表、互动广告、推送广告获得的虚拟货币将自动给予到用户，无需调用该接口。该接口仅用于用户完成了开发者指定的其他任务的情况下额外给予用户虚拟货币。开发者可通过管理后台禁用该接口。3.推荐列表接口推荐列表（也称offer，广告墙）是万普平台提供的一种集中展示型广告。开发者可在应用中合适的位置加入“推荐应用”、 “免费赚积分”等类似字样的功能，获取更高的广告收益或参与流量交换。添加如下代码，即可显示万普平台推荐应用列表：appconnect.getinstance(this).showoffers(this);4.互动广告接口互动广告是一个显示在应用内固定位置高度为50像素广告条，将自动显示万普平台提供的广告。结合虚拟货币功能使用，可获得最佳的广告效果和用户体验。步骤 1: 复制如下代码到相应activiy的layout文件中,并放置在合适的位置: 步骤 2: 在调用样式文件的activity类中, 添加下面的代码:linearlayout container =(linearlayout)findviewbyid(r.id.adlinearlayout);new adview(this,container).displayad(20);/每20秒轮换一次广告；最少为205.推送广告接口推送广告是一种在android手机通知栏显示的新型广告形式。其特点是不占用广告位，广告播放时有提示音，广告点击率超高(平均ctr超过20%)，极少误点击，不费用户流量，用户体验更好，比传统的广告形式收入有大幅提升。万普推送广告采用了纯绿色推送模式，只在应用开启时才接收广告；其广告内容和计费方式和原有互动广告一致，cpa和cpc两种模式并存，用户通过推送广告下载应用同样能获得虚拟货币。推送广告分为自动和手动调用两种模式，默认为自动播放模式；开发者可通过万普管理平台的“广告设置”随时开启和关闭自动推送广告，设置推送广告播放频度和延时等参数。开发者也可通过手动调用api获取推送广告。优化广告显示样式将sdk自带的demo工程中的layout/push_layout.xml文件拷贝到当前工程的layout目录下即可使用优化的推送广告样式，在广告中显示图标；使用优化样式可增加广告点击率。自定义图标和声音开发者可自定义通知栏图标；res_id参数为图标的resourceid的值；例如res_id设置为r.drawable.icon值，可使用当前应用的icon作为通知栏图标。appconnect.getinstance(this).setpushicon(int res_id); 开发者可自定义推送广告是否播放提示音；on_off参数设置true开启，false则关闭。appconnect.getinstance(this).setpushaudio(boolean on_off);手动获取推送广告手动获取一条新的推送广告。该方法会立即获取一条推送广告，不会显示自定义通知，不受频度控制设置影响；开发者也可通过管理后台“广告设置”随时关闭该接口。appconnect.getinstance(this).getpushad(); 6.其他常用接口用户反馈接口在应用内增加用户反馈功能可收集用户意见反馈，便于改进用户体验；开发者可通过管理后台查看用户的反馈信息。添加以下代码收集用户反馈：appconnect.getinstance(this).showfeedback();自家应用列表自家应用列表可采用类似推荐列表的形式，列出将开发者自己在万普平台发布的所有应用供用户下载，便于开发者自家应用之间相互推荐。添加以下代码显示开发者自家应用列表：appconnect.getinstance(this).showmore(this);代码添加waps_idappconnect.getinstance(your_ waps_id,this);该接口仅用于无法在androidmanifest.xml文件内配置waps_id的情况，可使用该方法替代appconnect.getinstance(this)方法初始化统计器。正常情况下，建议通过androidmanifest文件配置waps_id，不推荐使用该方法。常用渠道标识编码表对用于每个分发渠道的安装包设置一个不同的waps_pid（渠道标识），可便于统计各渠道的用户数。万普平台的广告将针对各种主流分发渠道进行优化，在分发包内使用正确的指定渠道标识，可获得更好的推广效果；如果未设置正确的渠道标识，可能会导致无法通过部分应用商店的审核。waps_pid渠道名称waps_pid渠道名称waps万普平台(默认)qq腾讯应用googlegoogle电子市场3g3g安卓市场9191手机助手waptw天网下载hiapk安卓市场paojiao泡椒网gfan机锋市场baoruan宝软网appchina掌上应用汇feiliu飞流下载eoe优亿市场digua地瓜游戏mumayi木蚂蚁市场neng能助手anfone安丰下载samsung 三星乐园aimi爱米商店coolmart 酷派市场iandroid爱卓市场meizu魅族市场star安卓星空huawei华为智慧云nduoan多市场motor