API(跳转/回调/发奖）
最后更新于
这有帮助吗？
问卷系统支持内嵌投放及答题后跳转、参数回调等功能，用户可根据实际需要按以下各项设置。
功能开启后，在设置弹窗中填写跳转的链接（链接需为包含http://或http://前缀的地址），设置完成后当答题者提交问卷后浏览器将跳转到您设置的链接上。
提供登录态回调的功能，开发者可自行配置回调地址和密钥，问卷系统将登录态等参数回调给开发者，开发者获取参数后可用于奖励发放。
投放时客户端在问卷链接中注入callback参数，用以区分该次提交后回调到哪个回调地址中。最多可配置10个回调地址，具体回调到哪个实际由客户端指定。
注：每次提交问卷仅能回调到一个地址中，若问卷链接未注入callback参数，默认回调到地址1。
开发者回调接口url?sid=5da414769e8aa80019305e32×tamp=1573556685&uid=test_user&user_type=third_party&uid_source=qq&info=afdadsfasdfasdf&callback_params=callbackparams&sign=38408d6222e1a4c6fa598e4820443ca8
系统提供开放接口用以查询指定问卷的答卷信息、答题统计数据、题型统计等，开启功能后系统将自动生成密钥（密钥支持自定义修改），凭密钥调用接口查询问卷信息；关闭后不可调用查询。
系统支持AMS礼包发奖，可通过问卷设置—提交问卷后发奖功能实现；对于已对接AMS邮件发货功能的游戏，开启此功能时，用户提交问卷后，问卷系统可自动触发奖励发放。
请在AMS接口平台—礼包仓库(mrms)，即道具仓库中配置AMS礼包单，以获取AMS礼包单号、礼包组编号。
注：国内使用渠道务必配置为 MUR问卷发奖应用 [IEG-AMS-11836]
海外使用渠道务必配置为 MUR问卷发奖应用 [IEG-AMS-4000046]
在需要发奖的问卷中开启“提交问卷后发奖”功能，并配置AMS礼包单号、礼包组编号、业务缩写、AMS环境参数
若游戏内是使用的是gopenid发奖，则开启gopenid即可
问卷务必开启MSDK登录验证/参数传递（严格校验模式）/参数传递（不校验模式）以上任一功能，游戏客户端把以下4个发奖参数用拼接的方式注入问卷链接，用以发奖，参数说明如下：
参数名
说明
sPlatId
平台类型，如IOS:0、安卓:1
sArea
对应到渠道，如手Q、微信，请传对应的数字
sPartition
手机端使用，小区
sRoleId
角色ID，发货到游戏内时提供
情况
注入说明
示例链接
原始问卷链接
--
https://in.survey.imur.tencent.com/?sid=5e8d767b76051f46707cf692
MSDK登录验证
4个发奖参数
直接拼接在
问卷链接后
https://in.survey.imur.tencent.com/?sid=5e8d767b76051f46707cf692&sPlatId={sPlatId}&sArea={sArea}&sPartition={sPartition}&sRoleId={sRoleId}
参数传递接口（不校验模式）
4个发奖参数
直接拼接在
问卷链接后
https://in.survey.imur.tencent.com/?sid=5e8d767b76051f46707cf692&openid={答题者openid}&sPlatId={sPlatId}&sArea={sArea}&sPartition={sPartition}&sRoleId={sRoleId}
参数传递接口（严格校验模式）
4个发奖参数
拼接在redirect所赋值的链接后再对redirect的值encode
https:// inapi.survey.imur.tencent.com/autologin?sid
=5e8d767b76051f46707cf692&uid=user_id×tamp=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
由问卷触发ams发奖需提前申请游戏内抽奖接口，请企业微信联系：IMUR问卷系统助手
在游戏中投放问卷，答题者提交问卷后，问卷系统会自动触发调用AMS礼包单发奖（奖品名称显示为step1中所配置的礼包组名称）。
点击“发奖记录”即可查看所有答题账号的触发发奖情况。
0
发奖成功
/
空或-100
不是测试号
测试环境调用发礼包接口需要使用测试号，请先前往测试号系统登记绑定并关联openid
100002
礼包扣光需要回滚资格
前往礼包仓库调整礼包单的配置，调整为每个账号可领取多次或增加礼包总数量
-9012
区服等参数异常
需要确认sPlatId、sArea、sPartition、sRoleId等四个参数值是否正确
-9081
调用gopenid接口未得到有效gopenid
1、游戏内使用openid体系：关闭设置弹窗中的“使用gopenid发奖设置” 2、游戏内使用gopenid体系：用户未注册游戏角色或者gopenid服务异常，检查账号状态是否正常
。
问卷务必开启//以上任一功能
