设备风险识别事件及返回参数
设备风险识别产品主要适用于对移动App上，有效助力企业生成唯一性设备ID，甄别设备环境异常，包括：模拟器检测、多开检测、恶意工具检测、恶意篡改设备参数等。设备风险识别产品可以应用到注册、登录、下单、领券等业务场景，通过传入设备信息，精准识别设备风险，有效打击黑灰产行为。
版本介绍
为匹配不同行业、企业不同发展阶段的风控需求，设备风险识别分为基础版、增强版，两者的差异对比如下：
功能特性 | 基础版 | 增强版本 |
实时计算 | 支持 | 支持 |
服务返回 | 风险标签 | 风险标签、设备唯一ID |
日志服务（SLS）投递 | 不支持 | 支持，用户可授权进行日志投递，免费存储一年 |
服务事件参数
服务事件参数是指公共参数中ServiceParameters字段的请求参数，为JSON格式。以下表格为设备风险识别服务（含基础版、增强版）事件需传入的请求参数。
设备风险SDK（适用于Android、iOS原生APP）
字段名称 | 字段描述 | 数据格式 | 样例数据 | 是否必填 | 备注说明 |
deviceToken | 通过设备风险SDK获取deviceToken | String | Tk9SSUQuMS***************************ZDNmNWY5NzQxOW1oLTE2MjI2NDIyNjc4MzAtZmIwODAwOGE2NGZWFhdDgzMTBLUlVSU0VoWWVNcW82ZkZlZWJBY0s0QmFGOGNyT3poY2txZXVqRjMyc1lCaDdBL2pzRTRPdXhmZjU5NEgxcGlQMGFEU1AwajZpa1ZTQ1FlbE5IQmZkTklZVzVkV2VDM1hHNUMreVRtMXFFemp3PT0= | 是 | 正常情况下token的长度在600字节左右，在网络较差的场景下token长度会超过2.5K。如果出现了大量的长token，请先检查客户端的网络是否畅通，其次请确保SDK的init接口和getSession接口调用间隔大于2秒。 |
JS_SDK（适用于web/H5/wap）
字段名称 | 字段描述 | 数据格式 | 样例数据 | 是否必须 |
uaToken | 通过JS版SDK获取uaToken | String | 114#1JEIyxQYTTob/sbrMoRUrCPGm3cY+KzCOPdgR+S5yBRYGOGvOQ7a/y31ZkEW9j7Nu30JbRCk0RS8QdcB9XAfgqqQWVOqdQYpp1wQ29bhnA0HI5rKMJ7RbJCaNPFFYHgZKs8q889wQn | 是 |
webUmidToken | 通过JS版SDK获取webUmidToken | String | HV02PAAZ0b0b524c2a784b8e5c18ddb90851893e100024 | 是 |
返回参数
设备风险识别服务的返回参数包括设备ID、设备风险标签。
设备ID
详见返回参数Data中extend字段，仅增强版（device_risk_pro）支持返回设备ID。
设备风险标签
详见返回参数Data中tags字段，若返回多个标签则以英文逗号分割，部分标签含义如下：
值 | 释义 |
is_emulator | 设备疑似模拟器 |
is_rooted | 设备疑似root |
is_virtual | 疑似多开环境 |
....... | 您可以登录风险识别控制台进入接入管理模块查看更多设备标签释义，点击前往 |
关于公共返回参数的更多信息，请参见公共返回参数。