业务扩展参数
2024.04.18 10:17:45
按用户、设备、场景传入业务扩展参数，辅助反垃圾结果判定
用户扩展参数
根据用户信息输出用户画像，并与易盾自有画像库比对，辅助反垃圾结果判定
| 参数名称 | 类型 | 是否必选 | 最大长度 | 描述 |
|---|---|---|---|---|
| account | String | N | 128 | 用户唯一标识，与易盾账号画像库匹配，建议抄送，辅助机审策略精准调优，如业务方同时接入易盾反外挂，则此账号传值需要与反外挂接入中的roleAccount（Android），或user_account（iOS）一致 |
| profileUrl | string | N | 2048 | 用户主页地址，用于传输这次数据的用户ID的后台地址，便于快速跳转 |
| phone | string | N | 64 | 手机号，与易盾风险库匹配。默认国内手机号，如有海外手机，需包含国家地区代码，格式为“+447410xxx186（+44即为国家码）”。如果需要加密，支持传入hash值，hash算法：md5(phone) |
| nickname | String | N | 128 | 用户昵称，建议抄送，辅助机审策略精准调优 |
| gender | Number | N | 4 | 用户性别，0未知，1男，2女，在社交、直播场景建议抄送，辅助策略精准调优 |
| age | Number | N | 4 | 用户年龄，0未知，在社交场景建议抄送，辅助策略精准调优 |
| level | Number | N | 4 | 用户等级，0未知，1初级，2中级，3高级，其他值请与易盾策略约定，建议抄送，辅助策略精准调优 |
| registerTime | Number | N | 13 | 注册时间，UNIX 时间戳(毫秒值) |
| friendNum | Number | N | 20 | 好友数，在社交、直播场景中使用，建议抄送 |
| fansNum | Number | N | 20 | 粉丝数，在社交、直播场景中使用，建议抄送 |
| isPremiumUse | Number | N | 4 | 是否付费用户，0为默认值，1为付费，建议抄送，易盾将结合该信息综合判断 |
| role | string | N | 32 | 用户类型角色，可针对不同的角色配置不同的策略。角色与易盾策略约定即可 |
设备扩展参数
根据设备信息输出设备画像，并与易盾自有设备画像库比对，辅助反垃圾结果判定
| 参数名称 | 类型 | 是否必选 | 最大长度 | 描述 |
|---|---|---|---|---|
| deviceId | String | N | 128 | 用户设备 id，与易盾设备画像库匹配，明文请转大写传入；MD5加密请明文转大写后MD5计算，再转大写传入，建议抄送 |
| deviceType | Number | N | 4 | 用户设备id的类型，0:其他，10:IMEI，11:AndroidID，12:IDFA，13:IDFV，14:MAC ，20:IMEI_MD5，21:AndroidID_MD5，22:IDFA_MD5，23:IDFV_MD5，24:MAC_MD5 |
| mac | String | N | 64 | 用户设备mac信息,与易盾设备画像库匹配，建议抄送 |
| imei | String | N | 64 | 国际移动设备识别码，与易盾设备画像库匹配，建议抄送 |
| idfa | String | N | 64 | iOS设备标识码，与易盾设备画像库匹配，建议抄送 |
| idfv | String | N | 64 | iOS设备标识码 ，与易盾设备画像库匹配，建议抄送 |
| appVersion | String | N | 32 | APP版本号 ，可根据不同版本号配置不同策略，建议抄送 |
场景扩展参数
场景扩展参数，有助于通过业务场景维度辅助反垃圾结果判定
| 参数名称 | 类型 | 是否必选 | 最大长度 | 描述 |
|---|---|---|---|---|
| receiveUid | String | N | 64 | 接受消息的用户标识，私聊/评论回复场景使用，易盾可根据该id关联检测，辅助机审策略精准调优 |
| relationship | int | N | 11 | 收发消息者好友关系，1接收人关注发送人，2发送人关注接收人，3互相关注，4互未关注，私聊/评论场景抄送 |
| groupId | String | N | 32 | 群聊id，群聊场景使用，建议抄送，辅助机审策略精准调优 |
| roomId | String | N | 32 | 聊天室/直播/游戏房间，派对房/直播场景使用，可根据不同的房间设置不同策略，建议抄送，辅助机审策略精准调优 |
| topic | String | N | 128 | 文章/帖子id，发帖/动态场景使用，易盾可根据该id，关联检测，辅助机审策略精准调优 |
| commentId | String | N | 32 | 主评论id，围绕主评论盖楼场景使用，建议抄送，辅助机审策略精准调优 |
| commodityId | String | N | 32 | 商品id，直播卖货/商品介绍场景使用，可根据商品类型设置策略，建议抄送，辅助机审策略精准调优 |
其他拓展参数
| 参数名称 | 类型 | 是否必选 | 最大长度 | 描述 |
|---|---|---|---|---|
| ip | String | 否 | 128 | 用户IP地址，建议抄送，辅助机审策略精准调优 |
| relatedKeys | String | 否 | 512 | String数组，多个关联Key以逗号分隔（"xxx,xxx"），最多三个Key，单个Key长度不超过128，适用于私聊/评论/跟帖等情况同一用户或不同用户发送多条违规内容关联检测的场景。如需要检测同一评论下的同一用户或不同用户发送违规内容盖楼场景，Key传值方式可以为（"评论ID,用户ID"） |
| extStr1 | String | 否 | 128 | 自定义扩展参数 |
| extStr2 | String | 否 | 128 | 自定义扩展参数 |
| extLon1 | Number | 否 | 2^63-1 | 自定义扩展参数 |
| extLon2 | Number | 否 | 2^63-1 | 自定义扩展参数 |
| extension | Json | 否 | 30000 | 自定义扩展参数，JSON字符串格式。如："{"keyName1":"value1","keyName2":"value2"}" |
