AMS Awards

Reward after submitting the survey

Support AMS package reward distribution function; for games that have already integrated AMS email delivery function, when this function is enabled, the survey system can automatically trigger the reward distribution after the user submits the survey.

1. Only supports games with integrated email delivery functionality.

2. The survey must enable one of the following features: MSDK login verification/INTL login verification/parameter passing (strict verification mode)/parameter passing (non-verification mode). Each respondent can only receive a reward once;

3. Each respondent can only be awarded once; respondents who have already successfully received an award cannot trigger the award again by answering the survey again.

【STEP 1】AMS Package Configuration

Please configure the AMS gift pack order in the AMS interface platform - Gift Pack Warehouse (mrms), which is the item warehouse, to obtain the AMS gift pack order number and gift pack group number.

Note: For domestic use, the channel must be configured as the MUR survey reward application [IEG-AMS-11836].

Overseas usage channels must be configured as MUR survey reward application [IEG-AMS-4000046]

【STEP 2】Award Configuration

Enable the "reward after survey submission" feature in the surveys that require rewards, and configure the AMS gift package order number, gift package group number, business abbreviation, and AMS environment parameters.

If the game uses gopenid for awarding prizes, then enable gopenid.

Configure reward parameters

【STEP 3】Pass award parameters

The survey must enable one of the following features: MSDK login verification/INTL login verification/parameter passing (strict verification mode)/parameter passing (non-verification mode). The game client should inject the following four reward parameters into the survey link by concatenation for awarding purposes. If some parameters are not needed, they can be omitted. The parameters are described as follows:

Parameter Name	Explanation
sPlatId	Platform type, such as IOS:0, Android:1
sArea	For channels such as QQ and WeChat, please provide the corresponding numbers.
sPartition	Mobile use, residential area
sRoleId	Character ID, provided when shipping into the game

Survey link injection with reward parameter example

Situation	Injection Instructions	Example link
Original survey link	--	https://in.survey.imur.tencent.com/?sid=5e8d767b76051f46707cf692
MSDK Login Verification	4 award parameters Directly spliced in After the survey link	https://in.survey.imur.tencent.com/?sid=5e8d767b76051f46707cf692&sPlatId={sPlatId}&sArea={sArea}&sPartition={sPartition}&sRoleId={sRoleId}
Parameter Passing Interface (No verification mode)	Four award parameters Directly concatenated with After the survey link	https://in.survey.imur.tencent.com/?sid=5e8d767b76051f46707cf692&openid={答题者openid}&sPlatId={sPlatId}&sArea={sArea}&sPartition={sPartition}&sRoleId={sRoleId}
Parameter Passing Interface (Strict Validation Mode)	Four award parameters Concatenate the value assigned to redirect with the link, and then encode the value of redirect.	https:// inapi.survey.imur.tencent.com/autologin?sid =5e8d767b76051f46707cf692&uid=user_id&timestamp=1573455797 &source=dwk&info=extra_info&redirect=https%3A%2F%2F in.survey.imur.tencent.com%2F%3Fsid%3D5e8d767b76051f46707cf692 %26lang%3Dzh-CHS%26ADTAG%3Dsid.5e8d767b76051f46707cf692 %26sPlatId%3D{sPlatId}%26sArea%3D{sArea}%26sPartition %3D{sPartition}%26sRoleId%3D{sRoleId} &sign=2ac5ab8ce6a9b306e07dc2664fe7d175

【STEP 4】Interface Application

The AMS reward triggered by the survey requires prior application for the in-game lottery interface. Please contact via WeChat for Business:IMUR问卷系统助手

【STEP 5】Complete

In the game, when a survey is released and the respondents submit the survey, the survey system will automatically trigger the AMS gift package single award (the prize name will be displayed as the gift package group name configured in step 1).

In-game survey completion reward success notification

Award Records Inquiry

Click on "Award Records" to view the prize-triggering status of all survey accounts.

Check reward records

AMS response code description

AMS response code	Situation Description	Recommended Action
0	Award successfully granted	/
空或-100	Not a test number	To call the gift package interface in the testing environment, you need to use a test account. Please go to the test account system to register, bind, and associate the openid first.openid
100002	The gift pack depletion requires rollback eligibility.	Go to the gift pack warehouse to adjust the configuration of the gift pack list, allowing each account to claim multiple times or increasing the total number of gift packs.
-9012	Server region and other parameters are abnormal	It is necessary to confirm whether the values of the four parameters sPlatId, sArea, sPartition, and sRoleId are correct.
-9081	No valid gopenid was obtained when calling the gopenid interface.	Use the openid system in the game: Turn off the "Use gopenid for reward settings" in the settings popup. Using the gopenid system in the game: If the user has not registered a game character or if there is an exception with the gopenid service, check if the account status is normal.