領取禮包接口


積分商城簡介: 積分商城累計覆蓋用戶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

 

#獨代S聯運S#6#18
##產品星級

每月可用

積分獎勵池

每個使用者單次活動

TOP獎額度上限

單次活動

TOP獎人數上限

月累計

TOP獎人數上限

##300000

2000

8

#24

200000

1500

6

#18

##聯運A

150000

#1000

 

2.以遊戲最近一週的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

要領取禮物的IDlistener

收到伺服器傳回的回呼

回呼介面原型:

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&app_str_id=xxx&game_item_id=xxx &status=0&ts=xxx&app_str_id=xxx&game_item_id=xxx &status=0&ts=xxx&app_str_id=xxx&game_item_id=xxx &status=0&ts=xxx&app_str_id=xxx&game_item_id=xxx &status=0&ts=xxx&app_str_id=xxx&game_item_id=xxx &status=0&ts=xxx&app_str_id=xxx&game_item_id=xxx &status=0&ts=xxx&app_str_id=xxx&game_item_id=xxx &status=0&ts=xxx&app_ xxx&sign=xxx

參數說明:                                                                                                  

#週均DAU

加成

223433232sign#成功返回返回APP伺服器建立訂單後的訂單IDis_success請求處理是否成功必選String#Ferror_code錯誤碼#必選String605

請求參數

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

#簽署目前請求的資料進行簽名,必須可選根據目前Request請求中的資料項目而定,不能寫死在程式碼中。

必選

String

#Sdf98sdf98sdf89sdf9sdf9sd

#is_success

##請求處理是否成功

必選

String

T

record_list

必選

String

傳回的資訊中下列欄位代表禮包ID
cpItemId

##失敗回傳

##########msg############錯誤訊息######## ####必選############String#############請求失敗###############


回應範例

 「record_list」: []} 「error_code ”:”FAIL”,

成功回傳

#有2個禮包

{

# “is_success”:”T”,

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

}

無符合條件的禮包:

{

 「is_success」:」T」,

失敗回傳

{

 「is_success」:」F」,
 “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
 參數說明:   
##請求處理是否成功必選StringTapp_order_id傳回APP伺服器建立訂單後的訂單ID##String請求失敗

請求參數

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

1231231

#失敗回傳

##is_success

#請求處理是否成功

必選

String

F

#error_code

錯誤碼

必選

#String

##FAIL

#msg

錯誤訊息


#回應範例

成功回傳

## {

 「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”:”未找到發放記錄”

}

#