Interface for receiving gift packages


Introduction to Points Mall: Points Mall has a cumulative coverage of 2 million users, a total of 7.5W redemption users, a total of 200,000 redemptions, 6K-10,000 new people added every day, and more than 300 product types, covering electronics, digital, and home furnishings. Exposure picture of the points mall homepage in various fields such as life, game peripherals, toys and models, etc.

:

TB1FovAJVXXXXXLXXXXXXXXXXXX-800-450.png

Most For good recommendations, the number of daily clicks is maintained at around 20,000. When new products are launched, a three-day schedule will be arranged for first-focus promotion. Currently, there are Legend of the Three Kingdoms, My Name is MT2, Tiantian Westward Journey Cool Running, Golden Toad Fishing, and Tricks More than ten kinds of gift packages such as Three Kingdoms are connected to the points mall. The points mall has opened a game gift package area

TB1djHrJVXXXXaDXpXXXXXXXXXX-800-450.png

Gift package details page:

TB1zlW2JVXXXXbzaXXXXXXXXXXX-800-450.png

1. During the golden period of game promotion, package welfare highlights in gift packages, with more reasons and Opportunities are given priority to apply for public promotion resources

2. The points mall is fully promoted, uv2w in a single day, the number of gift packs that can be consumed in a single month is 1w-2w, and it can continuously guide 2000 users into the game every day. Every user who successfully redeems points can jump directly into the game!


The points amount applied for in general games are as follows:

1. Different product stars will have their own Monthly total prize pool and TOP prize limits; non-TOP prizes cannot exceed 1/3 of the TOP prize

##1000618

product star rating

Available every month
Points reward pool

One time per user Activity
Upper limit of TOP prize amount

Single activity
Upper limit of number of TOP prizes

Monthly Cumulative
Maximum Number of TOP Prize Number

Single Generation S

300000

2000

8

24

Connected TransportS

##200000

1500

6

##18

Intermodal Transport A

150000


2. Use the DAU of the game in the last week as a reference to compare all the above data Bonuses can be added as follows:

##More than 30,0006000~30,000Under 6000
Weekly average DAU

Bonus

##1.5 times

1.0 times

0.5 times

For example: a single-generation product of 5000DAU can be issued to a maximum of 1500 points per user, and can be issued to a maximum of 12 people per month.


Attachment: The gift package is completed and the material requirements provided

1. Promotional pictures, 3 JPGs, 690*450, 600*600, 240*156

2. Gift package description: 150-300 words

Client receiving gift package interface

Get gift package information interface

Interface description

Get the gift pack list, suitable for stand-alone APP to receive the gift pack in the APP, call this interface to get the gift pack code list.

Prerequisites:

Requires login authorization

Function prototype

public static void queryGifts(final IGetGiftListListener listener)
Parameter description

listener Gift package information callback

Callback interface prototype:

 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

Receive giftPackage

Interface description Receive the gift and get the corresponding gift package ID from the obtained gift package code ID list

Prerequisites :

## 1. You need to first get the giftId of the purchasable product through the "Get Gift Package Information" interface

2. Requires login authorization

Function prototype

public static void takeGifts(long giftId, ITakeGiftListener listener)

Parameter description

giftId The ID to receive the gift

listenerreceives the callback returned by the server

Callback interface prototype:

##public static interface ITakeGiftListener {

public void onTakeGiftListSuccess(boolean isSuccess);

public void onTakeGiftListError(String errMsg);

}

Server-side gift package receiving interface

Get gift package information Interface

Interface description

When the user receives it through various channels After the APP gift package is released, when the APP is launched, the APP client/server can query the backend of the Digital Entertainment APP to see if the user has any gift packages that need to be issued. If the query is successful, a record list is returned.

Prerequisites:

Requires login authorization

Function prototype: ##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


Parameter description:                                               

#Request parametersuser_str_id##game_item_id##1APPappkeyRequiredString12654##RequiredStringTrecord_listReturns the order ID after the APP server creates the orderRequiredStringThe following fields in the returned information represent the gift package ID##is_successerror_codemsg

digital entertainment user ID

Required

String

xxxxx

The purchased item ID (this ID is provided by CP, and CP verifies the legitimacy of this item ID). You can leave it blank or fill in multiple fields, separated by commas (if you leave it blank, all records that meet the conditions for the user will be returned).

Optional

String

##12312312312

status
Filter results by status. 0 means all, 1 means to be activated, 2 means activated, 3 means expired. Default is 1.

Optional

Int

app_str_id

ts

Time stamp

Required

long

223433232

sign

Sign the data of the current request for signature. It must be optional and depends on the data items in the current Request request. It cannot be hard-coded in the code.

Required

String

##Sdf98sdf98sdf89sdf9sdf9sd

Return successfully

is_success

Whether the request is processed Success

cpItemId

Failure return

Whether the request is processed successfully

Required

String

##F

Error code

Required

String

605

Error message

Required

String

Request failed


Response sample:

##{

Receive gift package

Interface description

##After the APP completes the distribution of the gift package, it notifies the digital entertainment server that the gift package has been successfully activated. It will not return the next time it requests the list of gift packages to be activated. The gift pack.

Function prototype: 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


Parameter description:

##Return successfully

There are 2 gift packages

{

“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"}]

}

No eligible gift package:

{

“is_success”:”T”,

“record_list”: []

}

Failure return

“is_success”:”F”,

“error_code ”:”FAIL”,

“msg”:”system error”

}

user_str_iddigital entertainment user IdRequiredString##app_order_id##RequiredLong654897APPappkeyRequiredString 12654TimestampRequiredLongSign the data of the current request to sign. It must be optional and depends on the data items in the current Request request. It cannot be hard-coded in the code. Whether the request is processed Successis_successWhether the request processing was successfulRequiredStringF##error_codemsg
#Request parameters

##xxxxx

The order id associated with the issuance completed on the APP side is generated by cp, and the digital entertainment server only records

Required

String

12312312312

##record_id
The record returned when querying records id

app_str_id

ts

##223433232

sign

Required

String

##Sdf98sdf98sdf89sdf9sdf9sd

Return successfully

is_success

##Required

String

T

app_order_id

Returns the order ID after the APP server creates the order
Required

String

##1231231

##Failure returns

Error code

Required

String

FAIL

Error message

Required

String

Request failed

# Response sample

Successful return { “is_success”:”T”,Return on failureThe gift package record has been activated or expired{

“app_order_id”:”1235654”

}

"is_success": "F",

"app_order_id": "1235654",

"error_code": "RECORD_STATUS_INVALID",

"msg": "Gift package status Error”

}

The gift package record does not exist

{

“is_success”:”F”,

"app_order_id": "1235654",

"error_code": "RECORD_NOT_FOUND",

"msg": "Issuance record not found"

}