服务端集成

该文档为服务端2.0接口文档,如果您第一次服务器端集成,我们强烈建议您直接使用服务端2.0接口,相较于服务端1.0的接口,服务端2.0接口上传数据更加稳定,并且提供了更丰富的接口。如设备信息、环境信息等。

对于无法在App客户端中布点的情况,您可以通过本文提供的接口,在应用服务器端或合适的位置时机上传用户及事件数据。

1. 接口地址

https://su.zhugeio.com/open/v2/event_statis_srv/upload_event

2. 请求方式

GET/POST方式提交数据

3. 调用验证

使用HTTP Basic Authentication方式做访问授权,HTTP Header里加一个字段(Key/Value对):

    Authorization: Basic base64_auth_string

其中 base64_auth_string 的生成算法为: base64(AppKey:SecretKey)。 即用AppKey加上冒号,加上SecretKey拼接起来,再做base64转换,AppKey和SecretKey在我的应用里面查看。

4. 请求参数

请求方式 参数名称 类型 是否必须 描述
GET data json 必须 自定义事件、用户信息,json格式如下
POST(推荐) json 必须 自定义事件、用户信息,json格式如下(json格式数据放body内)

4.1. 自定义事件

{  
 "ak": "8c86c202ae3b4024849988d36646a66a",  // AppKey(必填,字符串)  
 "dt": "evt",                               // 数据类型(必填,固定值) :evt为事件行为数据 
 "pl": "and",                               // 平台信息: js为js、android为and、iOS为ios (必填,字符串)  
 "debug": 0,                                // 实时调试: 1为开启实时调试, 0或缺少此字段为关闭(非必填,数字)  
 "ip": "10.0.0.16",                         // ip信息,会解析出地域信息(非必填,字符串)  
 "pr": {      
     "$ct": 1491812561821,                  // 事件时间(unixtime)(必填,单位是毫秒,数字)   
     "$eid": "事件名称",                     // 事件名称(必填,字符串) 
     "$cuid": "123@zhugeio.com",            // 用户id(实名用户必填,字符串)   
     "$sid": 1491812519004,                // 会话ID(非必填,数字)  
     "$vn": "1.0",                         // 版本(非必填,字符串)  
     "$cn": "zhuge",                       // 渠道(非必填,字符串)  
     "$cr": 46002,                         // 运营商(非必填,数字,见页尾参考值)  
     "$os": "Android",                     // 系统(非必填,字符串)  
     "$ov": 5,                             // 系统版本(非必填,数字)  
     "$net": 1,                            // 网络类型(非必填,数字,见页尾参考值)  
     "事件属性名1": "事件属性值1",            // 事件属性(非必填,字符串) ,如果是数值型属性值不要带引号 
     "事件属性名2": "事件属性值2"  
    },    
    "usr": {      
        "did": "7df321978522f95327c2c413c0405c0e"  // 设备ID(匿名用户必填,字符串)  
        }  
}  

{  
 "ak": "8c86c202ae3b4024849988d36646a66a",  // AppKey(必填,字符串)  
 "debug": 0,                                // 实时调试: 1为开启实时调试,0或缺少此字段为关闭(非必填,数字)  
 "dt": "evt",                               // 数据类型(必填,固定值) :evt为事件行为数据 、abp为收入事件(revenue)  
 "pl": "js",                                // 平台信息: js为js、android为and、iOS为ios (必填,字符串)  
 "ip": "10.0.0.16",                         // ip信息,会解析出地域信息(非必填,字符串)  
 "pr": {      
     "$ct": 1491812561821,                  // 事件时间(unixtime)(必填,单位是毫秒,数字)   
     "$eid": "事件名称",                     // 事件名称(必填,字符串)  、收入事件(revenue)
     "$cuid": "123@zhugeio.com",           // 用户id(实名用户必填,字符串)   
     "$sid": 1491812519004,                // 会话ID(非必填,数字)  
     "$referrer_domain": "google.com",     //来源域名(非必填,字符串)
     "$url": "<https://zhugeio.com>[",](https://zhugeio.com)        // 当前url(非必填,字符串)                       
     "$ref": "<https://zhugeio.com>[",](https://zhugeio.com)        // 来源网址(非必填,字符串)   
     "$utm_source": "",                    // (非必填,字符串)   
     "$utm_medium": "",                    // (非必填,字符串)  
     "$utm_campaign": "",                  // (非必填,字符串)  
     "$utm_content": "",                   // (非必填,字符串)  
     "$utm_term": "",                      // (非必填,字符串)  
     "事件属性名1": "事件属性值1",            // 事件属性(非必填,字符串)  
     "事件属性名2": "事件属性值2"  
    },    
    "usr": {      
        "did": "7df321978522f95327c2c413c0405c0e"  // 设备ID(匿名用户必填,字符串)  
        }  
}  

注意:  
1. 会话ID(sid),缺省会按照默认策略生成,会对访问次数产生一定误差  
2. 设备ID(did),若为空,会根据cuid生成,sdk与服务端混用情况下,会使新增数据产生误差(不可以传null) 

4.2. 用户信息

{    
 "ak": "8c86c202ae3b4024849988d36646a66a",  // AppKey(必填,字符串)  
 "dt": "usr",                               // 数据类型:usr:用户信息,identify(必填)  
 "pl": "and",                               // 平台信息: js为js、android为and、iOS为ios (必填,字符串)  
 "debug": 0,                                // 实时调试: 1为开启实时调试,0或缺少此字段为关闭(非必填,数字)  
 "pr": {  
      "$ct": 1491812561821,                 // 事件时间(unixtime)(必填,单位是毫秒,数字)   
      "$cuid": "123@zhugeio.com",           // 用户id(必填,字符串)   
      "用户属性名1": "用户属性值1",            // 用户属性(非必填,字符串)  
      "用户属性名2": "用户属性值2"              
      },    
     "usr": {  
         "did": "7df321978522f95327c2c413c0405c0e"    // 设备ID(非必填,字符串)  
         }  
}  

注意:  
1. 设备ID(did),若为空,会根据cuid生成,sdk与服务端混用情况下,会使新增数据产生误差(不可以传null)

4.3. 设备信息完善

{    
 "ak": "8c86c202ae3b4024849988d36646a66a",  // AppKey(必填,字符串)  
 "dt": "pl",                                // 数据类型:pl:设备信息(必填,固定值)  
 "pl": "and",                               // 平台信息: js为js、android为and、iOS为ios (必填,字符串)  
 "debug": 0,                                // 实时调试: 1为开启实时调试,0或缺少此字段为关闭(非必填,数字)  
 "pr": {  
      "$ct": 1491812561821,                 // 事件时间(unixtime)(必填,单位是毫秒,数字)   
      "$br":"Xiaomi",                       // 设备品牌(非必填,字符串)  
      "$dv":"MI 5S",                        // 设备型号(非必填,字符串)  
      "$imei":"863077020763166",            // 设备imei码(非必填,字符串)  
      "$rs":"1280x720"                      // 设备分辨率,间隔符支持: x,* (非必填,字符串)  
      },    
     "usr": {  
         "did": "7df321978522f95327c2c413c0405c0e"    // 设备ID(必填,字符串)  
         }  
}  

{    
 "ak": "8c86c202ae3b4024849988d36646a66a",  // AppKey(必填,字符串)  
 "dt": "pl",                                // 数据类型:pl:设备信息(必填,固定值)  
 "pl": "js",                                // 平台信息: js为js、android为and、iOS为ios (必填,字符串)  
 "debug": 0,                                // 实时调试: 1为开启实时调试,0或缺少此字段为关闭(非必填,数字)  
 "pr": {  
      "$ct": 1491812561821,                 // 事件时间(unixtime)(必填,单位是毫秒,数字)   
      "$rs":"1280*800"                      // 设备分辨率,间隔符支持: x,*(非必填,字符串)  
      },    
     "usr": {  
         "did": "7df321978522f95327c2c413c0405c0e"    // 设备ID(必填,字符串)  
         }  
}  

4.4. 收入分析数据采集

{
"ak": "8c86c202ae3b4024849988d36646a66a",   // AppKey(必填,字符串) 
"dt": "abp",                                // 数据类型(必填,固定值) :abp为收入事件(revenue)
"pl": "and",                                // 平台信息: js为js、android为and、iOS为ios (必填,字符串)  
"debug": 0,                                 // 实时调试: 1为开启实时调试, 0或缺少此字段为关闭(非必填,数字)
"ip": "10.0.0.16",                          // ip信息,会解析出地域信息(非必填,字符串) 
"pr": {      
    "$ct": 1578801540000,                   // 事件时间(unixtime)(必填,单位是毫秒,数字)
    "$eid": "revenue",                      // 事件名称(必填,字符串) :收入事件(revenue)
    "$cuid": "宋世奇",                       // 用户id(实名用户必填,字符串) 
    "$sid": 1491812519004,                  // 会话ID(非必填,数字)
    "$vn": "1.0",                           // 版本(非必填,字符串)
    "$cn": "zhuge",                         // 渠道(非必填,字符串) 
    "$cr": 46002,                           // 运营商(非必填,数字,见页尾参考值)
    "$os": "Android",                       // 系统(非必填,字符串) 
    "$net": 1,                              // 网络类型(非必填,数字,见页尾参考值)
    "$price":988.9,                         // 商品价格(必填,数值型属性不要带引号)
    "$productID":"荣耀",                     // 商品ID(必填,数字、字符串)
    "$productQuantity":3,                   // 商品数量(必填,数值型属性不要带引号)
    "$revenueType":"手机"                    // 商品名称(必填,数字、字符串)
},
"usr": {      
    "did": "7df321978522f95327c2c413c0405c0e"   
    }
}

5. 参考值列表

5.1. 运营商

参考值 运营商名称
46000 中国移动
46001 中国联通
46002 中国移动
46003 中国电信
46005 中国电信
46006 中国联通
46007 中国移动
46011 中国电信
46020 中国铁通

5.2. 网络类型

参考值 网络类型名称
0 移动网络
1 2G
2 3G
3 4G
4 WIFI
curl --insecure -X POST "https://u.zhugeapi.com/open/v2/event_statis_srv/upload_event" -u "AppKey:SecretKey" -d '{ "ak": "6b09c202ae3b4024849084d36649f57c", "dt": "usr", "pr": { "$ct": 1491812561821, "$cuid": "zhugeio", "属性名1": "属性值1", "属性名2": "属性值2"}, "debug": 0, "pl": "and", "usr": { "did": "7df321978522f95327c2c413c0405c0e" } }'

5.3. 返回参数

参数名称 类型 描述
return_code int 0:成功;小于0:失败
return_message string 具体信息
warn_* string 警告、提示信息

5.4. 成功返回

{
    "return_code": 0,
    "return_message": "success"
}

5.5. 警告返回

{
    "return_code":0,
    "return_message":"success",
    "warn_did":"did is null, will have some impact on statistics"
}

5.6. 错误返回

{
    "return_code":-10001,
    "return_message":"ak is null or does not exist"
}
{
    "return_code":-10001,
    "return_message":"$ct is null or does not exist, ct must be number type"
}
©zhugeio.com 京ICP备15049545号            文档更新时间 2022-12-30 07:46:25

results matching ""

    No results matching ""