该方法用于在用户领取游戏内奖励前,实时评估该账号在淘宝平台是否有过非安全历史行为。开发者可根据返回的安全状态动态调整奖励发放策略,减少资损风险。
注意:
1)针对非安全用户,只能适量降低奖励数量避免资损,不能完全不发放奖励。
2)禁止在前端透出“风险用户/非安全用户”等敏感提示,奖励差异需通过玩法设计自然过渡。如安全用户非安全用户的奖励不同,则前台奖励的表达上需要兼顾,如“最高xx奖励”。
3)出现接口超时等情况时,安全结果可能缺省(未知)。用户安全状态未知时,游戏侧可自行根据奖励成本、用户体验进行决策。若奖励成本较大,建议将未知用户视为非安全用户,发放兜底奖励;若活动以用户体验为重,建议将未知用户视为安全用户,发放正常奖励。
方法通过入参securyType,区分资金权益(如购物红包、品类卷)以及非资金权益(普通游戏道具等),资金权益将对应更高水位的安全标准,请根据实际奖励类型选择对应值。
名称 |
类型 |
值 |
类型 |
描述 |
securyType |
String |
BENEFIT / NORMAL |
必填 |
权益类型:
|
名称 |
类型 |
值 |
类型 |
描述 |
result |
Boolean |
true / false |
可缺省 |
是否安全,缺省为系统unknown |
code |
String |
详看错误参数列表 |
必返回 |
|
msg |
String |
详看错误参数列表 |
必返回 |
code |
msg |
OK |
调用成功 |
PARAM_INVALID |
参数非法、无相关配置等 |
RMB_UNKNOWN_RESULT |
未知安全结果 |
SERVER_ERROR |
系统异常(下游错误或者接口异常) |
const plugin = globalThis.my.tb.getInteractiveSDK(); plugin.rewardDistributionCheck({ securyType: 'BENEFIT', }).then(res => { const {result, code, msg} = res; console.log("成功返回", result) }).catch(err => { console.log("失败返回", err) })