AMS发奖

提交问卷后发奖

支持AMS礼包发奖功能;对于已对接AMS邮件发货功能的游戏,开启此功能时,用户提交问卷后,问卷系统可自动触发奖励发放。

  1. 仅支持已对接邮件发货功能的游戏使用

  2. 对每个答题者仅发奖一次;已成功发奖的答题者再次回答问卷后不可二次触发发奖

【STEP 1】AMS礼包单配置

请在AMS接口平台—礼包仓库(mrms),即道具仓库中配置AMS礼包单,以获取AMS礼包单号、礼包组编号。

【STEP 2】发奖配置

在需要发奖的问卷中开启“提交问卷后发奖”功能,并配置AMS礼包单号、礼包组编号、业务缩写、AMS环境参数

若游戏内是使用的是gopenid发奖,则开启gopenid即可

配置发奖参数

【STEP 3】传递发奖参数

问卷务必开启MSDK登录验证/INTL登录验证/参数传递(严格校验模式)/参数传递(不校验模式)以上任一功能,游戏客户端把以下4个发奖参数用拼接的方式注入问卷链接,用以发奖,若不需要其中部分参数,不传即可,参数说明如下:

参数名

说明

sPlatId

平台类型,如IOS:0、安卓:1

sArea

对应到渠道,如手Q、微信,请传对应的数字

sPartition

手机端使用,小区

sRoleId

角色ID,发货到游戏内时提供

问卷链接注入发奖参数示例

情况

注入说明

示例链接

原始问卷链接

--

https://in.weisurvey.com/?sid=5e8d767b76051f46707cf692

MSDK登录验证

4个发奖参数

直接拼接在

问卷链接后

https://in.weisurvey.com/?sid=5e8d767b76051f46707cf692&sPlatId={sPlatId}&sArea={sArea}&sPartition={sPartition}&sRoleId={sRoleId}

参数传递接口 (不校验模式)

4个发奖参数

直接拼接在

问卷链接后

https://in.weisurvey.com/?sid=5e8d767b76051f46707cf692&openid={答题者openid}&sPlatId={sPlatId}&sArea={sArea}&sPartition={sPartition}&sRoleId={sRoleId}

参数传递接口 (严格校验模式)

4个发奖参数

拼接在redirect所赋值的链接后再对redirect的值encode

https:// inap.in.weisurvey.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】接口申请

由问卷触发ams发奖需提前申请游戏内抽奖接口,请企业微信联系:IMUR问卷系统助手

【STEP 5】完成

在游戏中投放问卷,答题者提交问卷后,问卷系统会自动触发调用AMS礼包单发奖(奖品名称显示为step1中所配置的礼包组名称)。

游戏内填答后发奖成功提示

发奖记录查询

点击“发奖记录”即可查看所有答题账号的触发发奖情况。

查询发奖记录
发奖记录详情

ams响应码说明

ams响应码
情况说明
建议操作

0

发奖成功

/

空或-100

不是测试号

测试环境调用发礼包接口需要使用测试号,请先前往测试号系统登记绑定并关联openid

100002

礼包扣光需要回滚资格

前往礼包仓库调整礼包单的配置,调整为每个账号可领取多次或增加礼包总数量

-9012

区服等参数异常

需要确认sPlatId、sArea、sPartition、sRoleId等四个参数值是否正确

-9081

调用gopenid接口未得到有效gopenid

1、游戏内使用openid体系:关闭设置弹窗中的“使用gopenid发奖设置” 2、游戏内使用gopenid体系:用户未注册游戏角色或者gopenid服务异常,检查账号状态是否正常

常见问题

如何实现用户填完问卷后自动发奖?

在问卷设置中配置了AMS礼包单,为什么提交问卷后还是领不到奖励?

最后更新于

这有帮助吗?