1. 事件元信息

本节对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": {
        "": ""
    }
}

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

字段名 字段描述 字段类型 移动端 web端 server端 微信小程序
userId 用户 ID string 　√　 　√ 　√ 　√　
deviceUdid 设备 ID （单设备内全局永久唯一） string 　√　 　√ 　√　
dataType 数据报文类型 string 　√　 　√ 　√ 　√　
eventId 事件 ID string 　√　 　√ 　√ 　√　
occurTime 客户端事件发生时间（绝对毫秒） long 　√　 　√ 　√ 　√　
serverTime 服务端数据接收时间（绝对毫秒） long √　 　√ 　√ 　√　
processTime 服务端数据处理时间（绝对毫秒） long √　 　√ 　√ 　√　
costTime 事件耗时（毫秒） int 　√　 　√ 　 　√　
appKey 应用标识 string 　√　 　√ 　√ 　√　
productId 产品标识 string 　√　 　√ 　√ 　√　
sdkVersion Hubble SDK 版本 string 　√　 　√ 　√ 　√　
sdkType Hubble SDK 类型 string 　√　 　√ 　√ 　√　
sessionUuid 会话 ID（单次会话周期内唯一） string 　√　 　√ 　 　√　
ip 客户端终端网络 IP string 　√　 　√ 　√ 　√　
country 国家 string √　 　√ 　√ 　√　
region 省份 string 　√　 　√ 　√ 　√　
city 城市 string √　 　√ 　√ 　√　
appVersion 应用版本 string √ 　 　√　
appChannel 应用渠道 string √ 　 　　　
devicePlatform 设备平台 string 　√　 　√ 　 　√　
deviceOs 操作系统 string 　√　 　√ 　 　√　
deviceOsVersion 操作系统版本 string 　√　 　√ 　 　√　
deviceModel 设备机型 string 　√　 　√ 　 　√　
deviceManufacturer 设备制造商 string 　√　 　 　 　
deviceResolution 设备分辨路 string 　√　 　 　 　　
useWifi 是否使用wifi string √　 　 　
screenWidth 分辨率（宽） string 　√　 　√ 　 　√　
screenHeight 分辨率（高） string 　√　 　√ 　 　√　
deviceCarrier 网络运营商 string 　√　 　 　
networkType 联网类型 string 　√　 　 　 　√　
localeLanguage 本地语言 string 　√　 　 　√　
category 事件类别 string √　 　 　
label 事件标签 string √　 　 　
currentUrl 当前页url（如果有参数，会携带） string 　 　√ 　√　
urlPath 当前页url路径（不会携带参数） string 　 　√ 　√　
currentDomain 当前站域名 string 　 　√
pageTitle 当前页title string 　 　√
referrer 来源页url（如果有参数，会携带） string 　 　√
referrerDomain 来源站域名 string 　 　√
browser 浏览器名称 string 　 　√
browserVersion 浏览器版本 string 　 　√
promotionalID 推广活动ID string √ √
utmSource 广告来源（渠道） string √ √
utmMedium 广告媒介 string √ √
utmCampaign 广告名称 string √ √
utmContent 广告内容 string √ √
utmTerm 广告关键词 string √ √
newUser 是否当日新增 int √ √ √ √
utmMatchType 移动端激活事件匹配类型 int √
firstLevelSource 一级流量来源（搜索，社交，新闻等） string √
secondLevelSource 二级流量来源（具体站点域名） string √
pageOpenScene 网页打开场景（Browser/App） string √ √
hubbleId hubble系统为用户生成的Id string √
deviceAndroidId 安卓ID string √
scene 微信小程序场景ID string √
sceneCategory 场景ID对应分类 string √
isDebug 是否为调试模式数据 string √
modifyType 客户端时间修改类型 string √
originTime 被修改前的客户端原始时间 long √
deviceMacAddr mac地址 string √
longitude 经度 double √
latitude 纬度 double √
wifiSsid wifi名称 string √
wifiBssid wifi mac地址 string √
attributes 自定义字段 KV 字典 map 　√　 　√ 　√ 　√

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": ""

字段以及详细说明如下：

字段名 字段描述 字段类型
userId 用户 ID , 用于和事件表做关联 string
$account 用户登录账号 string
$realName 用户名称 string
$birthday 用户出生日期 date
$gender 用户性别 int (0-女，1-男，2-未知)
$age 用户年龄 int
$country 国家 string
$region 省份 string
$city 城市 string
registerTime 用户注册时间（绝对毫秒） long
activationTime 首次访问时间 / 激活时间（绝对毫秒） long
lastUseTime 最近访问时间（绝对毫秒） long
productId 该产品编号 string
deviceIDFV iOS设备IDFV string
deviceIDFA iOS设备IDFA string
deviceIMEI Andriod设备IMEI string
deviceUdid_pc pc端设备编号 string
deviceUdid_android android端设备编号 string
deviceUdid_iOS iOS端设备编号 string
deviceUdid_web web端设备编号 string
f_promotionalID 首次推广活动名称 string
f_utmSource 首次广告来源(渠道) string
f_utmMedium 首次广告媒介 string
f_utmCampaign 首次广告名称 string
f_utmContent 首次广告内容 string
f_utmTerm 首次广告关键词 string
f_firstLevelSource 首次一级流量来源（搜索，社交，新闻等） string
f_secondLevelSource 首次二级流量来源（具体站点域名） string
attributes 产品方自定义属性 map

results matching ""

    No results matching ""