HTTP API（私有化查看）

单条数据上传：

• Path: https://${host}/v2/event/json
• Method: POST

多条数据上传（每次最多20条）：

• Path: https://${host}/v2/event/list
• Method: POST

${host}：私有化部署客户为埋点数据上报申请的域名，请根据实际的域名进行替换，客户域名更新后也需要同步更新上报的路径地址。

(1) 请求的header里带"Content-Type: application/json"，以及“X-MCS-AppKey”，作为app的标识；
(2) 请求的body包含user，header，event三个部分，其中的header是埋点数据本身的header；
(3) 单次上传events数控制在20条以内，超过50条会报413；
(4) 上传如采用/v2/event/list接口，json数目控制在20条以内，超过50条会报413。

2.1 请求header

APP Key的获取位置请参考以下截图

2.2 请求body

2.3 user格式

2.4 header格式

2.5 event格式

HTTP 状态码

4.1 /v2/event/json接口

curl -X POST -H "Content-Type: application/json" -H "X-MCS-AppKey: 12345678key" -d '{"user": {...}, "header":{...}, "events":{...}}' https://mcs.ctobsnssdk.com/v2/event/list

请求body：

{
    "user": {
            // 建议先在客户端上报用户的user_unique_id，然后再在服务端使用
        "user_unique_id": "74481585297"   //用户唯一标示
    },
    "header": {
        "ab_sdk_version": "91223,83097",   //AB实验vid
        "app_channel": "App Store",    //App渠道
        "app_name": "news_article",    //App名称
        "app_package": "com.ss.android.article.news",   //App包名
        "app_version": "5.1.3",        //App版本
        "client_ip": "10.100.1.1",     //客户端ip地址
        "device_model": "SM-G9250",    //设备型号
        "os_name": "Android",          //操作系统
        "os_version": "6.0.1",         //操作系统版本
        "traffic_type": "app",
        "custom":"{\"A\":\"a\"}"         //事件公共属性
    },
    "events": [
        {
            "ab_sdk_version": "91223,83097",   //AB实验vid
            "event": "test_go_detail",    //事件名称
            "params": "{\"paramName\":\"a\"}",    //事件属性
            "local_time_ms": 1489573628001   //事件发生时刻的时间戳
        }
    ]
}

字段说明：

local_time_ms ： 这个是毫秒时间戳，标识这个事件发生的时刻

4.2 /v2/event/list接口

curl -X POST -H "Content-Type: application/json" -H "X-MCS-AppKey: 12345678key" -d '[{"user": {...}, "header":{...}, "events":{...}}]  https://mcs.ctobsnssdk.com/v2/event/list

请求body：

[{
    "user": {
        "user_unique_id": "74481585297"   //用户唯一标示
    },
    "header": {
        "ab_sdk_version": "91223,83097",   //AB实验vid
        "app_channel": "App Store",    //App渠道
        "app_name": "news_article",    //App名称
        "app_package": "com.ss.android.article.news",   //App包名
        "app_version": "5.1.3",        //App版本
        "client_ip": "10.100.1.1",     //客户端ip地址
        "device_model": "SM-G9250",    //设备型号
        "os_name": "Android",          //操作系统
        "os_version": "6.0.1",         //操作系统版本
        "traffic_type": "app"
    },
    "events": [
        {
            "event": "test_go_detail",    //事件名称
            "params": "{\"paramName\":\"a\"}",    //事件属性
            "local_time_ms": 1489573628001   //事件发生时刻的时间戳
        }
    ]
}]

字段说明：

local_time_ms ： 这个是毫秒时间戳，标识这个事件发生的时刻

用户属性是通过特殊的事件进行上报，通过设置下面几个event可以修改用户属性：

5.1 上报用户属性

用户属性放在params中
示例请求，作用为设置一个用户属性age，删除一个用户属性name，body：

{
    "user": {
        "user_unique_id": "74481585297"   //用户唯一标示
    },
    "header": {
        "ab_sdk_version": "91223,83097",   //AB实验vid
        "app_channel": "App Store",    //App渠道
        "app_name": "news_article",    //App名称
        "app_package": "com.ss.android.article.news",   //App包名
        "app_version": "5.1.3",        //App版本
        "client_ip": "10.100.1.1",     //客户端ip地址
        "device_model": "SM-G9250",    //设备型号
        "os_name": "Android",          //操作系统
        "os_version": "6.0.1",         //操作系统版本
        "traffic_type": "app"
    },
    "events": [
        {
            "event": "__profile_set",    //操作名
            "params": "{\"age\": 10}",    //设置属性
            "local_time_ms": 1489573628001   //事件发生的时间戳
        }，
        {
            "event": "__profile_unset",    //操作名
            "params": "{\"name\":\"tom\"}",    //设置属性
            "local_time_ms": 1489573628001   //事件发生的时间戳
        }
    ]
}

5.2 验证上报的用户属性

可以在行为细查页面中查看特定用户的数据，如果是大量数据，可以在事件分析中对用户属性进行分析。

6.1 创建业务对象

创建业务对象之后需要等待5-10分钟之后再上报；
每个应用目前最多可创建10个业务对象；每个业务对象最多可创建50个属性；

需要先创建业务对象，在 “数据管理” --> “业务对象”下创建。
业务对象内置的id属性，对应的字段名称为item_id，因此不需要再定义一个 id 属性。
业务对象属性是通过特殊的事件进行上报，通过设置下面几个event可以修改业务对象属性：

业务对象属性放在params中，并且需要有item_name和item_id来标识唯一业务对象。
示例请求body：

{
    "user": {
            "user_unique_id": "__rangers"   // 业务对象上报，固定为__rangers
    },
    "header": {
        "app_name": "news_article"//App名称
    },
    "events": [
        {
            "event": "__item_set",    //操作名
            "params": "{\"item_name\":\"phone\",\"item_id\":\"1\",\"price\": 1000}",    //设置属性
            "local_time_ms": 1489573628001   //事件发生的时间戳
        }
    ]
}

6.2 上报关联事件

创建好的 item 对象需要与事件关联才可以使用。关联就是将某一个或多个具体业务对象的 id 值作为上报到事件的预置属性params.__item当中的过程。
下列示例代码演示了将 sku 和 order 两个创建好的业务对象与事件 new_order 进行关联的方式。__items 为事件预置属性，仅用于上报业务对象；
示例如下：

...
"event": "new_order",
"params": {
    "__items": "[{\"sku\":[{\"id\":\"sku_id_1\"},{\"id\":\"sku_id_2\"}]},{\"order\":[{\"id\":\"order_id_here\"}]}]",
    ...
},
...

__item 是转为 string 的 json 对象，其格式为：

[
    {"item_name_1": [
        {"id": "id_value_1"},
        {"id": "id_value_2"},
        ...
    ]},
    {"item_name_2": [
        {"id": "id_value_1"},
        {"id": "id_value_2"},
        ...
    ]}
]

item_name_1 就是在上一步中定义的业务对象名称。如果这里关联的业务对象名称没有被定义过，那么相应的数据就会被抛掉，不会入库。如果 id 值没有找到对应的业务对象，也同样会被抛掉，不会入库，无法使用。

如果数据的客户端时间超过七天，正常情况下无法导入，如需导入7天前历史数据，需在header中增加历史数据的标识 __is_history；如下：

[{
   "user": {
       "user_unique_id": "74481585297"   //用户唯一标示
   },
   "header": {

       "custom": {
              "__is_history": "true" //导入历史数据标识，默认为false;
       }
   },
   "events": [
       {
           "event": "test_go_detail",    //事件名称
           "params": "{\"paramName\":\"a\"}",    //事件属性
           "local_time_ms": 1489573628001   //事件发生时刻的时间戳
       }
   ]
}]

字段说明：

local_time_ms ： 这个是毫秒时间戳，标识这个事件发生的时刻，注意不是导数的时间
上报完成后，需要在界面上点击刷新数据，即可以查询到上报的历史数据。

请参考文档：

• 数据格式文档中的数据上报限制：数据格式
• 数据质量：数据质量

方式1 ： 可以在“高级分析”--> “自定义SQL”里直接查询
方式2： 如果知道特定的user_unique_id，可以在行为细查里查询
方式3： 可以在事件分析页面进行查询分析

如果有服务端上报设备 id 的需求，需要上传device_id。

[{
    "user": {
        "user_unique_id": "123456",
        "device_id":"691295821177554113"
    },
    "header": {

    },
    "events": [
        {
            "event": "test_go_detail",    //事件名称
            "params": "{\"paramName\":\"a\"}",    //事件属性
            "local_time_ms": 1489573628001   //事件发生的时间戳
        }
    ]
}]