阿里TV开放平台文档 / 领取礼包接口

领取礼包接口

积分商城简介: 积分商城累计覆盖用户200w,累计兑换用户7.5W,累计兑换人次20w,每天新增人数6K-1w,商品种类300多种,覆盖电子数码、家居生活、游戏周边、玩具模型等各个领域

积分商城首页曝光图:

TB1FovAJVXXXXXLXXXXXXXXXXXX-800-450.png

 

最好的推荐位,日点击数维持在2w左右,新品上线的时候会安排三天左右的排期进行首焦推广,目前有三国杀传奇、我叫MT2、天天西游酷跑、金蟾捕鱼、花样三国等十多种礼包接入积分商城,积分商城开设了游戏礼包专区

TB1djHrJVXXXXaDXpXXXXXXXXXX-800-450.png  

 

 

礼包详情页:

TB1zlW2JVXXXXbzaXXXXXXXXXXX-800-450.png

 

 

1.游戏推广黄金期,以礼包包装福利亮点,有更多理由和机会优先申请公共推广资源
 

2.积分商城全力推广,单日uv2w+,单月能消耗的礼包数1w-2w,每日可持续引导2000+用户进游戏。每个积分兑换成功用户即可直接跳转到游戏中!


 

一般游戏申请的积分额度如下:

1.不同产品星级会有各自的月总奖池和TOP奖限制;非TOP奖不能超过TOP奖的1/3

 

产品星级

每月可用
积分奖励池

每个用户单次活动
TOP奖额度上限

单次活动
TOP奖人数上限

月累计
TOP奖人数上限

独代S

300000

2000

8

24

联运S

200000

1500

6

18

联运A

150000

1000

6

18


 

2.以游戏最近一周的DAU作为参考,可对以上全部数据可进行加成,加成如下:

周均DAU

加成

3万以上

1.5倍

6000~3万

1.0倍

6000以下

0.5倍

例如:5000DAU的独代产品单次用户最高发放1500积分、月累计可发放最多12人次。


 

附:礼包接入完毕,提供的物料需求
 

1.宣传图,3张JPG,690*450,600*600,240*156
 

2.礼包描述:150-300字

 

 

客户端领取礼包接口

 

 

获取礼包信息接口

 

接口说明

获取礼包列表,适用于单机APP领取APP内礼包,调用此接口可获取礼包码列表。

前置条件:

需登录授权

函数原型

public static void queryGifts(final IGetGiftListListener listener)
 参数说明

listener 礼包信息的回调

回调接口原型

 public static interface IGetGiftListListener { 		public void onGetGiftListSuccess(List<Gift> list); 		public void onGetGiftListError(String errMsg); 	} 	public static class Gift { 		private String cpItemId; 		private Long giftId; 		private Long status

 

领取礼

 

接口说明 领取礼物,从获取的礼包码ID列表中 领取相应的礼包ID

前置条件

1. 需要先通过“获取礼包信息”接口拿到可购买的商品的giftId

2. 需要登录授权

函数原型

public static void takeGifts(long giftId, ITakeGiftListener listener)

参数说明

giftId 要领取礼物的ID

listener收到服务器返回的回调

回调接口原型:

public static interface ITakeGiftListener {

public void onTakeGiftListSuccess(boolean isSuccess);

public void onTakeGiftListError(String errMsg);

}

 

服务端领取礼包接口

 

 

获取礼包信息接口

 

接口说明

当用户通过各种渠道领取APP礼包后,APP启动时,APP客户端/服务端可以和向数娱APP后台查询,该用户是否有需要发放的礼包。查询成功,则返回一个记录列表。

前置条件:

需登录授权

函数原型:

http://gateway.6uu.com/coin/query_game_gift_record.action?user_str_id=xxx&app_str_id=xxx&game_item_id=xxx &status=0&ts=xxx&sign=xxx

参数说明:                                                                                                  

请求参数

user_str_id

数娱用户Id

必选

String

xxxxx

game_item_id

购买的物品Id(此Id由CP提供,CP校验此物品ID合法性)。可不填,亦可填多个,逗号分隔(不填则返回该用户所有符合条件的记录)。

可选

String

12312312312

status

按状态对结果进行筛选。0为全部,1为待激活,2为已激活,3为已过期。默认为1。

可选

Int

1

app_str_id

APPappkey

必选

String

12654

ts

时间戳

必选

long

223433232

sign

签名当前请求的数据进行签名,必须可选要根据当前Request请求中的数据项而定,不能写死在代码中。

必选

String

Sdf98sdf98sdf89sdf9sdf9sd

成功返回

is_success

请求处理是否成功

必选

String

T

record_list

返回APP服务器创建订单后的订单ID

必选

String

返回的信息中 以下字段代表礼包ID

cpItemId

失败返回

is_success

请求处理是否成功

必选

String

F

error_code

错误码

必选

String

605

msg

错误信息

必选

String

请求失败


响应样例

成功返回

有2个礼包

{

 “is_success”:”T”,

 “record_list”: [{"cpItemId":"4698796","gmtCreate":1433948755664,"recordId":65498,"status":1,"userStrId":"654987asdf987sadf"},{"cpItemId":"98964654","gmtCreate":1433948755664,"recordId":658796,"status":1,"userStrId":"654987asdf987sadf"}]

}

无符合条件的礼包:

{

 “is_success”:”T”,

 “record_list”: []

}

失败返回

{

 “is_success”:”F”,

 “error_code”:”FAIL”,

 “msg”:”system error”

}

 

 

 

领取礼包

 

接口说明

APP端完成礼包发放之后,通知数娱服务端,该礼包已成功激活,下次再请求待激活礼包列表时则不会返回该礼包。

函数原型:

http://gateway.6uu.com/coin/mark_record_as_activated.action?user_str_id=xxx&app_str_id=xxx&app_order_id=xxx&record_id=xxx&ts=xxx&sign=xxx
 参数说明:   

请求参数

user_str_id

数娱用户Id

必选

String

xxxxx

app_order_id

APP端完成发放所关联的订单id,有cp生成,数娱服务端只记录

必选

String

12312312312

record_id

查询记录时返回的记录id

必选

Long

654897

app_str_id

APPappkey

必选

String

12654

ts

时间戳

必选

Long

223433232

sign

签名当前请求的数据进行签名,必须可选要根据当前Request请求中的数据项而定,不能写死在代码中。

必选

String

Sdf98sdf98sdf89sdf9sdf9sd

成功返回

is_success

请求处理是否成功

必选

String

T

app_order_id

返回APP服务器创建订单后的订单ID

必选

String

1231231

失败返回

is_success

请求处理是否成功

必选

String

F

error_code

错误码

必选

String

FAIL

msg

错误信息

必选

String

请求失败


响应样例

成功返回

{

 “is_success”:”T”,

 “app_order_id”:“1235654”

}

失败返回

该礼包记录已激活过或已过期

{

 “is_success”:”F”,

“app_order_id”:“1235654”,

 “error_code”:”RECORD_STATUS_INVALID”,

 “msg”:”礼包状态错误”

}

 

该礼包记录不存在

{

 “is_success”:”F”,

“app_order_id”:“1235654”,

 “error_code”:”RECORD_NOT_FOUND”,

 “msg”:”未找到发放记录”

}