1.2.3.3 事件元信息

本节对HubbleData的事件，事件属性以及用户信息进行介绍，方便产品方进一步了解HubbleData的事件体系。本节主要包括以下内容：

1. 事件体系，包括内置事件，自动跟踪事件，自定义事件以及虚拟事件
2. 事件属性，包括SDK自动采集的事件属性，以及自定义属性
3. 用户属性，包括内置的属性以及自定义用户属性

1.1. 事件体系

HubbleData的设计中包含以下事件：

1. 内置事件：SDK自动采集，不需要用户手动触发
2. 自动跟踪事件：用户开启全埋点时，SDK自动采集的全部页面元素
3. 自定义事件：用户调用SDK的trackEvent接口上报的事件
4. 虚拟事件：用户将不同事件组合或者拆分之后编辑的事件

接下来将会对不同的事件类型进行描述，帮助产品方了解HubbleData的事件体系

1. 内置事件主要作用是让HubbleData完成基本的数据采集功能，以及实现此基础上的应用统计。事件以da开头，dataType='ie'。da_screen事件的dataType=‘pv‘

   1. da_u_login：调用SDK的loginUser接口
   2. da_u_signup：本地用户userId发生变化时
   3. da_u_logout：调用SDK的logoutUser接口
   4. da_activate：下载App之后，首次安装App App卸载之后重新安装，仍然会触发这个事件
   5. da_user_profile：调用SDK的用户信息上报（set）接口
   6. da_session_start：会话开启时，SDK自动生成内部事件。
   7. da_session_close：会话结束时，SDK自动生成内部事件。结束事件会在下一次会话发送
   8. da_screen：在HubbleData中对应pageView事件，App中属于HubbleData新增概念。**
      1. iOS中对应触发Controller这个类
      2. Android中对应触发Activity这个类
      3. JS中每一次用户新开页面或者刷新页面
2. 自动跟踪事件主要指开启SDK的自动跟踪开关时，SDK采集上报的数据。dataType='auto'
3. 自定义事件是产品方进行用户行为分析主要使用的数据，这部分数据需要用户在代码中调用SDK的trackEvent接口。
4. 虚拟事件：将不同事件进行组合，或者限定某些事件的范围。典型如HubbleData的任意事件：所有自定义事件的组合，即用户触发任意自定义事件都认为触发了一次任意事件。产品方通过任意事件可以对产品的全量用户进行分析，典型如当天的用户数量可以使用任意事件的触发用户数

会话体系说明

会话是应用统计的基本事件，不同终端对会话的处理逻辑是不相同的。本节对HubbleData的会话机制说明：

1. iOS：用户Kill掉应用或者应用回到后台15s
2. Android：用户Kill掉应用或者应用回到后台5s
3. Web：用户停留在当前页面30分钟或者切换页面来源
4. miniProgram：用户退出当前小程序（hide)
5. Sever:没有会话机制

1.2. 事件属性 events

为了方便用户对事件分析，SDK将会自动采集以下这些信息，具体示例如下：

{
    "userId": "5cc9531c48a0e12a7143c13bee058166e9e9d8e1",
    "deviceUdid": "5cc9531c48a0e12a7143c13bee058166e9e9d8e1",
    "dataType": "e",
    "eventId": "clickButton",
    "occurTime": 1434556935000,
    "serverTime": 1434556945000,
    "processTime": 1434556947000,
    "costTime": 20,
    "appKey": "MA-XXXX-437494F370B3",
    "productId": "",
    "sdkVersion": "1.0",
    "sdkType": "iOS",
    "sessionUuid": "1234-342423-232",
    "ip": "172.0.0.1",
    "country": "中国",
    "region": "浙江",
    "city": "杭州",
    "appVersion": "",
    "appChannel": "",
    "devicePlatform": "iPad",
    "deviceOs": "iOS",
    "deviceOsVersion": "7.0",
    "deviceModel": "iPhone6",
    "deviceManufacturer": "Apple",
    "deviceResolution": "640x960",
    "userWifi": "true",
    "screenWidth": "640",
    "screenHeight": "960",
    "deviceCarrier": "中国移动",
    "networkType": "4G",
    "localeLanguage": "en",
    "category": "",
    "label": "",
    "currentUrl": "http://news.163.com/detail.html?from=baidu&p_from=1",  // 如果有参数，会携带
    "urlPath": "/detail.html", // 不会携带参数
    "currentDomain": "news.163.com",
    "pageTitle": "网易",
    "referrer": "https://www.baidu.com/", // 如果有参数，会携带
    "referrerDomain": "www.baidu.com",
    "browser": "chrome",
    "browserVersion": "58.0.3029.110",
    "activationtime": 1434556935000, // 该设备激活时间
    "promotionalID": "2017 818大促",
    "utmSource": "toutiao",
    "utmMedium": "cpc",
    "utmCampaign": "活动推广",
    "utmContent": "818考拉大促",
    "utmTerm": "化妆品，母婴，箱包",
    "newUser": 1,
    "utmMatchType": 0,
    "firstLevelSource": "搜索",
    "secondLevelSource": "www.google.com.hk",
    "pageOpenScene": "App",
    "hubbleId":"CslQ4lurTKVNsDV0AwOjAg",
    "deviceAndroidId":"a0e12a7143c13",
    "scene":"1001",
    "sceneCategory":"快捷入口",
    "isDebug":"1",//为1表示调试模式数据，其他情况均为正常线上数据
    "modifyType":"1", //为空客户端时间未被修改
    "originTime":1434556934999, //若客户端时间被修改，显示被修改前的时间
    "deviceMacAddr":"02:00:00:00:00:00",
    "longitude":121.471336,
    "latitude":31.197056,
    "wifiSsid":"Gymstar103",
    "wifiBssid":"8a:25:93:c3:cb:ec",
    "attributes": {
        "": ""
    }
}

字段详细说明以及属性如下:

1.3. 用户属性 users

"userId": "12345",
"$account": "13356562788@163.com"
"$realName": "小明",
"$birthday": "",
"$gender": "male",
"$age": 18,
"registerTime": 1355213102000f,
"activationTime": 1355213103000f,
"lastUseTime": 1355213104000f,
"productKey": "",
"deviceIDFV": "",
"deviceIDFA": "",
"deviceIMEI": "",
"deviceUdid_pc": "",
"deviceUdid_android": "",
"deviceUdid_iOS": "",
"deviceUdid_web": "",
"$country": "中国",
"$region": "湖南省",
"$city": "长沙",
"f_promotionalID": "2017 818大促",
"f_utmSource": "toutiao",
"f_utmMedium": "cpc",
"f_utmCampaign": "活动推广",
"f_utmContent": "818考拉大促",
"f_utmTerm": "化妆品，母婴，箱包",
"f_firstLevelSource": "新闻",
"f_secondLevelSource": "news.163.com",
"attributes": ""

字段以及详细说明如下：