易盾智能风控系统支持客户给予业务，不同场景下，回传给风控系统不同的检测数据，以期达到更好的检测效果。基于不同类型场景，易盾提供以下 extData 数据构建建议：

• 通用场景
• 社交场景
• 营销场景
• 电商场景
• 支付场景

 

通用场景

 

注册场景

用户注册当前应用账号，extData Json内容：

参数名	类型	传入说明	描述	备注
hashPassword	String	强烈建议	加密后的用户密码
appVersion	String	强烈建议	当前客户端应用版本号
payingUser	String	建议参数	是否为付费用户	取值true、false，用于初步判定用户付费or黑产倾向
registerPaltform	String	第三方注册平台，如果非三方平台注册，可传空
verified	String	建议参数	是否认证（信息认证、实名认证等）	取值true、false，用于确认用户是否已做实名认证
identity	String	建议参数	用户身份	用于区分签约主播、高级vip、普通用户等
gender	String	建议参数	注册用户的性别，如无，可传空
inviterAccount	String	建议参数	邀请注册人的账号名 / 邀请码等，如无，可传空
registerChannel	String	建议参数	注册用户来源渠道，如无，可传空

 

登录场景

用户登录当前应用，extData Json内容：

参数名	类型	传入说明	描述	备注
hashPassword	String	强烈建议	加密后的用户密码
appVersion	String	强烈建议	当前客户端应用版本号
gender	String	建议参数	注册用户的性别，如无，可传空
age	Integer	建议参数	用户年龄
vaildCustomer	Integer	建议参数	用户名或密码验证结果（0：表示失败，1：表示成功）	可用于撞库登录识别
registerChannel	String	建议参数	注册用户来源渠道，如无，可传空
registerData	String	建议参数	用户注册账号日期
registerDay	Integer	建议参数	用户注册天数

 

更新账号场景

用户更新当前账号信息，extData Json内容：

参数名	类型	传入说明	描述	备注
appVersion	String	强烈建议	当前客户端应用版本号
newEmail	String	强烈建议	变更后的邮箱地址，如果需要加密，支持传入hash值，hash算法：md5(newEmail)
newPhone	String	强烈建议	变更后的手机号码，如果需要加密，支持传入hash值，hash算法：md5(newPhone)
newName	String	建议参数	变更后的昵称
gender	String	建议参数	用户的性别，如无，可传空
age	Integer	建议参数	用户年龄
registerChannel	String	建议参数	注册用户来源渠道，如无，可传空

 

浏览

用户浏览app中某个具体的页面，建议只在重要页面埋点，extData Json内容：

参数名	类型	传入说明	描述	备注
appVersion	String	强烈建议	当前客户端应用版本号
pageName	String	强烈建议	浏览页面名称/ID
visitSource	String	强烈建议	浏览页面来源，进入页面的途径。如无，可传空
contentID	String	建议参数	浏览页面内容ID，用于重点定位防控内容。

 

签到

用户在app中进行签到领取福利，extData Json内容：

参数名	类型	传入说明	描述	备注
appVersion	String	强烈建议	当前客户端应用版本号
signDate	String	强烈建议	当前签到日期
haveSignDays	Integer	强烈建议	累计签到天数
signAwardID	String	建议参数	签到奖励内容 ID

 

下载

用户通过app下载指定的内容（比如推广的app、app内的视频、音频、图片等），extData Json内容：

参数名	类型	传入说明	描述	备注
appVersion	String	强烈建议	当前客户端应用版本号
downloadContent	String	强烈建议	下载目标内容名称/ID
downloadSize	Integer	强烈建议	下载内容大小，通常用“MB”作为计量单位
price	String	建议参数	下载内容消耗的金额，可以是app内货币等。如无，可传空

 

有奖浏览

用户通过浏览内容获取奖励，extData Json内容：

参数名	类型	传入说明	描述	备注
contentID	String	强烈建议	浏览内容ID
contentType	String	强烈建议	浏览内容类型，比如文章、视频、图片等
isAward	Integer	建议参数	事件是否能够获取激励，一般0表示有，1表示没有
awardID	String	建议参数	如事件产生了激励，可传递激励内容ID。如无，可传空

 

社交场景

 

私信消息

社交用户发送私信消息（群聊/私聊），extData Json内容：

参数名	类型	传入说明	描述	备注
appVersion	String	强烈建议	当前客户端应用版本号
targetName	String	强烈建议	发送消息对象昵称 / 群名
targetPhone	Integer	强烈建议	发送消息对象手机号码，如无，可传空。 如果需要加密，支持传入hash值
gender	String	建议参数	用户的性别
targetGender	String	建议参数	发送消息对象性别，如无，可传空
content	String	建议参数	发送消息内容（文本消息）
age	Integer	建议参数	用户年龄
registerChannel	String	建议参数	用户注册来源渠道，如无，可传空

 

点赞

用户为某个内容、商品、人物等点赞支持，extData Json内容：

参数名	类型	传入说明	描述	备注
likeContentID	String	强烈建议	点赞对象内容ID
relation	String	强烈建议	点赞者与被点赞内容拥有者之前的社交关系，可以自定义内容。 比如：0代表没关系、1代表好友、2代表关注等
likeTimes	Integer	建议参数	当前内容累计被点赞次数，用于判定业务统计数字与风控系统次数之间是否存在偏差。 如无，可传空
isAward	Integer	建议参数	事件是否能够获取激励，一般0表示有，1表示没有
awardID	String	建议参数	如事件产生了激励，可传递激励内容ID。如无，可传空

 

评论

用户对查看阅读的功能进行评论，extData Json内容：

参数名	类型	传入说明	描述	备注
commentContentID	String	强烈建议	评论对象内容ID
relation	String	强烈建议	评论者与被评论内容拥有者之前的社交关系，支持自定义。 比如：0代表没关系、1代表好友、2代表关注等
commentTimes	Integer	建议参数	当前内容累计被评论次数，用于判定业务统计数字与风控系统次数之间是否存在偏差。 如无，可传空
commentContent	String	建议参数	评论内容。如无，可传空
isAward	Integer	建议参数	事件是否能够获取激励，一般0表示有，1表示没有
awardID	String	建议参数	如事件产生了激励，可传递激励内容ID。 如无，可传空

 

转发

用户转发内容，extData Json内容：

参数名	类型	传入说明	描述	备注
transContentID	String	强烈建议	转发对象内容ID
relation	String	强烈建议	转发者与被转发内容拥有者之前的社交关系，可以自定义内容。 比如：0代表没关系、1代表好友、2代表关注等
transTargetChannel	String	强烈建议	转发目标渠道，可以自定义内容。 比如：0代表自身app、1代表微信渠道、2代表新浪微博渠道等
tansTargetUser	String	建议参数	如果转发内容给到目标是其他用户/群，可以传递目标用户ID/群ID。 如无，可传空。 与外层“target”字段可区分使用，一个代表被转发内容的所有者，一个代表分享目标
tansTimes	Integer	建议参数	当前内容累计被转发次数，用于判定业务统计数字与风控系统次数之间是否存在偏差。 如无，可传空
isAward	Integer	建议参数	事件是否能够获取激励，一般0表示有，1表示没有
awardID	String	建议参数	如事件产生了激励，可传递激励内容ID。 如无，可传空

 

收藏

用户收藏感兴趣的内容，extData Json内容：

参数名	类型	传入说明	描述	备注
collectContentID	String	强烈建议	收藏对象内容ID
isAward	Integer	建议参数	事件是否能够获取激励，一般0表示有，1表示没有
awardID	String	建议参数	如事件产生了激励，可传递激励内容ID。如无，可传空

 

分享

用户分享内容，extData Json内容：

参数名	类型	传入说明	描述	备注
shareContentID	String	强烈建议	分享对象内容ID
shareTargetChannel	String	强烈建议	分享目标渠道，可以自定义内容。 比如：0代表自身app朋友、1代表自身app瀑布流、2代表微信朋友圈、3代表新浪微博渠道等
shareTargetUser	String	建议参数	如果分享内容给到目标是其他用户/群，可以传递目标用户ID/群ID。 如无，可传空。 与外层“target”字段可区分使用，一个代表被分享内容的所有者，一个代表分享目标
isAward	Integer	建议参数	事件是否能够获取激励，一般0表示有，1表示没有
awardID	String	建议参数	如事件产生了激励，可传递激励内容ID。 如无，可传空

 

关注

用户关注其他用户，extData Json内容：

参数名	类型	传入说明	描述	备注
attentContentID	String	强烈建议	关注对象内容ID/用户ID
isAward	Integer	建议参数	事件是否能够获取激励，一般0表示有，1表示没有
awardID	String	建议参数	如事件产生了激励，可传递激励内容ID。如无，可传空

 

送礼/打赏

用户给指定目标送礼，extData Json内容：

参数名	类型	传入说明	描述	备注
rewardContentID	String	强烈建议	打赏目标内容ID/用户ID
giftID	String	建议参数	礼物/打赏内容ID，可用于评估识别打赏内容与用户等级匹配度等。 如无，可传空
giftValue	Integer	建议参数	礼物/打赏内容价值（有时直接使用金钱打赏），可以自定义数值大小标定。 如无，可传空

 

加好友/匹配

用户添加好友，或者匹配聊天对象、对局对象等，extData Json内容：

参数名	类型	传入说明	描述	备注
serverName	String	强烈建议	如是游戏，传递当前角色所在游戏区服。 如无，可传空
gender	String	建议参数	当前用户性别
targetLevel	Integer	建议参数	加好友/匹配对象等级。如无，可传空
targetGender	String	建议参数	加好友/匹配对象性别
psText	String	建议参数	加好友/匹配附言。如无，可传空

 

营销场景

 

抽奖动作

用户点击开启抽奖，extData Json内容：

参数名	类型	传入说明	描述	备注
sourceChannel	String	建议参数	用户进入活动的渠道，字段内容可自定义。 如无，可传空
preCondition	String	建议参数	标记用户是否已经满足抽奖条件。 比如：0满足；1不满足。如无，可传空

 

抽奖结果

用户参与抽奖活动，抽奖结束后，extData Json内容：

参数名	类型	传入说明	描述	备注
result	Integer	强烈建议	抽奖结果（是否中奖）。 比如：0没中奖，1中奖
awardID	String	建议参数	用户获取到的奖品ID，可自定义。 如无，可传空
awardValue	Integer	建议参数	奖品折算后的价值（不一定对应人民币等货币单位）。 如无，可传空

 

领券

用户领取优惠券，extData Json内容：

参数名	类型	传入说明	描述	备注
couponType	String	强烈建议	用户领取的优惠券的类型。如无，可传空
couponValue	Integer	强烈建议	优惠券金额（货币：人民币，计量单位：元）
couponSource	String	建议参数	优惠券来源类型，可自定义。如无，可传空
validity	Integer	建议参数	优惠券有效时长（-1表示长久有效）

 

抢红包

用户参加抢红包活动、社区里面抢红包，extData Json内容：

参数名	类型	传入说明	描述	备注
prize	Integer	强烈建议	红包金额（货币：人民币，计量单位：元）
redPacketType	String	建议参数	红包来源，可自定义。如无，可传空
redPacketOwner	String	建议参数	如果红包来源用户，则传递发红包者的用户ID

 

发起拼团

用户发起拼团，extData Json内容：

参数名	类型	传入说明	描述	备注
groupID	String	强烈建议	团ID
commodityID	String	强烈建议	团商品ID
commodityPrize	Integer	建议参数	商品单价（货币：人民币，计量单位：元）
discounts	Integer	建议参数	团商品优惠金额（货币：人民币，计量单位：元）

 

参与拼团

用户参与拼团，extData Json内容：

参数名	类型	传入说明	描述	备注
groupID	String	强烈建议	团ID
commodityID	String	强烈建议	团商品ID
groupOwner	String	强烈建议	团拥有者账号ID
commodityPrize	Integer	建议参数	商品单价（货币：人民币，计量单位：元）
discounts	Integer	建议参数	团商品优惠金额（货币：人民币，计量单位：元）

 

电商场景

 

浏览商品

用户浏览目标商品，extData Json内容：

参数名	类型	传入说明	描述	备注
commodityID	String	强烈建议	浏览商品ID
commodityType	String	建议参数	标浏览商品类型，比如数码产品、虚拟产品、日用品等
commodityPrize	Integer	建议参数	浏览商品价格（货币：人民币，计量单位：元）

 

收藏/加入购物车

用户收藏或将商品放入购物车，且因此获得优惠，extData Json内容：

参数名	类型	传入说明	描述	备注
commodityID	String	强烈建议	收藏商品ID
commodityType	String	建议参数	收藏商品类型，比如数码产品、虚拟产品、日用品等
commodityPrize	Integer	建议参数	收藏商品价格（货币：人民币，计量单位：元）
isAward	Integer	建议参数	事件是否能够获取激励，一般0表示有，1表示没有
awardID	String	建议参数	如事件产生了激励，可传递激励内容ID。如无，可传空

 

购买/下单

用户购买商品，可以是实体商品，也可以是虚拟商品，extData Json内容：

参数名	类型	传入说明	描述	备注
commodityID	String	强烈建议	购买商品ID
commodityType	String	建议参数	购买商品类型，比如数码产品、虚拟产品、日用品等
commodityPrize	Integer	建议参数	购买商品价格（货币：人民币，计量单位：元）
isDiscount	Integer	建议参数	购买商品是否使用了折扣，一般0表示有，1表示没有
discount	Integer	建议参数	如使用了折扣，折扣的金额（货币：人民币，计量单位：元）
couponID	String	建议参数	如使用了折扣，提供折扣的优惠券的ID
receiverName	String	建议参数	收件人姓名
receiverPhone	Integer	建议参数	收件人手机号码，如果需要加密，支持传入hash值，hash算法：md5(receiverPhone)
reveiverAddress	String	建议参数	收件人地址（全部地址，如中国浙江省滨江区长河街道惠丰大厦7102）
isAward	Integer	建议参数	事件是否能够获取激励，一般0表示有，1表示没有
awardID	String	建议参数	如事件产生了激励，可传递激励内容ID。如无，可传空

支付场景

代充识别

用于识别 iOS 支付场景下是否存在代充问题， 需要在支付前、支付后均进行埋点（用同一个业务id即可）

参数名	类型	传入说明	描述	备注
orderReceipt	json	必传	订单支付成功后调用。Apple的订单收据，解析后的json格式。支付前调用传空。

支付后：orderReceipt字段需要传入的内容为标准JSON，示例中省略了部分字段

"orderReceipt": {
          'environment': 'Sandbox',
          'receipt': {
            'adam_id': 0,
            'app_item_id': 0,
            'application_version': 2013,
            'bundle_id': 'com.netease.UUIDDemo16',
            'download_id': 0,
            'in_app':[
                      {
                        'original_purchase_date': '2015-05-20 03:51:24 Etc/GMT',
                        'original_purchase_date_ms': 1632809505530,
                        'original_transaction_id': 1000000644961768,
                        ...
                      },
                      ...
                    ]
          },
        'status': 0
  }

绑卡

用户绑定银行卡，extData Json内容：

参数名	类型	传入说明	描述	备注
bankCard	String	强烈建议	银行卡号，如果需要加密，支持传入hash值，hash算法：md5(bankCard)
cardType	String	建议参数	卡类型，比如：借记卡、信用卡等
bankCardPhone	String	建议参数	银行卡绑定手机号码，如果需要加密，支持传入hash值，hash算法：md5(bankCardPhone)
credentialsValib	Integer	建议参数	四要素认证是否成功，一般0表示有，1表示没有
noteValib	Integer	建议参数	预留手机短信认证是否成功，一般0表示有，1表示没有

 

提现

用户进行提现操作，extData Json内容：

参数名	类型	传入说明	描述	备注
withdrawAccountID	String	强烈建议	提现目标账号 ID，如微信账号ID等
withdrawAmount	Integer	强烈建议	提现金额（货币：人民币，计量单位：元）
withdrawChannel	String	强烈建议	提现目标渠道，如银行卡、微信、支付宝等

 

充值

用户进行账号充值，extData Json内容：

参数名	类型	传入说明	描述	备注
rechargeAmount	Integer	强烈建议	充值金额（货币：人民币，计量单位：元）
rechargeChannel	String	强烈建议	充值渠道，如银行卡、微信、支付宝、优惠券等
rechargeAccountID	String	强烈建议	充值账号ID，如支付宝ID、优惠券ID等
isAward	Integer	建议参数	事件是否能够获取激励，一般0表示有，1表示没有
awardID	String	建议参数	如事件产生了激励，可传递激励内容ID。如无，可传空

 

支付

用户购买商品后进行支付，extData Json内容：

参数名	类型	传入说明	描述	备注
payChannel	String	强烈建议	支付渠道，如银行卡、微信、支付宝、自身app余额等
payAmount	Integer	强烈建议	支付金额（货币：人民币，计量单位：元）
payAccountID	String	强烈建议	支付账号ID，比如支付宝ID
payResult	Integer	建议参数	支付结果（成功或失败），一般0表示有，1表示没有
voucherTime	String	建议参数	支付凭证上的时间戳