From 668f12ead9aec137f89c31e003f4cdd52216f89c Mon Sep 17 00:00:00 2001 From: jiarongping Date: Thu, 17 Feb 2022 17:33:31 +0800 Subject: [PATCH] add: opendb-stat.md --- opendb-stat.md | 529 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 529 insertions(+) create mode 100644 opendb-stat.md diff --git a/opendb-stat.md b/opendb-stat.md new file mode 100644 index 0000000..fbeb4fd --- /dev/null +++ b/opendb-stat.md @@ -0,0 +1,529 @@ + +# 上报维度 + + +## uni统计-平台表 opendb-app-platforms + +### 字段说明 + +|字段名 |类型 |默认值 |说明 | +| :--------: | :-----: |:---------:|:-------------------: | +| _id | string | - |ID，系统自动生成 | +| code | string | - |平台代码，客户端上报 | +| name | string | - |平台名称，管理端显示 | +| create_time | timestamp| - |创建时间 | +| last_modify_time | timestamp| - |最后修改时间 | + +说明：这是一个平台字典表 + +## uni统计-应用渠道表 opendb-app-channels + + +### 字段说明 + +|字段名 | 类型 |默认值 |说明 | +| :--------: | :-----: |:---------:|:---------------------------------------: | +| _id | string |- |ID，系统自动生成 | +| appid | string |- |统计应用ID，对应opendb-app-list.appid | +| platform | string |- |应用平台，对应opendb-app-platforms.code | +| channel_code | string |- |客户端上报的渠道编码，如：xiaomi | +| channel_name | string |- |渠道名称/场景名称，渠道名称管理员可编辑，管理端显示| +| create_time | timestamp |- |创建时间 | +| last_modify_time | timestamp |- |最后修改时间 | + + + + + +## uni统计-应用版本表 opendb-stat-app-versions + +### 字段说明 + +| 字段名 | 类型 | 默认值 | 说明 | +| :--------: | :-----: |:---------:| :-------------------: | +| _id | string | - | ID，系统自动生成 | +| appid | string | - | 统计应用ID，对应opendb-app-list.appid | +| platform | string | - | 应用平台，对应opendb-app-platforms.code | +| version | string | - | 应用版本 | +| create_time | timestamp | - | 创建时间 | +| last_modify_time | timestamp | - | 最后修改时间 | + +说明：这是专为uni统计增加的版本表，和uni升级中心的版本表不同。 + +## uni统计-应用事件表 opendb-stat-events + +事件字典表 + +### 字段说明 + +| 字段名 | 类型 | 默认值 | 说明 | +| :--------: | :-----: |:----------: | :-------------------: | +| _id | string | - | ID，系统自动生成 | +| appid | string | - | 统计应用ID，对应opendb-app-list.appid | +| event_key | string | - | 事件键值，如：login | +| event_name | string | - | 事件名称，管理端显示，如：登录 | +| create_time | timestamp | - | 创建时间 | +| last_modify_time | timestamp | - | 最后修改时间 | + + +## uni统计-应用页面表 opendb-stat-pages + +### 字段说明 + +| 字段名 | 类型 | 默认值 | 说明 | +| :--------: | :-----: |:------: | :-------------------: | +| _id | string | - |ID，系统自动生成 | +| appid | string | - |统计应用ID，对应opendb-app-list.appid | +| path | string | - |页面路径，如`/pages/index/index` | +| title | string | - |页面标题 | +| create_time | timestamp | - |创建时间 | + + +## uni统计-应用会话日志表 opendb-stat-session-logs + +### 字段说明 + +| 字段名 | 类型 | 默认值 | 说明 | +| :--------: | :-----: |:--------: | :-----------------: | +| _id | string | - | ID，系统自动生成 | +| appid | string | - | 客户端上报的应用ID | +| version | string | - | 客户端上报的应用版本号 | +| platform | string | - | 客户端上报的平台code | +| channel | string | - | 客户端上报的渠道code或场景值ID | +| uuid | string | - | 客户端上报的用户标志 | +| is_first_visit | int | 0 | 是否为首次访问，0否 1是，客户端上报 | +| first_visit_time | timestamp | - | 用户首次访问时间 | +| last_visit_time | timestamp | - | 用户最后一次访问时间 | +| total_visit_count | int | - | 用户累计访问次数，客户端上报 | +| entry_page_id | string | - | 本次会话入口页面ID, 同opendb-stat-pages._id | +| exit_page_id | string | - | 本次会话退出页面ID, 同opendb-stat-pages._id | +| page_count | int | - | 本次会话浏览的页面数，服务端计算 | +| event_count | int | - | 本次会话产生的事件数，服务端计算 | +| duration | int | - | 本次会话时长，单位为秒，服务端计算 | +| sdk_version | string | - | 基础库版本号 | +| platform_version | string | - | 平台版本，如微信、支付宝宿主App版本号 | +| device_os | int | - | 设备系统编号，1：安卓，2：iOS，3：PC | +| device_os_version | string | - | 设备系统版本 | +| device_net | string | - | 设备网络型号wifi/3G/4G/ | +| device_vendor | string | - | 设备供应商apple/华为 | +| device_model | string | - | 设备型号iphone8/mate30 | +| device_language | string | - | 设备语言包 | +| device_pixel_ratio | string | - | 设备像素比 | +| device_window_width | string | - | 设备窗口宽度 | +| device_window_height | string | - | 设备窗口高度 | +| device_screen_width | string | - | 设备屏幕宽度 | +| device_screen_height | string | - | 设备屏幕高度 | +| location_ip | string | - | ip地址 | +| location_latitude | double | - | 纬度 | +| location_longitude | double | - | 经度 | +| location_country | string | - | 国家 | +| location_province | string | - | 省份 | +| location_city | string | - | 城市 | +| is_finish | int | - | 本次会话是否结束，0：否，1是，服务端计算 | +| create_time | timestamp | - | 创建时间 | + + +## uni统计-应用事件日志表 opendb-stat-event-logs + +### 字段说明 + +| 字段名 | 类型 | 默认值 | 说明 | +| :--------: | :-----: |:------------: | :-------------------: | +| _id | string | - | ID，系统自动生成 | +| appid | string | - | 客户端上报的应用ID | +| version | string | - | 客户端上报的应用版本号 | +| platform | string | - | 客户端上报的平台code | +| channel | string | - | 客户端上报的渠道code/场景值 | +| uuid | string | - | 客户端上报的用户标志 | +| session_id | string | - | 访问会话日志ID，对应opendb-stat-session-logs._id | +| page_id | string | - | 页面表ID，对应opendb-stat-pages._id | +| event_key | string | - | 客户端上报的key | +| param | string/Object | - | 事件参数 | +| create_time | timestamp | - | 创建时间 | + +//TODO +后续可以验证一下，存储event_key和event_id的差异，主要是性能； + +- 暂定使用event_key + +## uni统计-应用页面访问日志表 opendb-stat-page-logs + +### 字段说明 + +| 字段名 | 类型 |默认值 | 说明 | +| :--------: | :-----: |:-----:| :-------------------: | +| _id | string | - | ID，系统自动生成 | +| appid | string | - | 客户端上报的应用ID | +| version | string | - | 客户端上报的应用版本号 | +| platform | string | - | 客户端上报的平台code | +| channel | string | - | 客户端上报的渠道code/场景值 | +| uuid | string | - | 客户端上报的用户标志 | +| session_id | string | - | 访问会话日志ID，对应opendb-stat-session-logs._id | +| current_page_id | string | - | 当前页面ID，对应opendb-stat-pages._id | +| previous_page_id | string | - | 上级一个页面ID，为空表示第一个页面, 对应opendb-stat-pages._id | +| previous_page_duration| int | - | 上级页面停留时间，单位秒，前端上报 | +| previous_page_is_entry| int | 0 | 上级页面是否为入口页, 0否 1是 |is_outsource +| create_time | timestamp | - | 创建时间 | + + +## uni统计-分享日志表 opendb-stat-share-logs + +### 字段说明 + +| 字段名 | 类型 | 默认值 | 说明 | +| :--------: | :-----: |:-------------:| :-------------------: | +| _id | string | - | ID，系统自动生成 | +| appid | string | - | 客户端上报的应用ID | +| version | string | - | 客户端上报的应用版本号 | +| platform | string | - | 客户端上报的平台code | +| channel | string | - | 客户端上报的渠道code/场景值 | +| uuid | string | - | 客户端上报的用户标志 | +| session_id | string | - | 访问会话日志ID，对应opendb-stat-app-session-logs._id | +| page_id | string | - | 当前页面ID，对应opendb-stat-app-pages._id | +| create_time | timestamp | - | 创建时间 | + + +## uni统计-应用错误日志表 opendb-stat-error-logs + +### 字段说明 + +|字段名 |类型 |默认值 | 说明 | +| :--------: | :-----: |:-----------: | :-------------------: | +| _id | string | - | ID，系统自动生成 | +| appid | string | - | 客户端上报的应用ID | +| version | string | - | 客户端上报的应用版本号 | +| platform | string | - | 客户端上报的平台code | +| channel | string | - | 客户端上报的渠道code/场景值 | +| uuid | string | - | 客户端上报的用户标志 | +| sdk_version | string | - | 小程序基础库版本号 | +| platform_version | string | - | 微信、支付宝宿主App的版本号 | +| errod_msg | string | - | 错误信息 | +| errod_hash | string | - | 错误hash码 | +| create_time | timestamp | - | 创建时间 | + + +# 统计维度 + +***目前只是基础表，会根据实际统计业务进行补充、拆分、合并*** + +## uni统计- 应用统计结果表 opendb-stat-result + +应用统计结果包含： +- 新增 +- 活跃 + +### 字段说明 + +| 字段名 | 类型 | 默认值 | 说明 | +| :--------: | :-----: |:---------:| :-------------------: | +| _id | string | - | ID，系统自动生成 | +| appid | string | - | 统计应用ID，对应opendb-app-list.appid | +| platform_id | string | - | 应用平台ID，对应opendb-stat-app-platforms._id | +| channel_id | string | - | 渠道/场景值ID，对应opendb-stat-app-channels._id| +| version_id | string | - | 应用版本ID，对应opendb-stat-app-versions._id | +| total_users | int | - | 历史累计总用户数 | +| new_user_count | int | - | 本时间段新增用户数 | +| active_user_count| int | - | 本时间段活跃用户数 | +| app_launch_count | int | - | 本时间段App启动或从后台切到前台的次数 | +| page_visit_count | int | - | 本时间段内PV的概念 +| errod_count | int | - | 本时间段报错次数 | +| duration | int | - | 本时间段内，所有用户访问总时长,单位秒 | +| avg_session_time | int | - | 次均停留时长,单位秒 | +| avg_used_time | int | - | 人均停留时长,单位秒 | +| bounce_rate | double | - | 跳出率 | +| retention | object | - | 用户留存信息 | +| dimension | string | - | 统计范围 day:按天统计，hour:按小时统计, week：按周统计，month：按月统计 | +| stat_date | int | - | 统计日期，格式yyyymmdd，例:20211201 | +| start_time | timestamp | - | 开始时间 | +| end_time | timestamp | - | 结束时间 | + +说明： +- bounce_rate计算方式：一次会话仅访问一个页面的启动次数 / 总启动次数 + +- retention 用户留存信息字段结构说明： +``` json +{ + //活跃用户留存信息，可根据业务需要自行拓展 + active_user:{ + //1日后留存 + d_1:{ + //留存用户数 + user_count: 100, + //留存率 + user_rate: 80.30 + }, + //2日后留存 + d_2:{ + user_count: 80, + user_rate: 64.24 + }, + //3日后留存 + d_3:{ + user_count: 70, + user_rate: 56.21 + }, + //4日后留存 + d_4:{ + user_count: 60, + user_rate: 48.18 + }, + //5日后留存 + d_5:{ + user_count: 50, + user_rate: 40.15 + }, + //6日后留存 + d_6:{ + user_count: 40, + user_rate: 32.12 + }, + //7日后留存 + d_7:{ + user_count: 30, + user_rate: 24.90 + }, + //14日后留存 + d_14:{ + user_count: 20, + user_rate: 16.60 + }, + //30日后留存 + d_30:{ + user_count: 10, + user_rate: 8.30 + } + }, + //新增用户留存信息 + new_user:{ + //1日后留存 + d_1:{ + //留存用户数 + user_count: 100, + //留存率 + user_rate: 80.30 + }, + //2日后留存 + d_2:{ + user_count: 80, + user_rate: 64.24 + }, + //3日后留存 + d_3:{ + user_count: 70, + user_rate: 56.21 + }, + //4日后留存 + d_4:{ + user_count: 60, + user_rate: 48.18 + }, + //5日后留存 + d_5:{ + user_count: 50, + user_rate: 40.15 + }, + //6日后留存 + d_6:{ + user_count: 40, + user_rate: 32.12 + }, + //7日后留存 + d_7:{ + user_count: 30, + user_rate: 24.90 + }, + //14日后留存 + d_14:{ + user_count: 20, + user_rate: 16.60 + }, + //30日后留存 + d_30:{ + user_count: 10, + user_rate: 8.30 + } + } +} +``` + + + +## uni统计 - 页面统计结果表 opendb-stat-page-result + +### 字段说明 + +| 字段名 | 类型 | 默认值 | 说明 | +| :--------: | :-----: |:---------:| :-------------------: | +| _id | string | - | ID，系统自动生成 | +| appid | string | - | 统计应用ID，对应opendb-app-list.appid | +| platform_id | string | - | 应用平台ID，对应opendb-stat-app-platforms._id | +| channel_id | string | - | 渠道/场景值ID，对应opendb-stat-app-channels._id | +| version_id | string | - | 应用版本ID，对应opendb-stat-app-versions._id | +| page_id | string | - | 页面表ID，对应opendb-stat-app-pages._id | +| visit_times | int | - | 访问次数 | +| visit_users | int | - | 访问用户数 | +| exit_times | int | - | 从当前页面退出次数 | +| duration | int | - | 访问总时长,单位秒 | +| share_count | int | - | 分享次数 | +| entry_users | int | - | 当前页作为入口页的人数 | +| entry_count | int | - | 当前页作为入口页的总次数 | +| entry_duration | int | - | 当前页作为入口时，本页面的总访问时长,单位秒 | +| bounce_rate | double | - | 跳出率 | +| dimension | string | - | 统计范围 day:按天统计，hour:按小时统计, week：按周统计，month：按月统计 | +| stat_date | int | - | 统计日期，格式yyyymmdd，例:20211201 | +| start_time | timestamp | - | 开始时间 | +| end_time | timestamp | - | 结束时间 | + + +## uni统计 - 事件统计结果表 opendb-stat-event-result + +### 字段说明 + +| 字段名 | 类型 | 默认值 | 说明 | +| :--------: | :-----: |:------------: | :-------------------: | +| _id | string | - | ID，系统自动生成 | +| appid | string | - | 统计应用ID，对应opendb-app-list.appid | +| platform_id | string | - | 应用平台ID，对应opendb-stat-app-platforms._id | +| channel_id | string | - | 渠道/场景值ID，对应opendb-stat-app-channels._id | +| version_id | string | - | 应用版本ID，对应opendb-stat-app-versions._id | +| event_key | string | - | 事件key | +| event_count | int | - | 触发次数 | +| user_count | int | - | 触发该事件的用户数 | +| dimension | string | - | 统计范围 day:按天统计，hour:按小时统计, week：按周统计，month：按月统计 | +| stat_date | int | - | 统计日期，格式yyyymmdd，例:20211201 | +| start_time | timestamp | - | 开始时间 | +| end_time | timestamp | - | 结束时间 | + + +## uni统计 - 错误数据统计结果表 opendb-stat-error-result + +### 字段说明 + +| 字段名 | 类型 | 默认值 | 说明 | +| :--------: | :-----: |:-------------:| :-------------------: | +| _id | string | - | ID，系统自动生成 | +| appid | string | - | 统计应用ID，对应opendb-app-list.appid | +| platform_id | string | - | 应用平台ID，对应opendb-app-platforms._id | +| channel_id | string | - | 渠道/场景值ID，对应opendb-app-channels._id | +| version_id | string | - | 应用版本ID，对应opendb-stat-app-versions._id | +| hash | string | - | 错误hash码 | +| count | int | - | 报错次数 | +| last_time | timestamp | - | 最近一次报错时间 | +| dimension | string | - | 统计范围 day:按天统计，hour:按小时统计, week：按周统计，month：按月统计 | +| stat_date | int | - | 统计日期，格式yyyymmdd，例:20211201 | +| start_time | timestamp | - | 开始时间 | +| end_time | timestamp | - | 结束时间 | + + + +## uni统计 - 忠诚度统计结果表 opendb-stat-loyalty-result + +### 字段说明 + +| 字段名 | 类型 | 默认值 | 说明 | +| :--------: | :-----: |:-------------:| :-------------------: | +| _id | string | - | ID，系统自动生成 | +| appid | string | - | 统计应用ID，对应opendb-app-list.appid | +| platform_id | string | - | 应用平台ID，对应opendb-app-platforms._id | +| channel_id | string | - | 渠道/场景值ID，对应opendb-app-channels._id | +| version_id | string | - | 应用版本ID，对应opendb-stat-app-versions._id | +| visit_depth_data | object | - | 访问深度（页面数量）数据 | +| duration_data | object | - | 访问时长数据 | +| stat_date | int | - | 统计日期，格式yyyymmdd，例:20211201 | +| start_time | timestamp | - | 开始时间 | +| end_time | timestamp | - | 结束时间 | + + +- visit_depth_data 访问深度数据字段结构说明： +``` json +{ + //访问用户数 + visit_users:[ + //仅访问1个页面的总用户数 + p_1:1000, + //仅访问2个页面的总用户数 + p_2:900, + //仅访问3个页面的总用户数 + p_3:800, + //仅访问4个页面的总用户数 + p_4:700, + //访问5-10个页面的总用户数 + p_5:600, + //访问10个以上页面的总用户数 + p_10:500 + ], + //访问次数 + visit_times:[ + //仅访问1个页面的总访问次数 + p_1:1000, + //仅访问2个页面的总访问次数 + p_2:900, + //仅访问3个页面的总访问次数 + p_3:800, + //仅访问4个页面的总访问次数 + p_4:700, + //访问5-10个页面的总访问次数 + p_5:600, + //访问10个以上页面的总访问次数 + p_10:500 + ] +} +``` + + +- duration_data 访问时长数据字段结构说明： +``` json +{ + //访问用户数 + visit_users:{ + //仅访问0-2秒就退出的总用户数 + s_:1000, + //仅访问3-5秒就退出的总用户数 + s_3:900, + //仅访问6-10秒就退出的总用户数 + s_6:800, + //仅访问11-20秒就退出的总用户数 + s_11:700, + //访问21-30秒退出的总用户数 + s_21:600, + //访问31-50秒退出的总用户数 + s_31:500, + //访问51-100秒退出的总用户数 + s_51:400, + //访问100秒以上退出的总用户数 + s_100:300 + }, + //访问次数 + visit_times:{ + //仅访问0-2秒就退出的总访问次数 + s_0:1000, + //仅访问3-5秒就退出的总访问次数 + s_3:900, + //仅访问6-10秒就退出的总访问次数 + s_6:800, + //仅访问11-20秒就退出的总访问次数 + s_11:700, + //访问21-30秒退出的总访问次数 + s_21:600, + //访问31-50秒退出的总访问次数 + s_31:500, + //访问51-100秒退出的总访问次数 + s_51:400, + //访问100秒以上退出的总访问次数 + s_100:300 + } +} +``` \ No newline at end of file