社交分享关系链统计
1. 功能简介
社交分享邀请关系的基本逻辑图如下：
详细功能可以参考文档社交分享关系链统计
2. 客户端集成
首先参考接入指南集成U-Share iOS SDK，要求在6.10.2版本及以上
2.1 接口函数
+(void)trackcode:(NSString*)appKey
url:(NSString* )url
umid:(NSString*)umid
uid:(nullable NSString*)uid
userInfo:(nullable NSDictionary*)userInfo
completionHandler:(nullable UMSocialTrackcodeCompletionHandler)completionHandler;2.2 参数说明
参数 | 参数解释 | 是否必须 | 备注 |
|---|---|---|---|
appKey | umeng的appkey | 是 | 友盟平台申请的宿主App对应appkey |
url | 要分享的url | 是 | 分享页面URL链接 |
uid | 用户的uid | 是 | 用户账号，可选参数，可以传入null或者空串 |
userInfo | 用户的额外参数 | 否 | 自定义属性(字符串键值对)，存放开发者自定义属性（如用户账号，设备信息，活动ID等信息）。如果没有可以传null |
completionHandler | 回调 | 是 | 生成root track code的结果回调对象 |
2.3 示例
-(void)getTrackcode{
[UMShareLink trackcode:@"5861e5daf5ade41326001eab"
url:@"https://developer.umeng.com"
umid:[UMConfigure umidString]
uid:nil
userInfo:@{@"param1":@"value1",@"param2":@"value2",@"param3":@"value3"} completionHandler:^(id _Nullable result, NSError * _Nullable error) {
if (result) {
NSLog(@"result:%@",result);
}
else{
NSLog(@"error:%@",error);
}
}];
}2.4 接口返回
code 为200是正常返回，其余为异常返回，异常信息在msg 字段
未捕获异常code 为10000 , 默认msg 为服务器偷懒```java正常返回：{ “code”: 200, ＃返回码 “msg”: “SUCCESS”, ＃返回提示 “sCode”: 200, “sMsg”: “SUCCESS”, “data”: {
"rootTrackCode": "f528a53ff689130b41e3153j"}, “traceId”: “0af4000116058653151041092d5089”, “success”: true}异常返回：{ “code”: 20002, # 异常返回码 “msg”: “APPKEY不存在”, #异常原因 “sCode”: 20002, “sMsg”: “APPKEY不存在”, “data”: null, “traceId”: “ac11000116087092972151004d6b7a”, “success”: false}
<br />所有已定义异常码及异常原因：
```java
REQUEST_PARAMMETER_INVALID(400L, "请求参数校验失败"),
INIT_MAP_ERROR(20001L, "初始参数未设置"),
APPKEY_NONEXISTENT(20002L, "APPKEY不存在"),
UMID_NONEXISTENT(20003L, "UMID不存在"),
URL_NONEXISTENT(20007L, "URL不存在"),
USER_DATA_EXCEEDED(20004L, "用户自定义参数个数超过限制"),
INVALID_PARAM_KEY(20005L, "用户自定义参数KEY非法"),
INVALID_PARAM_LENGTH(20006L, "用户自定义参数长度超限"),
INVALID_TRACK_CODE(20015L, "无效的TRACKCODE"),
SERVER_INTERNAL_ERROR(20020L, "服务器内部错误"),集成完U-Share SDK后，剩余的接入过程请参考文档社交分享关系链统计