sand

Size: px

Start display at page:

Download "sand"

威羽
5 years ago
Views:

2 目录一.SDK 的嵌入注册并获取易积分 SDK 添加易积分 SDK 配置相关文件添加权限添加 Activity 及 Service 注册初始化账户信息服务器端对接的客户端设置推送消息设置程序退出释放内存广告形式的使用推荐墙 Banner 插屏异步回调 UpdateScordNotifier 自定义推荐墙自定义详情页混淆过滤... 8 二.FAQ... 8 Copyright 2013 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司版权所有 Page 2

3 一.SDK 的嵌入 1.1 注册并获取易积分 SDK 1) 访问易积分官方网站注册开发者账户 ; 2) 登录易积分平台, 完善用户基本信息和财务账户信息 ; 3) 进入下载中心, 下载 Android SDK; 4)a. 进入应用管理创建应用, 选择 Android, 按照要求填写应用基本信息, 并保存 ; b. 上传应用, 选择广告形式 ( 注 : 如果开发者配置了未勾选的广告形式,sdk 将不能正常显示该形式广告 ) 上传 app 保存提交审核 5) 点击应用名称进入应用详情页面, 将会看到开发者 ID 应用 ID appkey, 这三组 ID 将在添加 Activity 注册时用到 ( 注 : 应用必须审核上线, sdk 才能正常展示广告, 开发者正常获得收益 ) 注 : 工作人员会在 1 到 2 个工作日内完成审核审核通过后, 该应用就可以发布上线了 1.2 添加易积分 SDK 将 yjfsdk_08.jar 导入您的工程中 1. 在您的工程目录中创建 "libs" 目录 2. 将 yjfsdk_08.jar 复制到 libs 目录中 3. 右键您的工程根目录, 选择 Properties 4. 在左面板中选择 Java Build Path 5. 然后选择 Libraries 标签 6. 点击 Add JARs 7. 选择 libs 下的 yjfsdk_08.jar. 8. 点击 OK 即导入成功 1.3 配置相关文件添加权限在 manifest.xml 文件中配置用户权限请将下面权限配置代码复制到 AndroidManifest.xml 文件中 : android:name="android.permission.internet"/> Copyright 2013 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司版权所有 Page 3

4 android:name="android.permission.access_network_state"/> android:name="android.permission.read_phone_state"/> android:name="android.permission.write_external_storage"/> android:name="android.permission.get_tasks"/> android:name="android.permission.access_wifi_state"/> android:name="android.permission.process_outgoing_calls"/> 添加 Activity 及 Service 注册 -->  <activity android:name="com.eadver.offer.sdk.view.webactivity" android:configchanges="keyboardhidden orientation" />  <service android:name=" com.eadver.offer.sdk.util.adscoreservice" android:exported=" false " > </service>  <receiver android:name=" com.eadver.offer.sdk.view.eadverreceiver"> <intent-filter> <action android:name="android.intent.action.package_added" /> <action Copyright 2013 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司版权所有 Page 4

5 android:name="android.intent.action.package_removed" /> <data android:scheme="package" /> </intent-filter> </receiver > 初始化账户信息在主 Activity 的 oncreate 函数中调用, 该方法确保调用一次即可 YjfSDK.getInstance(this,this).initInstance( ID KEY, DEV_ID 渠道 ( 选填 ) ); 其中, 第一个 this 为上下文对象 Context 其中,ID 为易积分平台分配给应用的应用 ID ; KEY 为易积分平台分配给应用的应用 KEY ; DEV_ID 为易积分平台分配给应用开发者的开发者 ID ; ID KEY DEV_ID 由易积分平台添加应用后自动生成, 可在查看详情中获取渠道为开发者在易积分平台自定义的渠道编号, 用以统计收益来源等用途, 建议格式为 6-20 位的字符串, 例如 :"sdk5.1.0", 在机锋市场推广的开发者, 请统一使用渠道号 jifeng 服务器端对接的客户端设置 YjfSDK.getInstance(this, this).setcoopinfo(" 用户 id"); 注 : 只有设置了用户 id, 才会有服务器端的回调, 如果没有用户体系, 可不用调用此方法注 : 服务器端回调地址可在官网内提交应用之前即可填写," 服务器回调地址 " 如果不需要做服务器端对接则可以不设置此参数推送消息设置如果开发者的应用支持积分墙广告, 以下代码控制是否显示推送消息 : YjfSDK.getInstance(this, this).setdonotify(true);// 显示推送消息若 setnotify 的参数设置为 true, 则在每天第一次初始化成功后, 并且有新任务或者未完成的任务, 会显示推送消息, 点击后打开积分墙 ; 若 setnotify 的参数设置为 false, 则不显示推送消息 Copyright 2013 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司版权所有 Page 5

6 如果开发者不调用此方法,setNotify 的参数默认为 true 程序退出释放内存在开发者应用程序退出的处理方法中, 添加下面一行代码 : YjfSDK.getInstance(this,null).recordAppClose();// 释放内存其中, 第一个 this 为当前 Activity 的上下文对象 Context. 1.4 广告形式的使用推荐墙 RecommendWallSDK.getInstance(MainActivity.this).showRecommendWall(); 其中参数 MainActivity.this 为上下文对象 Context 1.4.2Banner 1. 获取 banner 的布局 BannerView bannerview = BannerSDK.getInstance(this).getBanner(); 2. 开发者把 bannerview 放到自己的布局 linearlayout 中 linearlayout.addview(bannerview); 3. 请求 banner 数据,banner 开始轮转 BannerSDK.getInstance(this,null).showBanner(bannerView); 插屏 1. 插屏预加载 PlaqueSDK.getInstance(this,this).preloadingPlaque(plaue_flag); 第一个 this 为 context, 第二个 this 为回调接口 UpdateScordNotifier( 参考 1.4.5), 参数,2- 横屏插屏广告 3- 竖屏插屏广告, 默认 -- 竖屏插屏广告 Copyright 2013 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司版权所有 Page 6

7 2. 插屏展示 PlaqueSDK.getInstance(this,this).getPlaque(plaue_flag); 注 : 当预加载成功后, 方可调用展示插屏接口! 然后开发者可以调用预加载插屏, 缓存下一条插屏数据! 异步回调 UpdateScordNotifier 为了将一些接口的操作结果反馈给开发者的应用, 我们在 SDK 中提供了异步回调接口 UpdateScordNotifier 当操作成功时, 调用 updatescoresuccess(int type, int current,int change, String unit) type 为操作标识, 0: 初始化,4:banner 回调, 5: 插屏回调 ; current 为当前用户可用积分 change 为增加或消费积分的数值 ; unit 为积分单位当操作失败时, 调用 updatescorefailed(int type, int code, String error) type 为操作标识, 0: 初始化,4:banner 回调,5 插屏回调 ; code 为操作错误编号 ; error 为操作错误信息具体操作可参见我们提供的 Demo 源码自定义推荐墙 1. 获取积分墙数据 RecommendAdListSDK.getInstance(this).getAdInitInfo(pageSize,pageNumber,mHandle r); 从服务器端获取数据接口, 是按页获取数据, 其中第一个参数 this 为上下文对象 Context, 第二个参数为整型数据即每页数据, 第三个参数为整型数据即第几页, 第四个参数为 Handler 数据, 即 Android 提供的 Handler 对象, 从服务器端获取数据后会在此对象中接收消息以判断获取成功或失败 2. 接收积分墙数据 RecommendAdListSDK.getInstance(context).getAdList(); 此接口返回 List<WallInfo> 对象, 参数为上下文对象 Context, 此接口通常在 Handler 中使用, 用来接收从服务器端获取的数据 3. 下载接口 RecommendAdListSDK.getInstance(context).downloadAd(info); 此接口为下载某一个应用时使用的接口, 且必须使用此接口下载, 否则此次广告行为为无效的第一个参数为上下文对象 Context, 第二个参数为积分墙的 JavaBean 类 Wallinfo Copyright 2013 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司版权所有 Page 7

8 4. 详细页接口 RecommendAdListSDK.getInstance(context).gotoDetail(info); 此接口为 SDK 提供的详细页接口, 第一个参数为上下文参数 Context, 第二个参数为积分墙的 JavaBean 类 WallInfo 5. 退出 Activity 时调用清除接口 RecommendAdListSDK.getInstance(this).onDestroy();// 清除推荐墙数据自定义详情页 1. 获取详情页数据 wallinfo=(wallinfo)getintent().getserializableextra("wallinfo"); DetailSDK.getInstance(context).initDetailInfo(context,wallInfo,mHandler); 调用此接口之前, 必须将上一页中的 JavaBean 类 WallInfo 传递过来并接收, 因为此接口需要此此参数, 第一个参数为上下文参数 Context, 第二个参数积分墙或推荐墙的 JavaBean 类 WallInfo, 第三个参数为 Handler, 用于发送消息 2. 接收详细页数据信息 DetailSDK.getInstance(context).getDetailInfo(); 该接口的返回 DetailInfo 对象, 第一个参数为上下文对象 Context, 此接口通常在 Handler 中使用, 用来接收从服务器端获取的数据 3. 下载接口 DetailSDK.getInstance(context).downloadAd(); 此接口为详细页中下载的接口, 此接口为必须使用的接口, 如果使用其他下载接口下载则是无效的 1.5 混淆过滤 -keep class com.eadver.offer.**{*;} -dontwarn com.eadver.offer.** 二.FAQ Q: 易积分平台能给我的应用带来多少收益? A: 激励型下载平台的收益是其他广告平台收益的 3-4 倍我们提供方便的虚拟支付支持, 轻量级应用内虚拟支付解决方案将提供开发者更多的盈利方式, 帮助开发者获得更高的收益 Q: 易积分平台有哪些优势? Copyright 2013 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司版权所有 Page 8

9 A: 由中国最大的互联网效果营销平台亿玛在线强势推出, 全面覆盖数千优质应用, 秉承让移动广告更有效果的理念, 我们将为移动电商手机游戏手机工具等众多类型的移动服务提供卓有成效的移动效果营销推广服务 Q: 易积分平台能为我提供哪些有用的数据? A: 我们将为您提供全面的数据统计, 完善的数据报表系统, 让您更懂您的用户, 亦可随时查看您的收入情况 Q: 应用集成广告影响用户体验怎么办? A: 易积分采用广告墙推荐下载的广告形式, 不会强制弹出广告, 因此不会影响用户体验, 让您的用户再也不受广告打扰, 让您的应用更受欢迎 Q: SDK 的植入是否复杂? A: 非常简单! 只需几分钟就可以轻松植入 SDK Q: 有了收入如何提款? A: 易积分平台目前提供银行转账的付款方式首先请准确填写您的财务资料, 如果财务资料填写有误, 将无法收到汇款请于每周三之前在平台提款申请页面提交提款申请, 我们的工作人员会在每周四进行统一处理并转账具体的提款状态可在提款申请页面查看感谢阅读此文档! 如果您有任何建议或问题, 请与易积分平台技术支持人员联系! 易积分平台技术支持 QQ: 电话 : 感谢您的支持! Copyright 2013 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司版权所有 Page 9

sand

sand 版本号 :5.1.0 Copyright 2013 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司版权所有 Page 1 目录一.SDK 的嵌入... 3 1.1 注册并获取易积分 SDK... 3 1.2 添加易积分 SDK... 3 1.3 配置相关文件... 3 1.3.1 添加权限... 3 1.3.2 添加 Activity 及 Service 注册...