6.4.4 查询积分接口 ................................................................................................... 10 6.4.5 消费积分验证接口 ........................................................................................... 10 6.4.6 手动推送广告接口 ........................................................................................... 11 6.5代码混淆说明 ........................................................................................................... 11 七发布应用 .................................................................................................................... 12 八FAQ ............................................................................................................................. 12 易积分平台Android版广告植入开发手册 Copyright??2012 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司 版权所有 Page 3 一概述 本文档旨在帮助Android开发者快速掌握使用易积分平台SDK进行广告植入开发。
同时假定开发者熟悉Android开发流程。
易积分平台是一个激励型效果营销平台开发者主要通过以下两条途径获取积分 一、开发者在应用中植入易积分广告墙或使用推送广告用户下载推荐的应用并激活用户和开发者同时获得积分 二、开发者制定积分交易规则用户在应用中消费积分开发者也可以获得积分。
积分可以兑换现金从而为开发者提供了有效的盈利手段。
本文档描述了通过易积分SDK 植入易积分广告的开发流程并提供了完整的示例代码。
开发者仅需要在应用中加入少量代码即可轻松植入易积分广告。
二广告形式 2.1 广告墙 易积分“广告墙”是在开发者应用内展示优质手机应用产品以供用户下载安装的页面。
开发者可在应用中适当的位置加入“
精品推荐”、 “免费赚积分”等类似的功能作为广告墙的入口用户下载安装并激活广告墙上的应用后开发者即可获得收入。
2.2 推送广告 推送广告是一种显示在Android手机通知栏的新型广告形式。
其特点是不占用广告位广告点击率高极少误点击节省用户上网流量相比传统的广告形式收入有大幅提升。
推送广告采用纯绿色推送模式只在应用开启时才接收广告。
用户通过推送广告下载应用同样能获得积分。
推送广告分为自动推送和手动调用两种模式。
开发者可通过易积分管理中心的“应用列表”随时开启和关闭自动推送广告。
也可通过手动调用接口获取手动推送广告。
2.2.1 自动推送 自动推送广告是在开发者应用开启后由平台每隔一段时间向用户发送一条推送广告。
该广告将显示在手机通知栏里。
开发者可在易积分管理中心的“应用列表”页面随时开启或关闭自动推送广告。
易积分平台Android版广告植入开发手册 Copyright??2012 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司 版权所有 Page 4 2.2.2 手动推送 手动推送广告是由开发者手动获取推送广告的推送形式与自动推送广告的区别在于开发者可在应用中自行控制接收推送广告的位置例如在应用的载入页面获取一条推送广告。
开发者手动调用推送广告接口获取推送广告的方法详见5.4.6 手动推送广告接口。
三广告墙样式展示 “广告墙界面是红色的可我的应用界面是以灰色为主的从应用进入到广告墙感觉就像是两个应用”——某同学抱怨某平台广告墙 为了增加开发者应用界面与对广告墙样式适配度提高应用的界面体验易积分平台特别提供了多种广告墙样式供开发者选择使开发者应用界面与广告墙界面完美融合解决视觉风格不统一的问题。
易积分广告墙效果图如下所示 蓝色广告墙 褐色广告墙 易积分平台Android版广告植入开发手册 Copyright??2012 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司 版权所有 Page 5 银色广告墙 草绿色广告墙 橙色广告墙 红色广告墙 以上截图均为手机完整屏幕。
四虚拟货币 为提高开发者应用的用户体验易积分平台提供开发者自定义应用中所使用的货币的名称及汇率的功能。
开发者可在“管理中心”——“应用管理”——“虚拟货币”页面进易积分平台Android版广告植入开发手册 Copyright??2012 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司 版权所有 Page 6 行虚拟货币的相关设置。
建议开发者将虚拟货币的汇率设定为10的整数倍例如1元100金币。
消费虚拟货币时应保证消费的虚拟货币金额核算成人民币时不能小于0.01元且为0.01元的整数倍。
五开发环境 操作系统windows xp/7Linux等 开发工具Eclipse3.5JDK1.5Android SDK1.5及以上版本 支持设备Android智能设备Android1.5或以上版本。
六开发流程 6.1 注册并获取易积分SDK 1访问易积分官方网站 http://www.yijifen.com/ 注册开发者账户 2登录易积分平台完善用户基本信息和财务账户信息 3进入“下载中心”下载Android SDK 4进入“应用管理”→“添加应用”选择“Android”按照要求填写应用基本信息并保存 5点击“应用名称”进入“应用详情”页面将会看到“开发者ID”、“应用ID”、“应用KEY”这三组ID将在“添加Activity注册”时用到。
6.2 添加易积分SDK 将下载的易积分SDK jar包导入应用所在工程指定的lib目录即可。
6.3 配置相关文件 在植入广告墙以前需进行一些简单的配置添加使用权限修改AndroidManifest.xml文件。
具体操作如下。
6.3.1 添加权限许可 确保应用具有以下几项 uses-permission 权限 易积分平台Android版广告植入开发手册 Copyright??2012 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司 版权所有 Page 7 ltuses-permission android:namequotandroid.permission.INTERNETquot /gt ltuses-permission android:namequotandroid.permission.WRITE_EXTERNAL_STORAGEquot /gt ltuses-permission android:namequotandroid.permission.GET_TASKSquot /gt ltuses-permission android:namequotandroid.permission.
ACCESS_WIFI_STATEquot /gt ltuses-sdk android:minSdkVersionquot4quotgtlt/uses-sdkgt ltuses-permission android:namequotandroid.permission.
ACCESS_NETWORK_STATEquot /gt ltuses-permission android:namequotandroid.permission.READ_PHONE_STATEquot /gt 6.3.2 添加Activity注册 1注册广告墙AdverWallActivity广告墙的载体请添加代码否则无法正常使用广告墙功能。
代码如下 lt-- 注册广告墙 Activity --gt ltactivity android:namequotcom.yjfsdk.advertSdk.AdverWallActivityquotgt lt/activitygt 2注册积分消费验证AdverCheckActivity这是提供给用户使用更多功能或全功能时可以调用此Activity来消费积分获取积分收益请添加代码否则无法正常使用积分消费功能。
代码如下 lt-- 注册消费验证 Activity --gt ltactivity android:namequotcom.yjfsdk.advertSdk.AdverCheckActivityquotgt lt/activitygt 3在ltapplicationgt段内添加以下内容配置与服务器通信常量信息。
代码如下 lt-- 应用编号--gt ltmeta-data android:namequotYJF_APP_IDquot android:valuequot1070quot /gt lt-- 应用密钥--gt ltmeta-data android:namequotYJF_APP_KEYquot android:valuequot1234567890quot /gt lt-- 开发者ID --gt ltmeta-data android:namequotYJF_DEV_IDquot android:valuequot1010quot /gt lt-- 渠道号--gt 易积分平台Android版广告植入开发手册 Copyright??2012 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司 版权所有 Page 8 ltmeta-data android:namequotYJF_APP_CHANNELquot android:valuequotyjf_adwall_v1.0.2quot /gt lt-- 积分显示开关--gt ltmeta-data android:namequotSHOW_SCOREquot android:valuequotOPENquot /gt 其中YJF_APP_ID 为易积分平台分配给应用的“应用 ID” YJF_APP_KEY 为易积分平台分配给应用的“应用 KEY” YJF_DEV_ID 为易积分平台分配给应用开发者的“开发者 ID” YJF_APP_ID、YJF_APP_KEY、YJF_DEV_ID 由易积分平台添加应用后自动生成可在“查看详情”中获取。
YJF_APP_CHANNEL 为开发者在易积分平台自定义的渠道编号用以统计收益来源等用途建议格式为 6-20 位的字符串例如: quotyjf_adwall_v1.0.2quot。
SHOW_SCORE 为积分显示开关当 value” OPEN” 时广告墙显示积分信息 当value”CLOSE”时广告墙不显示积分信息。
重要提醒 为保证您的收入请严格按照应用详情中所给的“应用 ID”、“应用 KEY”、“开发者 ID”进行填写如填写有误应用将无法正常获取广告以及进行积分消费。
在机锋市场推广的开发者请统一使用渠道号“jifeng”。
6.3.3 添加推送广告service注册 添加推送广告service注册否则点击收到的推送广告无法下载。
代码如下 lt-- 接收推送广告点击下载Service --gt ltservice android:namequotcom.yjfsdk.advertSdk.modle.NotficationServicequotgt lt/servicegt 6.4 接口说明 6.4.1 异步回调接口 UpdateScordNotifier 为了将初始化、查询积分、消费积分的操作结果反馈给开发者的应用我们在 SDK 中提供了异步回调接口 UpdateScordNotifier。
当操作成功时调用 updateScoreSuccessint type int currentScoreint changeScore 易积分平台Android版广告植入开发手册 Copyright??2012 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司 版权所有 Page 9 type 为操作标识0初始化操作1查询积分操作2消费积分操作 currentScore 为当前用户可用积分 int changeScore 为消费积分的数值 当操作失败时调用 updateScoreFailedint type String error type 为操作标识0初始化操作1查询积分操作2消费积分操作 error 为操作错误信息。
具体使用方法请参见如下接口使用说明。
6.4.2 应用注册接口 该接口是所有其他接口能正常使用的基础在每次应用启动时必须调用该接口才能保证获得准确的统计数据。
具体用法如下 1 请在应用的第一个 Activity 类中初始化我们的广告程序添加如下代码 AdvertSDK.getInstancethis.initInstancethis 此方法需实现接口 UpdateScordNotifier其中第一个 this 为上下文对象 Context第二个 this 为实现接口 UpdateScordNotifier 的实例以便初始化结束后通知开发者。
异步回调接口 UpdateScordNotifier: 当操作成功时调用 updateScoreSuccessint type int currentScoreint changeScore type 为操作标识初始化广告墙时该值为 0 currentScore 为当前用户可用积分 int changeScore 初始化广告墙时该值为 0表示积分没有变更 当操作失败时调用 updateScoreFailedint type String error type 为操作标识初始化广告墙时该值为 0 error 为操作错误信息。
2在程序退出的处理方法中 添加下面一行代码 AdvertSDK.getInstancethis.recordAppClose 其中this 为当前 Activity 的上下文对象 Context。
重要提醒 使用回调函数时请注意使用 Handler 来操作系统 UI否则会报错。
易积分平台Android版广告植入开发手册 Copyright??2012 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司 版权所有 Page 10 6.4.3 广告墙接口 该接口是用来调用广告墙 Acitivy开发者可在某一点击事件中调用此接口来实现广告墙应用下载、安装、激活功能从而实现积分收益。
具体用法如下 AdvertSDK.getInstancethis.showAdWallMainActivity.this 其中 MainActivity.this 为开发者应用中的当前 Activity 类的上下文对象 Context。
6.4.4 查询积分接口 该接口用来查询用户可用积分开发者可在方法中调用此接口来实现查询用户积分的功能。
具体用法如下 Int score AdvertSDK.getInstancethis.querryBalancethis 其中score为接口返回值。
状态 描述 scoregt0 为正确返回值 scorelt0 正在查询中或发生异常 此方法需实现接口 UpdateScordNotifier其中第一个 this 为上下文对象 Context第二个 this 为实现接口 UpdateScordNotifier 的实例以便查询积分结束通知开发者。
异步回调接口 UpdateScordNotifier 当操作成功时调用 updateScoreSuccessint type int currentScoreint changeScore type 为操作标识查询积分时该值为 1 currentScore 为当前用户可用积分 int changeScore 查询积分时该值为 0表示积分没有变更。
当操作失败时调用 updateScoreFailedint type String error type 为操作标识查询积分时该值为 1 error 为操作错误信息。
6.4.5 消费积分验证接口 该接口用来调用消费积分验证 Acitiviy开发者可在用户开启应用中的某项功能时调用此接口来实现积分消费从而实现积分收益。
易积分平台Android版广告植入开发手册 Copyright??2012 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司 版权所有 Page 11 具体用法如下 AdvertSDK.getInstancethis.showVerifythis10 此方法需实现接口 UpdateScordNotifier其中第一个 this 为上下文对象 Context第二个 this 为实现接口 UpdateScordNotifier 的实例以便初始化完成通知开发者。
10为开启应用某使用功能所需消费的积分。
异步回调接口 UpdateScordNotifier 当操作成功时调用 updateScoreSuccessint type int currentScoreint changeScore type 为操作标识消费积分时该值为 2 currentScore 为当前用户可用积分 int changeScore 为消费积分的数值 当操作失败时调用 updateScoreFailedint type String error type 为操作标识消费积分时该值为 2 error 为操作错误信息。
开发者可以设定需要消费用户积分才能开启应用的某项功能或者获得应用中的某些物品从而赚取用户的积分实现盈利。
6.4.6 手动推送广告接口 该接口用来获取一条推送广告广告将显示在手机通知栏用户点击即可开始下载广告应用。
开发者可在执行任何功能时调用此接口从而实现积分收益。
具体用法如下 AdvertSDK.getInstancethis.pushAd 其中this 为上下文对象 Context。
开发者每调用该接口一次用户手机就会收到一条推送广告。
为了防止频繁获取推送广告影响用户体验易积分平台对获取推送广告的时间间隔进行了限制。
在一定时间内重复调用该接口只能获得一次推送广告具体间隔时间由易积分平台规定。
具体操作可参见我们提供的 Demo
源码。
6.5代码混淆说明 为了防止反编译造成源代码泄露易积分对SDK代码进行了混淆。
开发者对Android项目进行混淆时不能混淆易积分SDK代码。
在混淆编译时需要对Android项目的根目录处名为proguard.cfg的混淆配置文件进行如下修改 在文件最上方加入 易积分平台Android版广告植入开发手册 Copyright??2012 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司 版权所有 Page 12 -libraryjars libsyjf.jar 此处 yjf.jar为易积分平台的sdk 具体请参见易积分官网——下载中心——Demo
源码下载。
DEMO
源码中已有混淆示例供参考。
常见问题 a. 内存溢出异常主要是proguard在做混淆的时候占用很多内存因此在运行混淆器时可以适当增加内存比如 java -mx512m .....。
b. 栈溢出异常主要是proguard在做混淆的时候会对一些代码进行优化若遇到有些相对复杂的方法时可能会抛出此异常。
解决的办法是增加配置参数-dontoptimize。
c. 使用Eclipse混淆出现问题 请先查看android文件夹中tools下文件夹proguard是否为最新版.