社交类场景
2024.03.13 15:46:30
公共参数和接口参数详情参考普通场景下的请求参数。
不同场景下建议传递不同的extData,
普通场景见普通场景、营销类场景见营销场景、电销类场景见电销场景、支付类场景见支付场景
1. 私信消息
社交用户发送私信消息(群聊/私聊)
- extData Json内容:
参数名 | 类型 | 传入说明 | 描述 | 备注 |
---|---|---|---|---|
appVersion | string | 强烈建议 | 当前客户端应用版本号 | |
targetName | string | 强烈建议 | 发送消息对象昵称 / 群名 | |
targetPhone | string | 强烈建议 | 发送消息对象手机号码,如无,可传空。如果需要加密,支持传入hash值,hash算法:md5(targetPhone) | |
gender | string | 建议参数 | 用户的性别 | |
targetGender | string | 建议参数 | 发送消息对象性别,如无,可传空 | |
content | string | 建议参数 | 发送消息内容(文本消息) | |
age | int | 建议参数 | 用户年龄 | |
registerChannel | string | 建议参数 | 用户注册来源渠道,如无,可传空 |
2. 点赞
用户为某个内容、商品、人物等点赞支持
- extData Json内容:
参数名 | 类型 | 传入说明 | 描述 | 备注 |
---|---|---|---|---|
likeContentID | string | 强烈建议 | 点赞对象内容ID | |
relation | string | 强烈建议 | 点赞者与被点赞内容拥有者之前的社交关系,可以自定义内容,比如:0代表没关系、1代表好友、2代表关注等 | |
likeTimes | int | 建议参数 | 当前内容累计被点赞次数,用于判定业务统计数字与风控系统次数之间是否存在偏差。如无,可传空 | |
isAward | int | 建议参数 | 事件是否能够获取激励,一般0表示有,1表示没有 | |
awardID | string | 建议参数 | 如事件产生了激励,可传递激励内容ID。如无,可传空 |
3. 评论
用户对查看阅读的功能进行评论
- extData Json内容:
参数名 | 类型 | 传入说明 | 描述 | 备注 |
---|---|---|---|---|
commentContentID | string | 强烈建议 | 评论对象内容ID | |
relation | string | 强烈建议 | 评论者与被评论内容拥有者之前的社交关系,可以自定义内容,比如:0代表没关系、1代表好友、2代表关注等 | |
commentTimes | int | 建议参数 | 当前内容累计被评论次数,用于判定业务统计数字与风控系统次数之间是否存在偏差。如无,可传空 | |
commentContent | string | 建议参数 | 评论内容。如无,可传空 | |
isAward | int | 建议参数 | 事件是否能够获取激励,一般0表示有,1表示没有 | |
awardID | string | 建议参数 | 如事件产生了激励,可传递激励内容ID。如无,可传空 |
4. 转发
用户转发内容
- extData Json内容:
参数名 | 类型 | 传入说明 | 描述 | 备注 |
---|---|---|---|---|
transContentID | string | 强烈建议 | 转发对象内容ID | |
relation | string | 强烈建议 | 转发者与被转发内容拥有者之前的社交关系,可以自定义内容,比如:0代表没关系、1代表好友、2代表关注等 | |
transTargetChannel | string | 强烈建议 | 转发目标渠道,可以自定义内容,比如:0代表自身app、1代表微信渠道、2代表新浪微博渠道等 | |
tansTargetUser | string | 建议参数 | 如果转发内容给到目标是其他用户/群,可以传递目标用户ID/群ID。如无,可传空 | 与外层“target”字段可区分使用,一个代表被转发内容的所有者,一个代表分享目标 |
tansTimes | int | 建议参数 | 当前内容累计被转发次数,用于判定业务统计数字与风控系统次数之间是否存在偏差。如无,可传空 | |
isAward | int | 建议参数 | 事件是否能够获取激励,一般0表示有,1表示没有 | |
awardID | string | 建议参数 | 如事件产生了激励,可传递激励内容ID。如无,可传空 |
5. 收藏
用户收藏感兴趣的内容
- extData Json内容:
参数名 | 类型 | 传入说明 | 描述 | 备注 |
---|---|---|---|---|
collectContentID | string | 强烈建议 | 收藏对象内容ID | |
isAward | int | 建议参数 | 事件是否能够获取激励,一般0表示有,1表示没有 | |
awardID | string | 建议参数 | 如事件产生了激励,可传递激励内容ID。如无,可传空 |
6. 分享
用户分享内容
- extData Json内容:
参数名 | 类型 | 传入说明 | 描述 | 备注 |
---|---|---|---|---|
shareContentID | string | 强烈建议 | 分享对象内容ID | |
shareTargetChannel | string | 强烈建议 | 分享目标渠道,可以自定义内容,比如:0代表自身app朋友、1代表自身app瀑布流、2代表微信朋友圈、3代表新浪微博渠道等 | |
shareTargetUser | string | 建议参数 | 如果分享内容给到目标是其他用户/群,可以传递目标用户ID/群ID。如无,可传空 | 与外层“target”字段可区分使用,一个代表被分享内容的所有者,一个代表分享目标 |
isAward | int | 建议参数 | 事件是否能够获取激励,一般0表示有,1表示没有 | |
awardID | string | 建议参数 | 如事件产生了激励,可传递激励内容ID。如无,可传空 |
7. 关注
用户关注其他用户
- extData Json内容:
参数名 | 类型 | 传入说明 | 描述 | 备注 |
---|---|---|---|---|
attentContentID | string | 强烈建议 | 关注对象内容ID/用户ID | |
isAward | int | 建议参数 | 事件是否能够获取激励,一般0表示有,1表示没有 | |
awardID | string | 建议参数 | 如事件产生了激励,可传递激励内容ID。如无,可传空 |
8. 送礼/打赏
用户给指定目标送礼
- extData Json内容:
参数名 | 类型 | 传入说明 | 描述 | 备注 |
---|---|---|---|---|
rewardContentID | string | 强烈建议 | 打赏目标内容ID/用户ID | |
giftID | string | 建议参数 | 礼物/打赏内容ID,可用于评估识别打赏内容与用户等级匹配度等。如无,可传空 | |
giftValue | int | 建议参数 | 礼物/打赏内容价值(有时直接使用金钱打赏),可以自定义数值大小标定。如无,可传空 |
9. 加好友/匹配
用户添加好友,或者匹配聊天对象、对局对象等
- extData Json内容:
参数名 | 类型 | 传入说明 | 描述 | 备注 |
---|---|---|---|---|
serverName | string | 强烈建议 | 如是游戏,传递当前角色所在游戏区服。如无,可传空 | |
gender | string | 建议参数 | 当前用户性别 | |
targetLevel | int | 建议参数 | 加好友/匹配对象等级。如无,可传空 | |
targetGender | string | 建议参数 | 加好友/匹配对象性别 | |
psText | string | 建议参数 | 加好友/匹配附言。如无,可传空 |