領(lǐng)取禮包接口
積分商城簡介： 積分商城累計覆蓋用戶200w，累計兌換用戶7.5W，累計兌換人次20w，每天新增人數(shù)6K-1w，商品種類300多種，覆蓋電子數(shù)碼、家居生活、游戲周邊、玩具模型等各個領(lǐng)域
積分商城首頁曝光圖：
最好的推薦位，日點擊數(shù)維持在2w左右，新品上線的時候會安排三天左右的排期進行首焦推廣，目前有三國殺傳奇、我叫MT2、天天西游酷跑、金蟾捕魚、花樣三國等十多種禮包接入積分商城，積分商城開設(shè)了游戲禮包專區(qū)
禮包詳情頁：
1.游戲推廣黃金期，以禮包包裝福利亮點，有更多理由和機會優(yōu)先申請公共推廣資源
2.積分商城全力推廣，單日uv2w+，單月能消耗的禮包數(shù)1w-2w，每日可持續(xù)引導(dǎo)2000+用戶進游戲。每個積分兌換成功用戶即可直接跳轉(zhuǎn)到游戲中！
一般游戲申請的積分額度如下：
1.不同產(chǎn)品星級會有各自的月總獎池和TOP獎限制；非TOP獎不能超過TOP獎的1/3
產(chǎn)品星級 | 每月可用 | 每個用戶單次活動 | 單次活動 | 月累計 |
獨代S | 300000 | 2000 | 8 | 24 |
聯(lián)運S | 200000 | 1500 | 6 | 18 |
聯(lián)運A | 150000 | 1000 | 6 | 18 |
2.以游戲最近一周的DAU作為參考，可對以上全部數(shù)據(jù)可進行加成，加成如下：
周均DAU | 加成 |
3萬以上 | 1.5倍 |
6000~3萬 | 1.0倍 |
6000以下 | 0.5倍 |
例如：5000DAU的獨代產(chǎn)品單次用戶最高發(fā)放1500積分、月累計可發(fā)放最多12人次。
附：禮包接入完畢，提供的物料需求
1.宣傳圖，3張JPG，690*450，600*600，240*156
2.禮包描述：150-300字
客戶端領(lǐng)取禮包接口
獲取禮包信息接口
接口說明：
獲取禮包列表，適用于單機APP領(lǐng)取APP內(nèi)禮包，調(diào)用此接口可獲取禮包碼列表。
前置條件：
需登錄授權(quán)
函數(shù)原型：
public static void queryGifts(final IGetGiftListListener listener)
參數(shù)說明：
回調(diào)接口原型：
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
領(lǐng)取禮包
接口說明： 領(lǐng)取禮物，從獲取的禮包碼ID列表中 領(lǐng)取相應(yīng)的禮包ID
前置條件：
1. 需要先通過“獲取禮包信息”接口拿到可購買的商品的giftId
2. 需要登錄授權(quán)
函數(shù)原型：
public static void takeGifts(long giftId, ITakeGiftListener listener)
參數(shù)說明：
giftId 要領(lǐng)取禮物的ID
listener收到服務(wù)器返回的回調(diào)
回調(diào)接口原型：
public static interface ITakeGiftListener {
public void onTakeGiftListSuccess(boolean isSuccess);
public void onTakeGiftListError(String errMsg);
}
服務(wù)端領(lǐng)取禮包接口
獲取禮包信息接口
接口說明：
當(dāng)用戶通過各種渠道領(lǐng)取APP禮包后，APP啟動時，APP客戶端/服務(wù)端可以和向數(shù)娛APP后臺查詢，該用戶是否有需要發(fā)放的禮包。查詢成功，則返回一個記錄列表。
前置條件：
需登錄授權(quán)
函數(shù)原型：
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參數(shù)說明：
請求參數(shù) | ||||||||
user_str_id | 數(shù)娛用戶Id | 必選 | String | xxxxx | ||||
game_item_id | 購買的物品Id（此Id由CP提供，CP校驗此物品ID合法性）?？刹惶睿嗫商疃鄠€，逗號分隔（不填則返回該用戶所有符合條件的記錄）。 | 可選 | String | 12312312312 | ||||
status | 按狀態(tài)對結(jié)果進行篩選。0為全部，1為待激活，2為已激活，3為已過期。默認為1。 | 可選 | Int | 1 | ||||
app_str_id | APPappkey | 必選 | String | 12654 | ||||
ts | 時間戳 | 必選 | long | 223433232 | ||||
sign | 簽名當(dāng)前請求的數(shù)據(jù)進行簽名，必須可選要根據(jù)當(dāng)前Request請求中的數(shù)據(jù)項而定，不能寫死在代碼中。 | 必選 | String | Sdf98sdf98sdf89sdf9sdf9sd | ||||
成功返回 | ||||||||
is_success | 請求處理是否成功 | 必選 | String | T | ||||
record_list | 返回APP服務(wù)器創(chuàng)建訂單后的訂單ID | 必選 | String | 返回的信息中 以下字段代表禮包ID cpItemId | ||||
失敗返回 | ||||||||
is_success | 請求處理是否成功 | 必選 | String | F | ||||
error_code | 錯誤碼 | 必選 | String | 605 | ||||
msg | 錯誤信息 | 必選 | String | 請求失敗 | ||||
響應(yīng)樣例：
成功返回 |
有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” } |
領(lǐng)取禮包
接口說明：
APP端完成禮包發(fā)放之后，通知數(shù)娛服務(wù)端，該禮包已成功激活，下次再請求待激活禮包列表時則不會返回該禮包。
函數(shù)原型：
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參數(shù)說明：
請求參數(shù) | ||||
user_str_id | 數(shù)娛用戶Id | 必選 | String | xxxxx |
app_order_id | APP端完成發(fā)放所關(guān)聯(lián)的訂單id，有cp生成，數(shù)娛服務(wù)端只記錄 | 必選 | String | 12312312312 |
record_id | 查詢記錄時返回的記錄id | 必選 | Long | 654897 |
app_str_id | APPappkey | 必選 | String | 12654 |
ts | 時間戳 | 必選 | Long | 223433232 |
sign | 簽名當(dāng)前請求的數(shù)據(jù)進行簽名，必須可選要根據(jù)當(dāng)前Request請求中的數(shù)據(jù)項而定，不能寫死在代碼中。 | 必選 | String | Sdf98sdf98sdf89sdf9sdf9sd |
成功返回 | ||||
is_success | 請求處理是否成功 | 必選 | String | T |
app_order_id | 返回APP服務(wù)器創(chuàng)建訂單后的訂單ID | 必選 | String | 1231231 |
失敗返回 | ||||
is_success | 請求處理是否成功 | 必選 | String | F |
error_code | 錯誤碼 | 必選 | String | FAIL |
msg | 錯誤信息 | 必選 | String | 請求失敗 |
響應(yīng)樣例
成功返回 |
{ “is_success”:”T”, “app_order_id”:“1235654” } |
失敗返回 |
該禮包記錄已激活過或已過期 { “is_success”:”F”, “app_order_id”:“1235654”， “error_code”:”RECORD_STATUS_INVALID”, “msg”:”禮包狀態(tài)錯誤” }
該禮包記錄不存在 { “is_success”:”F”, “app_order_id”:“1235654”， “error_code”:”RECORD_NOT_FOUND”, “msg”:”未找到發(fā)放記錄” } |