社交类场景

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 建议参数 加好友/匹配附言。如无,可传空
    在线咨询 电话咨询:95163223 免费试用