event

记录一个event以及event属性，数据样例：

{
    "unique_id": "123456",
    "produce_time": 1434556935000,
    "info_type": "event",
    "event_code": "view_product",
    "project": "test",
    "time_free": true, //建议在导入历史数据时使用，采集实时数据不建议使用
    "properties": {
        "$is_login_id":true, 
        "$app_version":"1.3",
        "$wifi":true,
        "$ip":"192.168.1.1",
        "$province":"湖南",
        "$city":"长沙",
        "$user_agent":"Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_2 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) CriOS/58.0.3029.113 Mobile/14F89 Safari/602.1",
        "$screen_width":320,
        "$screen_height":568,
        "product_id":12345,
        "product_name":"苹果",
        "product_classify":"水果",
        "product_price":14.0
    }
}

字段说明：

• unique_id：类型是字符串，对用户的标识，对未登录用户，可以填充设备标识（imei,idfa等）、CookieID 等，对于登录用户，则应该填充注册账号；这里的例子，我们假设是一个登录用户，所以填充的是一个登陆 ID；
• produce_time：类型是数值，事件发生的实际时间戳，精确到毫秒；
• info_type：track 表明是记录一个 Event ，这里我们假设是一个商品浏览行为；
• event_code：事件名，需是合法的变量名，即不能以数字开头，且只包含：大小写字母、数字、下划线，其中以$开头的表明是系统的预置事件，自定义事件名请不要以$开头，且 event 字段长度最大为 100；
• project：这条数据所属项目名，指定的项目必须是系统中已经存在的项目，否则这条数据将无效；
• time_free：可选字段，表示不根据事件发生时间过滤该事件。只要出现 time_free 这个 key 且 value 不为 null，将不再校验 time 是否在允许导入的时间范围内。导入历史数据时可能会用到该字段；
• properties：这个 Event 的具体属性，以 dict 的形式存在。其中以$开头的表明是系统的预置属性，它的类型和中文名已经预先定义好了。自定义属性名需要是合法的变量名，不能以数字开头，且只包含：大小写字母、数字、下划线，自定义属性不能以$开头；同一个名称的 property，在不同 event 中，必须保持一致的定义和类型；同一个名称的 property 不区分大小写，如果已经存在小写属性就不可再导入对应大写属性（比如元数据中有 abc 属性名，不能再传 ABC,Abc 等属性名），否则数据会校验失败不入库。
  • $is_login_id：判断 unique_id 对应的是否是一个注册账号；
  • $app_version：用户所使用的 App 的版本；
  • $wifi：这条事件发生时，用户是否在使用 wifi；
  • $ip：用户使用设备的 IP。若数据中出现 $ip，且数据中没有 $province 或 $city 字段，将使用该 IP 解析出省市信息填入缺失字段；
  • $province、$city：省、市，在没有填充这两个字段的时候，会根据 IP 进行解析；
  • $user_agent：可选参数。如果传入该参数，则解析 User-Agent，解析结果包括：设备制造商、设备型号、操作系统、操作系统版本、浏览器、浏览器版本、爬虫名称（如果是爬虫）；目前是神策是通过 UA 判断并有一个默认的属性 botname （爬虫名称），但是有两种情况无法判断，第一种：如果 UA 里没有标明、且会触发 JS 脚本的非法爬虫。第二种：如果爬虫没有触发 JS 脚本，那么也不会触发我们的 SDK ，所以本身就不会被统计到。对于爬虫种类，不能提前把所有的种类都加进去，主流的神策都加了，其它的属于不太常见的，量较少。
  • $screen_width、$screen_height：屏幕的宽和高；
  • product_id、product_name、product_classify、product_price：跟商品相关的一些具体属性