版本号 :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 注册... 4 1.3.3 初始化账户信息... 5 1.3.4 服务器端对接的客户端设置... 5 1.3.5 推送消息设置... 5 1.3.6 程序退出释放内存... 6 1.4 广告形式的使用... 6 1.4.1 推荐墙... 6 1.4.2Banner... 6 1.4.3 插屏... 6 1.4.4 异步回调 UpdateScordNotifier... 7 1.4.5 自定义推荐墙... 7 1.4.6 自定义详情页... 8 1.5 混淆过滤... 8 二.FAQ... 8 Copyright 2013 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司版权所有 Page 2
一.SDK 的嵌入 1.1 注册并获取易积分 SDK 1) 访问易积分官方网站 http://www.yijifen.com/ 注册开发者账户 ; 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 配置相关文件 1.3.1 添加权限 在 manifest.xml 文件中配置用户权限请将下面权限配置代码复制到 AndroidManifest.xml 文件中 : android:name="android.permission.internet"/> Copyright 2013 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司版权所有 Page 3
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"/> 1.3.2 添加 Activity 及 Service 注册 --> <!-- 注册积分墙 推荐墙 Activity( 开发者勾选了积分墙或推荐墙广告形式则必填 ) <activity android:name="com.eadver.offer.sdk.view.wallactivity" android:configchanges="keyboardhidden orientation" > </activity> <activity android:name="com.eadver.offer.sdk.view.detailactivity" android:configchanges="keyboardhidden orientation" /> <!-- 注册网页 Activity --> <activity android:name="com.eadver.offer.sdk.view.webactivity" android:configchanges="keyboardhidden orientation" /> <!-- 注册 Service( 必填 )--> <service android:name=" com.eadver.offer.sdk.util.adscoreservice" android:exported=" false " > </service> <!-- 注册 receiver( 必填 )--> <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
android:name="android.intent.action.package_removed" /> <data android:scheme="package" /> </intent-filter> </receiver > 1.3.3 初始化账户信息 在主 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. 1.3.4 服务器端对接的客户端设置 YjfSDK.getInstance(this, this).setcoopinfo(" 用户 id"); 注 : 只有设置了用户 id, 才会有服务器端的回调, 如果没有用户体系, 可不用调用此方法 注 : 服务器端回调地址可在官网内提交应用之前即可填写," 服务器回调地址 " 如果不需要做服务器端对接则可以不设置此参数 1.3.5 推送消息设置 如果开发者的应用支持积分墙广告, 以下代码控制是否显示推送消息 : YjfSDK.getInstance(this, this).setdonotify(true);// 显示推送消息若 setnotify 的参数设置为 true, 则在每天第一次初始化成功后, 并且有新任务或者未完成的任务, 会显示推送消息, 点击后打开积分墙 ; 若 setnotify 的参数设置为 false, 则不显示推送消息 Copyright 2013 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司版权所有 Page 5
如果开发者不调用此方法,setNotify 的参数默认为 true 1.3.6 程序退出释放内存 在开发者应用程序退出的处理方法中, 添加下面一行代码 : YjfSDK.getInstance(this,null).recordAppClose();// 释放内存 其中, 第一个 this 为当前 Activity 的上下文对象 Context. 1.4 广告形式的使用 1.4.1 推荐墙 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.4.3 插屏 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
2. 插屏展示 PlaqueSDK.getInstance(this,this).getPlaque(plaue_flag); 注 : 当预加载成功后, 方可调用展示插屏接口! 然后开发者可以调用预加载插屏, 缓存下一条插屏数据! 1.4.4 异步回调 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.4.5 自定义推荐墙 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
4. 详细页接口 RecommendAdListSDK.getInstance(context).gotoDetail(info); 此接口为 SDK 提供的详细页接口, 第一个参数为上下文参数 Context, 第二个参数为积分墙的 JavaBean 类 WallInfo 5. 退出 Activity 时调用清除接口 RecommendAdListSDK.getInstance(this).onDestroy();// 清除推荐墙数据 1.4.6 自定义详情页 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
A: 由中国最大的互联网效果营销平台 亿玛在线 强势推出, 全面覆盖数千优质应用, 秉承 让移动广告更有效果 的理念, 我们将为移动电商 手机游戏 手机工具等众多类型的移动服务提供卓有成效的移动效果营销推广服务 Q: 易积分平台能为我提供哪些有用的数据? A: 我们将为您提供全面的数据统计, 完善的数据报表系统, 让您更懂您的用户, 亦可随时查看您的收入情况 Q: 应用集成广告影响用户体验怎么办? A: 易积分采用广告墙推荐下载的广告形式, 不会强制弹出广告, 因此不会影响用户体验, 让您的用户再也不受广告打扰, 让您的应用更受欢迎 Q: SDK 的植入是否复杂? A: 非常简单! 只需几分钟就可以轻松植入 SDK Q: 有了收入如何提款? A: 易积分平台目前提供银行转账的付款方式 首先请准确填写您的财务资料, 如果财务资料填写有误, 将无法收到汇款 请于每周三之前在平台 提款申请 页面提交提款申请, 我们的工作人员会在每周四进行统一处理并转账 具体的提款状态可在 提款申请 页面查看 感谢阅读此文档! 如果您有任何建议或问题, 请与易积分平台技术支持人员联系! 易积分平台技术支持 QQ:800074539 电话 :010-53553118-8542 Email:yijifen-contact@emar.com.cn 感谢您的支持! Copyright 2013 YIJIFEN. All Rights Reserved 北京亿玛在线科技有限公司版权所有 Page 9