rewardDistributionCheck:小游戏发奖查询安全

更新时间:2025/06/25 访问次数:8

功能描述

该方法用于在用户领取游戏内奖励前,实时评估该账号在淘宝平台是否有过非安全历史行为。开发者可根据返回的安全状态动态调整奖励发放策略,减少资损风险。

注意:

1)针对非安全用户,只能适量降低奖励数量避免资损,不能完全不发放奖励。

2)禁止在前端透出“风险用户/非安全用户”等敏感提示,奖励差异需通过玩法设计自然过渡。如安全用户非安全用户的奖励不同,则前台奖励的表达上需要兼顾,如“最高xx奖励”。

3)出现接口超时等情况时,安全结果可能缺省(未知)。用户安全状态未知时,游戏侧可自行根据奖励成本、用户体验进行决策。若奖励成本较大,建议将未知用户视为非安全用户,发放兜底奖励;若活动以用户体验为重,建议将未知用户视为安全用户,发放正常奖励。

入参

方法通过入参securyType,区分资金权益(如购物红包、品类卷)以及非资金权益(普通游戏道具等),资金权益将对应更高水位的安全标准,请根据实际奖励类型选择对应值。

名称

类型

类型

描述

securyType

String

BENEFIT / NORMAL

必填

权益类型:

  • 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)
})

FAQ

关于此文档暂时还没有FAQ
返回
顶部