一、点乐推荐列表
1.简介
点乐Android_SDK方便开发者在Android应用中更好的集成推荐列表提供的各项功能，同时也为开发者提供了一套现成的Demo。
推荐列表是优质应用及游戏的集成墙，可自然嵌入开发者的应用当中，不仅不会影响用户体验，而且广告效果良好，同时使得应用的架构更加紧凑丰富。
2.适用范围
本文档描述了标准版SDK的用途和用法，并提供示例代码。您仅需在现有的应用中加入少量新代码，就可以实现平台的各项功能，轻松获得用户量和收入的倍增。
名词解释
使用者：手机使用者,在使用过程中,他们会通过点乐推荐列表下载安装应用。
开发者：将SDK嵌入自己开发的游戏中，通过使用者获取收益。
SDK： 推荐列表开发包，当中提供了各种使用接口。
二、开发手册
1.注册及申请DIANLE_APP_ID
1.1 登陆DianLe官网(http://www.dianjoy.com)进行注册
1.2 创建自己的应用（注意在后台应用修改中勾选“不显示虚拟货币”），然后提交。提交后，得到系统为您生成的DIANLE_APP_ID（注册应用时获得的32位字符串，用于绑定开发者和应用）。
1.3 下载标准版SDK开发包。
1.4 查看你已经提交的应用，上面会注明处于‘审核通过’或‘未审核状态’。工作人员会在您提交应用后，在最短的时间内完成审核工作。
1.5 在数据报表选项中，可以查看应用给您带来的收入
2.SDK嵌入
注意：关于工程里如何使用Dianle SDK部分 ，以例子工程为准，文档只做参考（文档更新较慢）。
2.1 将dlnetwork_v3.6.1.jar拷贝到libs下，加入到您的Build Path。
2.2 修改AndroidManifest.xml。
在AndroidManifest.xml声明activity ,service
<activity
android:name="com.dlnetwork.DianleOfferActivity"
android:configChanges="keyboardHidden|orientation"
android:theme="@android:style/Theme.Translucent.NoTitleBar"/>
<service android:name="com.dlnetwork.DianleOfferHelpService" />
请注意：Activity的theme要如上包含Translucent。
2.2 增加权限
<uses-permission android:name="android.permission.INTERNET"/ >
<uses-permission android:name="android.permission.GET_TASKS"/ >
<uses-permission android:name="android.permission.READ_PHONE_STATE"/ >
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/ >
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
2.3 初始化
// 在应用的入口处设置context
// 如果是Activity,在第一个启动的Acitivty里面的onCreate的开始写上下面的代码；
// 如果没有Acitivity，只有Service，在onBind或者onStart方法的开始写上下面的代码
// 设置app id= "072cb4d9d9d5dfd23ed2981e5e33fe59"，是你的应用在点乐服务器注册生成的key,详情请看文档。
// mDefaultCid : 渠道号，默认的是，可以不要这个参数
//userID=1234 开发者设置用户id
Data.initDianleContext(this, "072cb4d9d9d5dfd23ed2981e5e33fe59");
Data.setCurrentUserID("1234");
或者初始化的时候，声明渠道号————代表应用将要上传的市场，例如机锋市场。
Data. initGoogleContext(this, DIANLE_APP_ID,”gfan”);
2.4 展示广告墙
调用Data.showOffers(Context context)接口，即可展示广告墙，调用方式:
Data.showOffers(Context context);
2.5 特殊说明
2.5.1需要混淆代码的情形
如果是需要混淆代码的，需要在proguard.cfg文件的最底部加上：
-keep class *.R$ {
*;
}
-dontwarn com.dlnetwork.**
;
即不混淆R.java。
2.5.2 关于AndroidMenifest设置渠道号（适用于批量分渠道号）：
如果是需要将渠道号设置在AndroidMenifest.xml里，需要这样设置：
<meta-data
android:name="com.dlnetwork.cid"
android:value="default_cid" />
其中default_cid是缺省的渠道号，如果渠道为机锋市场需更改为android:value=”gfan”
注意：
如果同时使用了上面的AndroidMenifest方法和Data.initDianleContext（）设置cid，sdk会以AndroidMenifest为准。
3.接口说明
3.1 显示广告墙
供用户下载应用,支持3G/2G/wifi网络。
Data.showOffers(Context context);
3.2 获取在线参数
开发者可以在管理后台的”应用管理-全部应用-在线参数”里面为每个应用设置一个在线参数。通过sdk接口,开发者可以在应用中获取这个参数值。
本功能提供同步和异步两种调用方式：
Key:是在平台上面登记的参数名，返回值就是平台上面登记的参数值
DefValue:缺省值，无网或者获取失败，并且本地数据（SharedPreferences）为空时，返回该值，并做本地保存。
*无网或者获取失败，并且本地数据不为空时，返回本地值
*每次成功获取在线参数时会同步更新本地缓存。
同步方式
/* 获取自定义在线参数的同步方法*/
public static String getOnlineParams(Context context,String key, String defValue) {
异步方式
public static void getOnlineParams(Context context,String key, final GetOnlineParamsListener getOnlineParamsListener, String defValue) {
public interface GetOnlineParamsListener {
/* @Description: 返回自定义的在线参数*/
public void onParamsReturn(String value);
}
非托管货币功能
4.1 非托管货交互币原理图
如果你想使用自己的服务器来核对用户的激活，这意味着您可以更方便的监控用户的激活行为，下面的步骤可以帮助你使用该功能：
4.2 在”应用管理-全部应用-修改”界面中，最下面可以看见如下设置：
通知接口： 通知您的服务器的地址，url;
接口key： 通信的密匙，即下面的secret_key(Ffjd23ji47klfa67539fdsa）；
4.3 在使用了点乐sdk的应用中，当您的app验证用户登录后，或者验证到用户更改用户登陆后，立即调用如下接口，将用户的账户id设置给sdk：
/**
*@Description：2.6 新增功能,请在用户登录或者更换账户后立即调用此接口,设置用户ID,这样才能正确实现点乐非托管货币功能
*/
Data.setCurrentUserID(String userID);
4.4 点乐收到加分请求的同时，通知开发者自己的服务器进行加分。接口规范，以get请求为例：
参数名 描述
snuid 用户在app自己的服务器对应的账户id，app在打开广告墙时时作为参数传给SDK
device_id 设备号，手机唯一值
app_id 在点乐的应用所对应DIANLE_APP_ID值
currency 积分，注意：不是钱
app_ratio 汇率：1元=多少积分
time_stamp 时间戳
ad_name 广告名
pack_name 包名
token 验证密文
token的计算方法如下：将time_stamp（是服务器当前时间戳）的值和前面提到的secret_key连接成字符串，然后MD5加密，token=MD5(time_stamp +secret_key)。
例如：
其中，2e9f2d0336b57c465cf6703f2e9f945b = MD5( “1326183509234” + ” Ffjd23ji47klfa67539fdsa”).
4.5 开发者自己的服务器收到消息后的信息处理和解密：
验证
首先要对token进行验证，用自己在点乐所设置的secret_key和time_stamp的值验证token。响应
此时有三种情况：
a) 如果验证合法，应给点乐服务器返回200(给点乐返回的200不是http状态码的200，而是字符串的200)。
b) 如果验证参数不匹配的计算值，应给点乐服务器返回403，点乐服务器不会重试。
c) 如果是其他的>200的响应，点乐服务器会保存此次访问的内容，在一周之内，以一分钟左右的时间间隔重复请求，直至成功。
附录I：其他注意事项
每天每个设备有固定下载限额，超过限额将给出提示，不能继续下载。
共同学习，写下你的评论
评论加载中...
作者其他优质文章
