数数埋点 .xlsx:来源阅读件
来源阅读包 · 按目录 · 中文标题 · 正文/图片/附件定位
来源快照;原审核 unknown;本文 draft。阅读件只展示证据,不批准产品规则。
稳定 ID NydKbSPLOoft2Nx1X3Rca3DxnLg;父目录 Gn5lfWIY7l1BWhdFvJzcSIjmnkp;目录 策划文档/基础功能。
飞书原入口;源端显示修改时间 8月10日 11:36;真实revision未知。
原件 raw/策划文档/基础功能/数数埋点 .xlsx;400543字节;SHA-256 67f2c31b56ab72b21bd2492a6287e995aad61571979de9cafd1663641d84c9d1;采集时间 2026-10-13T10:56:20.886205+00:00。原件继续受限保管,不在网站下载。
网页不复刻字体分页/画布;全部XML/rels树、空白样式单元格、合并/隐藏/颜色/公式/绘图及嵌入关系在结构中保留。本页如有媒体,按逐件台账展示:直接可读的媒体保留原字节;需要转换的媒体以无损PNG或完整画布SVG派生展示,转换方法与原/派生指纹见台账;没有执行宏、外部连接或嵌入程序。
抽取缺口:固定载荷无未解决部件读取缺口;真实在线revision、在线智能对象/评论和导出语义一致性仍无独立证据,不称无损在线同步。
工作表 接入必知
sheetId 1;状态 visible;部件 xl/worksheets/sheet1.xml。DEMO/正式版保持原名称,各自独立呈现。
合并区域:C41:I41, J41:L41, E22:G22, E23:L23, J44:L45, C39:I40, E25:L26, C44:I45, C9:D28, C29:D35, C42:I43, J42:L43, J39:L40, E29:L35, E24:K24, E27:L27, C36:L36, C38:L38, E16:G16, E17:G17, E18:L18, E19:G19, E20:G20, E12:G12, H12:L12, E13:L13, E14:G14, E15:G15, E9:L9, E10:G10, H10:L10, E11:G11, H11:L11, C2:L2, C3:L3, C5:L5, E6:G6, H6:L6, C6:D8, E7:G7, H7:L7, E8:G8, H8:L8。样式、颜色、尺寸、隐藏行列、批注/绘图关系保留于结构。
| 坐标 | 内容/缓存 | 公式 | 类型/样式 |
|---|---|---|---|
| C2 | 数据采集需求文档 | s/130 | |
| C3 | 文档中带#的sheet为埋点设计部分,其它sheet为埋点过程中关键问题的设计原理或注意点,可根据实际业务需求进行浏览 | s/131 | |
| C5 | 接入须知:接入前建议先阅读以下相关文档 | s/132 | |
| C6 | 接入必知 | s/141 | |
| E6 | 用户的定义 | s/135 | |
| H6 | 用户识别规则:在TA系统内如何定义一个用户 | s/138 | |
| E7 | 数据规范 | s/135 | |
| H7 | 数据规则:TA系统的数据格式规范 | s/138 | |
| E8 | 预置字段与系统字段 | s/135 | |
| H8 | 预置字段与系统字段 | s/138 | |
| C9 | 接入工具 | s/141 | |
| E9 | TA 提供了全端的数据接入方案,主要接入方式包括: | s/135 | |
| E10 | 客户端SDK | s/147 | |
| H10 | 可以采集到设备信息,以及不与服务器通信的用户行为数据 | s/138 | |
| E11 | 服务端SDK | s/150 | |
| H11 | 采集内容更加精准,适合采集核心业务数据 | s/135 | |
| E12 | 数据导入工具 | s/150 | |
| H12 | 通常用于历史数据导入;服务端 SDK 配合 LogBus 也是比较通用的服务端数据采集方案 | s/153 | |
| E13 | 针对一般应用和 Web 开发,我们提供了: | s/135 | |
| E14 | 原生 SDK | s/135 | |
| H14 | Android SDK | s/96 | |
| J14 | iOS SDK | s/103 | |
| E15 | 第三方框架 | s/135 | |
| H15 | Flutter | s/96 | |
| I15 | RN Android | s/103 | |
| J15 | RN iOS | s/103 | |
| K15 | Weex Android | s/103 | |
| L15 | Weex iOS | s/104 | |
| E16 | H5 开发 | s/135 | |
| H16 | JavaScript SDK | s/96 | |
| J16 | H5 与原生 SDK 打通方案 | s/103 | |
| E17 | 主流小程序、快应用平台 | s/135 | |
| H17 | 小程序 SDK | s/96 | |
| E18 | 针对小游戏开发,我们提供了: | s/135 | |
| E19 | 主流游戏引擎的支持 | s/135 | |
| H19 | LayaBox | s/96 | |
| I19 | Egret 白鹭引擎 | s/103 | |
| J19 | Cocos Creator | s/103 | |
| E20 | 主流小游戏、快游戏平台的支持 | s/135 | |
| H20 | 小游戏 SDK | s/96 | |
| E21 | 针对手游开发,我们提供了: | s/97 | |
| H21 | Unity SDK | s/99 | |
| J21 | 虚幻 4 SDK | s/99 | |
| E22 | 对于服务端采集方案,我们推荐: | s/141 | |
| H22 | 服务端 SDK + | s/100 | |
| I22 | Logbus 的方案 | s/106 | |
| E23 | 该方案在数据导入的稳定性、实时性、和效率方面都有比较好的表现。 | s/162 | |
| E24 | 如果您有一些异构的历史数据需要导入,或者对于部分数据需要补录到 TA 系统中,可考虑使用 | s/167 | |
| L24 | DataX | s/109 | |
| E25 | 与 Logbus 方案不同,DataX 不是常驻服务,无法监控新数据的产生并且及时导入,因此不能保证数据的实时性。 DataX 的优势在于支持多种数据源的异构数据导入,操作简单。 | s/170 | |
| E27 | 如果您使用了 Filebeat 和 Logstash 收集日志,并且希望将日志数据导入到 TA 系统,可以使用: | s/167 | |
| E28 | Filebeat +Logstash 方案 | s/101 | |
| C29 | 接入必备信息 | s/141 | |
| E29 | 1.项目 APP ID:在 TA 后台创建项目的时候会生成项 目的 APP ID,也可以在项目管理页面查看 2.确定数据接收端地址 如果使用云服务, 接收端地址为: https://receiver.ta.thinkingdata.cn 对于私有化部署的情况,需要在私有集群(或者接入点)绑定域名,并配置 SSL 证书 3.验证接收端地址:浏览器访问 https://YOUR_RECEIVER_URL/health-check,页面返回 ok 表示正确 4.数据采集方案,要包括: 数据接入的方式:客户端 SDK、服务端 SDK、数据导入工具、或者几种方案结合的方式 待接入数据的内容和触发时机 | s/168 | |
| C36 | 针对上述接入方式,可针对实际业务情况进行选择,如有问题,可联系数数服务人员配合进行选型 | s/156 | |
| C38 | 重点关注点:以下事项会直接影响埋点可用性,请关注 | s/130 | |
| C39 | 关于数据类型的设计原则:数数分析系统内属性(即字段)的类型由该属性首次入库时的类型决定,因此建议在埋点时重点确认相关属性的类型,避免后续进行修改迁移 | s/167 | |
| J39 | 数据类型设计原则 | s/174 | |
| C41 | 如希望同时接入服务端与客户端的数据,请关注右侧文档 | s/135 | |
| J41 | 多端接入注意点 | s/138 | |
| C42 | 如项目中存在多个需要关注的用户ID体系,如角色id、账号id、设备id等,建议在埋点前优先梳理用户id相关的策略 | s/173 | |
| J42 | 多用户id体系的埋点建议 | s/165 | |
| C44 | 公共事件属性是所有(或大部分)事件都具有的属性,如果使用客户端sdk上传数据,需要注意在用户退出登录之后,需要手动清除目前已经设置的公共事件属性 | s/173 | |
| J44 | 公共事件属性设置方式 | s/165 |
全部单元格记录 431;公式 0。只有样式的空格在结构JSON,不省略其原结构。
工作表 埋点注意事项
sheetId 2;状态 visible;部件 xl/worksheets/sheet2.xml。DEMO/正式版保持原名称,各自独立呈现。
合并区域:无。样式、颜色、尺寸、隐藏行列、批注/绘图关系保留于结构。
| 坐标 | 内容/缓存 | 公式 | 类型/样式 |
|---|---|---|---|
| B1 | 类型 | s/86 | |
| C1 | 说明 | s/86 | |
| D1 | 链接 | s/86 | |
| A2 | Q1 | s/87 | |
| B2 | 埋点数据类型 | s/87 | |
| C2 | 详情参考-数据类型设计原则; 1. 事件名/属性名:String类型,可以数字或字母开头,可包含数字,字母和下划线“_”,长度最大为50个字符,对字母大小写不敏感,只有预置属性能以#号开头; 2. 属性字段类型,由该属性首次入库时的类型决定,当入库类型错误时 方案1:使用二次开发工具强改类型,但已入库数据的该字段值会被置null(前期数据测试阶段可使用) 方案2:使用类型虚拟属性转换类型,后续分析使用对应虚拟属性即可 方案3:保留原字段,使用新的字段上报类型正确的数据,后续用虚拟属性联合去重 3. 数值类型字段,请注意取值限制。不需要做数值运算的字段,建议使用文本类型。 | s/88 | |
| D2 | 修改数据类型:https://docs.thinkingdata.cn/ta-manual/latest/technical_document/ta_tool/modify_meta.html | s/89 | |
| A3 | Q2 | s/87 | |
| B3 | ID体系 | s/87 | |
| C3 | 详情参考-ID体系常见疑问; 1. 请先确定各类数据上报顺序及方式,在埋点前与分析师确认id方案; 2. 客户端sdk若需自定义#distinct_id,请在上传数据之前进行配置; 【一句话总结:首次上报#account_id一定要带上#distinct_id,否者就会绑定失败】 | s/88 | |
| D3 | 安卓sdk自定义访客id: https://doc.thinkingdata.cn/ta-manual/latest/installation/installation_menu/client_sdk/android_sdk_installation/android_sdk_installation.html#_2-1-%E8%AE%BE%E7%BD%AE%E8%AE%BF%E5%AE%A2-id-%E5%8F%AF%E9%80%89 | s/89 | |
| A4 | Q3 | s/87 | |
| B4 | 时区设置(#zone_offset) | s/87 | |
| C4 | 1. 海外多地区发行: 建议方案:按当地时间+时区上报 客户端sdk: 默认使用【本机时间+时区】作为事件发生时间上报; 也可指定偏移到某一时区再上报数据,参考sdk文档配置; 服务端sdk:需要自行设置时区字段("#zone_offset":8); 若服务器无法获取客户端当地时间,则按服务器时区上报。 2. 仅国内或者某一个地区发行: 默认当地时间上报即可; | s/90 | |
| D4 | 安卓sdk设置默认时区: https://docs.thinkingdata.cn/ta-manual/latest/installation/installation_menu/client_sdk/android_sdk_installation/android_sdk_installation.html#_6-7-%E8%AE%BE%E7%BD%AE%E9%BB%98%E8%AE%A4%E6%97%B6%E5%8C%BA | s/89 | |
| A5 | Q4 | s/87 | |
| B5 | 时间校准 | s/87 | |
| C5 | 1. 建议在客户端sdk初始化的时候,上报数据前,进行时间校准,避免用户修改本机时间导致时间超前,数据无法入库;(客户端数据入库时间范围前10天后3天) 此处的时间校准,校准的是当前时间戳,不存在校准时区,时区设置请参考文档; 2. 多端数据上报时,注意事件时间先后顺序 | s/90 | |
| D5 | 安卓sdk时间校准:https://docs.thinkingdata.cn/ta-manual/latest/installation/installation_menu/client_sdk/android_sdk_installation/android_sdk_installation.html#_6-8-%E6%A0%A1%E5%87%86%E6%97%B6%E9%97%B4 | s/89 | |
| A6 | Q5 | s/87 | |
| B6 | 打印日志 | s/87 | |
| C6 | 客户端sdk有打印日志开关,若数据上报问题需调试,可打印日志再做分析 | s/23 | |
| D6 | 安卓sdk打印日志: https://doc.thinkingdata.cn/ta-manual/latest/installation/installation_menu/client_sdk/android_sdk_installation/android_sdk_installation.html#_6-2-%E6%89%93%E5%8D%B0%E4%B8%8A%E4%BC%A0%E6%95%B0%E6%8D%AE-log | s/89 | |
| A7 | Q6 | s/87 | |
| B7 | debug模式 | s/87 | |
| C7 | 前期进行数据上报时可以选择开启sdk中的debug模式上报,同时结合数数后台【数据管理- 埋点管理-Debug模式】功能,进行埋点数据的一对一校验,此处的设备ID可通过查看客户端日志获取。 | s/23 | |
| D7 | 安卓开启debug模式:https://docs.thinkingdata.cn/ta-manual/latest/installation/installation_menu/client_sdk/android_sdk_installation/android_sdk_installation.html#_6-6-%E5%BC%80%E5%90%AF-debug-%E6%A8%A1%E5%BC%8F | s/89 | |
| A8 | Q7 | s/87 | |
| B8 | 服务端数据上报 | s/87 | |
| C8 | 1. 服务端上报数据时,#time字段需赋值=事件发生时间,#ip取客户端ip 2. 正式环境下,建议使用服务端sdk(LogConsumer)+logbus的方式上报,如果使用batch方式上报,在长时间网络中断情况下,存在数据丢失的风险。 | s/23 | |
| A9 | Q8 | s/87 | |
| B9 | 数据校验 | s/87 | |
| C9 | 数据接入完成后,请先跑少量测试数据进行数据校验,请特别注意校验id体系是否绑定成功。 | s/23 |
全部单元格记录 49;公式 0。只有样式的空格在结构JSON,不省略其原结构。
工作表 #用户ID体系
sheetId 3;状态 visible;部件 xl/worksheets/sheet3.xml。DEMO/正式版保持原名称,各自独立呈现。
合并区域:A2:A3, A4:A5, A6:A7, F2:F3, F4:F5, F6:F7。样式、颜色、尺寸、隐藏行列、批注/绘图关系保留于结构。
| 坐标 | 内容/缓存 | 公式 | 类型/样式 |
|---|---|---|---|
| A1 | 游戏类型 | s/79 | |
| B1 | 属性名 | s/80 | |
| C1 | 属性显示名 | s/80 | |
| D1 | 属性说明 | s/80 | |
| E1 | 赋值说明 | s/80 | |
| F1 | 建议使用 | s/79 | |
| A2 | 无账号体系 | s/180 | |
| B2 | #account_id | s/81 | |
| C2 | 账户id | s/81 | |
| D2 | 系统属性 | s/81 | |
| E2 | NULL | s/81 | |
| B3 | #distinct_id | s/81 | |
| C3 | 访客id | s/81 | |
| D3 | 系统属性 | s/81 | |
| E3 | 设备相关id或业务内的访客id,如使用客户端sdk,则无需关注 | s/81 | |
| A4 | 单账号单角色 | s/180 | |
| B4 | #account_id | s/81 | |
| C4 | 账户id | s/81 | |
| D4 | 系统属性 | s/81 | |
| E4 | 设置为玩家账号ID即可 | s/81 | |
| B5 | #distinct_id | s/81 | |
| C5 | 访客id | s/81 | |
| D5 | 系统属性 | s/81 | |
| E5 | 设备相关id或业务内的访客id,如使用客户端sdk,则无需关注 | s/81 | |
| A6 | 单账号多角色 | s/181 | |
| B6 | #account_id | s/82 | |
| C6 | 账户id | s/82 | |
| D6 | 系统属性 | s/82 | |
| E6 | 设置为角色id,角色所属账户ID设置为角色的自定义属性(整个项目唯一,不能重复) | s/82 | |
| B7 | #distinct_id | s/82 | |
| C7 | 访客id | s/82 | |
| D7 | 系统属性 | s/82 | |
| E7 | 设备相关id或业务内的访客id,如使用客户端sdk,则无需关注 | s/82 |
全部单元格记录 42;公式 0。只有样式的空格在结构JSON,不省略其原结构。
工作表 #事件数据
sheetId 4;状态 visible;部件 xl/worksheets/sheet4.xml。DEMO/正式版保持原名称,各自独立呈现。
合并区域:A85:A94, B85:B94, C85:C94, D85:D94, A95:A99, B95:B99, C95:C99, D95:D99, A80:A84, B80:B84, C80:C84, D80:D84, A68:A72, B68:B72, C68:C72, D68:D72, A73:A76, B73:B76, C73:C76, D73:D76, A77:A79, B77:B79, C77:C79, D77:D79, C58:C62, D58:D62, A63:A67, B63:B67, C63:C67, D63:D67, A58:A62, B58:B62, D28:D32, D33:D36, D37:D40, D41:D45, C2:C4, C5:C10, C11:C14, D2:D4, D5:D10, D11:D14, D15:D23, D24:D27, C15:C23, C24:C27, C41:C45, C28:C32, C33:C36, C37:C40, B28:B32, B33:B36, B37:B40, B41:B45, A2:A4, A5:A10, A11:A14, A15:A23, A24:A27, B2:B4, B5:B10, B11:B14, B15:B23, B24:B27, A41:A45, A28:A32, A33:A36, A37:A40, A46:A49, B46:B49, C46:C49, D46:D49, A50:A57, B50:B57, C50:C57, D50:D57。样式、颜色、尺寸、隐藏行列、批注/绘图关系保留于结构。
| 坐标 | 内容/缓存 | 公式 | 类型/样式 |
|---|---|---|---|
| A1 | 事件标签 | s/54 | |
| B1 | 事件名(必填) | s/54 | |
| C1 | 事件显示名 | s/54 | |
| D1 | 事件说明 | s/55 | |
| E1 | 属性名(必填) | s/54 | |
| F1 | 属性显示名 | s/54 | |
| G1 | 属性类型(必填) | s/54 | |
| H1 | 备注 | s/55 | |
| I1 | 属性说明 | s/55 | |
| A2 | 留存 | s/121 | |
| B2 | role_register | s/124 | |
| C2 | 角色注册 | s/124 | |
| D2 | 角色注册时触发 | s/124 | |
| E2 | #account_id | s/56 | |
| F2 | 角色ID | s/56 | |
| G2 | 文本 | s/57 | |
| H2 | 预置属性 | s/58 | |
| E3 | #country | s/59 | |
| F3 | 国家 | s/59 | |
| G3 | 文本 | s/60 | |
| H3 | 预置属性 | s/61 | |
| E4 | current_server_id | s/62 | |
| F4 | 服务器id | s/62 | |
| G4 | 文本 | s/63 | |
| H4 | 公共属性 | s/64 | |
| A5 | 留存 | s/113 | |
| B5 | role_login | s/116 | |
| C5 | 角色登录 | s/116 | |
| D5 | 角色登录时触发 | s/116 | |
| E5 | #account_id | s/56 | |
| F5 | 角色ID | s/56 | |
| G5 | 文本 | s/57 | |
| H5 | 预置属性 | s/58 | |
| E6 | #country | s/65 | |
| F6 | 国家 | s/65 | |
| G6 | 文本 | s/66 | |
| H6 | 预置属性 | s/67 | |
| E7 | current_server_id | s/65 | |
| F7 | 服务器id | s/65 | |
| G7 | 数值 | s/66 | |
| H7 | 公共属性 | s/67 | |
| E8 | last_logout_time | s/50 | |
| F8 | 上次登出时间 | s/50 | |
| G8 | 时间 | s/66 | |
| E9 | continuous_login_day | s/65 | |
| F9 | 连续登录天数 | s/65 | |
| G9 | 数值 | s/66 | |
| E10 | total_login_day | s/62 | |
| F10 | 累计登录天数 | s/62 | |
| G10 | 数值 | s/63 | |
| A11 | 留存 | s/113 | |
| B11 | role_logout | s/116 | |
| C11 | 角色登出 | s/116 | |
| D11 | 角色离线时触发 | s/116 | |
| E11 | #account_id | s/56 | |
| F11 | 角色ID | s/56 | |
| G11 | 文本 | s/57 | |
| H11 | 预置属性 | s/58 | |
| E12 | #country | s/65 | |
| F12 | 国家 | s/65 | |
| G12 | 文本 | s/66 | |
| H12 | 预置属性 | s/67 | |
| E13 | current_server_id | s/65 | |
| F13 | 服务器id | s/65 | |
| G13 | 数值 | s/66 | |
| H13 | 公共属性 | s/67 | |
| E14 | last_login_time | s/68 | |
| F14 | 上次登录时间 | s/68 | |
| G14 | 时间 | s/63 | |
| A15 | 基础功能 | s/113 | |
| B15 | item_change | s/127 | |
| C15 | 道具日志 | s/116 | |
| D15 | 玩家道具数量发生变化时触发 | s/116 | |
| E15 | #account_id | s/56 | |
| F15 | 角色ID | s/56 | |
| G15 | 文本 | s/57 | |
| H15 | 预置属性 | s/58 | |
| E16 | #country | s/65 | |
| F16 | 国家 | s/65 | |
| G16 | 文本 | s/66 | |
| H16 | 预置属性 | s/67 | |
| E17 | current_server_id | s/65 | |
| F17 | 服务器id | s/65 | |
| G17 | 数值 | s/66 | |
| H17 | 公共属性 | s/67 | |
| E18 | item_id | s/65 | |
| F18 | 道具ID | s/65 | |
| G18 | 数值 | s/66 | |
| E19 | change_way | s/65 | |
| F19 | 变化途径大类 | s/65 | |
| G19 | 数值 | s/66 | |
| I19 | 如:邮件领取、挂机领取等 | s/76 | |
| E20 | change_before | s/65 | |
| F20 | 变化前数量 | s/65 | |
| G20 | 数值 | s/66 | |
| E21 | change_num | s/65 | |
| F21 | 变化数量 | s/65 | |
| G21 | 数值 | s/66 | |
| E22 | change_after | s/65 | |
| F22 | 变化后数量 | s/65 | |
| G22 | 数值 | s/66 | |
| E23 | change_type | s/62 | |
| F23 | 变化类型 | s/62 | |
| G23 | 文本 | s/63 | |
| I23 | 道具的消耗、获得 | s/77 | |
| A24 | 玩法 | s/113 | |
| B24 | AFK_reward | s/116 | |
| C24 | 挂机领奖 | s/116 | |
| D24 | 领取挂机奖励时触发 | s/116 | |
| E24 | #account_id | s/56 | |
| F24 | 角色ID | s/56 | |
| G24 | 文本 | s/57 | |
| H24 | 预置属性 | s/69 | |
| E25 | #country | s/65 | |
| F25 | 国家 | s/65 | |
| G25 | 文本 | s/66 | |
| H25 | 预置属性 | s/70 | |
| E26 | current_server_id | s/65 | |
| F26 | 服务器id | s/65 | |
| G26 | 数值 | s/66 | |
| H26 | 公共属性 | s/70 | |
| E27 | AFK_time | s/62 | |
| F27 | 挂机时长 | s/62 | |
| G27 | 数值 | s/63 | |
| I27 | 领取奖励时,累计挂机的时长(分钟) | s/77 | |
| A28 | 基础功能 | s/113 | |
| B28 | task | s/116 | |
| C28 | 任务 | s/116 | |
| D28 | 任务完成时触发 | s/116 | |
| E28 | #account_id | s/56 | |
| F28 | 角色ID | s/56 | |
| G28 | 文本 | s/57 | |
| H28 | 预置属性 | s/69 | |
| E29 | #country | s/65 | |
| F29 | 国家 | s/65 | |
| G29 | 文本 | s/66 | |
| H29 | 预置属性 | s/70 | |
| E30 | current_server_id | s/65 | |
| F30 | 服务器id | s/65 | |
| G30 | 数值 | s/66 | |
| H30 | 公共属性 | s/70 | |
| E31 | task_id | s/65 | |
| F31 | 任务ID | s/71 | |
| G31 | 数值 | s/66 | |
| E32 | task_group | s/62 | |
| F32 | 任务组 | s/62 | |
| G32 | 数值 | s/63 | |
| A33 | 基础功能 | s/113 | |
| B33 | task_daily | s/116 | |
| C33 | 每日活跃 | s/116 | |
| D33 | 活跃度增加时触发 | s/116 | |
| E33 | #account_id | s/56 | |
| F33 | 角色ID | s/56 | |
| G33 | 文本 | s/57 | |
| H33 | 预置属性 | s/69 | |
| E34 | #country | s/65 | |
| F34 | 国家 | s/65 | |
| G34 | 文本 | s/66 | |
| H34 | 预置属性 | s/70 | |
| E35 | current_server_id | s/65 | |
| F35 | 服务器id | s/65 | |
| G35 | 数值 | s/66 | |
| H35 | 公共属性 | s/70 | |
| E36 | daily_activity | s/62 | |
| F36 | 活跃度 | s/62 | |
| G36 | 数值 | s/63 | |
| A37 | 基础功能 | s/113 | |
| B37 | task_week | s/116 | |
| C37 | 每周活跃 | s/116 | |
| D37 | 活跃度增加时触发 | s/116 | |
| E37 | #account_id | s/56 | |
| F37 | 角色ID | s/56 | |
| G37 | 文本 | s/57 | |
| H37 | 预置属性 | s/69 | |
| E38 | #country | s/65 | |
| F38 | 国家 | s/65 | |
| G38 | 文本 | s/66 | |
| H38 | 预置属性 | s/70 | |
| E39 | current_server_id | s/65 | |
| F39 | 服务器id | s/65 | |
| G39 | 数值 | s/66 | |
| H39 | 公共属性 | s/70 | |
| E40 | daily_activity | s/62 | |
| F40 | 活跃度 | s/62 | |
| G40 | 数值 | s/63 | |
| A41 | 养成线 | s/113 | |
| B41 | hero_level | s/116 | |
| C41 | 英雄升级 | s/116 | |
| D41 | 英雄升级时触发 | s/116 | |
| E41 | #account_id | s/56 | |
| F41 | 角色ID | s/56 | |
| G41 | 文本 | s/57 | |
| H41 | 预置属性 | s/69 | |
| E42 | #country | s/65 | |
| F42 | 国家 | s/65 | |
| G42 | 文本 | s/66 | |
| H42 | 预置属性 | s/70 | |
| E43 | current_server_id | s/65 | |
| F43 | 服务器id | s/65 | |
| G43 | 数值 | s/66 | |
| H43 | 公共属性 | s/70 | |
| E44 | hero_id | s/65 | |
| F44 | 英雄ID | s/71 | |
| G44 | 数值 | s/66 | |
| E45 | hero_level | s/62 | |
| F45 | 英雄等级 | s/62 | |
| G45 | 数值 | s/63 | |
| A46 | 基础功能 | s/113 | |
| B46 | ad | s/116 | |
| C46 | 广告 | s/116 | |
| D46 | 看完广告时触发 | s/116 | |
| E46 | #account_id | s/56 | |
| F46 | 角色ID | s/56 | |
| G46 | 文本 | s/57 | |
| H46 | 预置属性 | s/69 | |
| E47 | #country | s/65 | |
| F47 | 国家 | s/65 | |
| G47 | 文本 | s/66 | |
| H47 | 预置属性 | s/70 | |
| E48 | current_server_id | s/65 | |
| F48 | 服务器id | s/65 | |
| G48 | 数值 | s/66 | |
| H48 | 公共属性 | s/70 | |
| E49 | ad_type | s/62 | |
| F49 | 广告类型 | s/62 | |
| G49 | 数值 | s/63 | |
| I49 | 如;商店广告、体力广告 | s/77 | |
| A50 | 留存 | s/113 | |
| B50 | mission | s/116 | |
| C50 | 关卡 | s/116 | |
| D50 | 关卡每波怪开始时触发 | s/116 | |
| E50 | #account_id | s/56 | |
| F50 | 角色ID | s/56 | |
| G50 | 文本 | s/57 | |
| H50 | 预置属性 | s/69 | |
| E51 | #country | s/65 | |
| F51 | 国家 | s/65 | |
| G51 | 文本 | s/66 | |
| H51 | 预置属性 | s/70 | |
| E52 | current_server_id | s/65 | |
| F52 | 服务器id | s/65 | |
| G52 | 数值 | s/66 | |
| H52 | 公共属性 | s/70 | |
| E53 | mission_id | s/71 | |
| F53 | 关卡ID | s/71 | |
| G53 | 数值 | s/66 | |
| E54 | round | s/71 | |
| F54 | 波次 | s/71 | |
| G54 | 数值 | s/203 | |
| E55 | monster_count | s/71 | |
| F55 | 剩余怪物数量 | s/71 | |
| G55 | 数值 | s/203 | |
| H55 | 新增 | s/204 | |
| I55 | 记当前场面剩下的怪物数量 | s/78 | |
| E56 | card_count | s/71 | |
| F56 | 释放卡牌次数 | s/71 | |
| G56 | 数值 | s/203 | |
| H56 | 新增 | s/204 | |
| I56 | 从开始累计到此刻为止,共使用的卡牌次数 | s/78 | |
| E57 | skill_count | s/62 | |
| F57 | 释放大招次数 | s/62 | |
| G57 | 数值 | s/63 | |
| H57 | 新增 | s/205 | |
| I57 | 从开始累计到此刻为止,共使用的大招次数 | s/77 | |
| A58 | 玩法 | s/113 | |
| B58 | fief | s/116 | |
| C58 | 领地 | s/116 | |
| D58 | 领地获取物资时触发(自己拉/抢夺别人) | s/116 | |
| E58 | #account_id | s/56 | |
| F58 | 角色ID | s/56 | |
| G58 | 文本 | s/57 | |
| H58 | 预置属性 | s/69 | |
| E59 | #country | s/65 | |
| F59 | 国家 | s/65 | |
| G59 | 文本 | s/66 | |
| H59 | 预置属性 | s/70 | |
| E60 | current_server_id | s/65 | |
| F60 | 服务器id | s/65 | |
| G60 | 数值 | s/66 | |
| H60 | 公共属性 | s/70 | |
| E61 | fief_level | s/71 | |
| F61 | 领地等级 | s/65 | |
| G61 | 数值 | s/66 | |
| I61 | 自身的领地等级 | s/78 | |
| E62 | fief_item | s/62 | |
| F62 | 获取的物资 | s/62 | |
| G62 | 数值 | s/63 | |
| I62 | 获取到的物资道具ID | s/77 | |
| A63 | 玩法 | s/113 | |
| B63 | lottery | s/116 | |
| C63 | 抽奖 | s/116 | |
| D63 | 抽奖时触发 | s/116 | |
| E63 | #account_id | s/56 | |
| F63 | 角色ID | s/56 | |
| G63 | 文本 | s/57 | |
| H63 | 预置属性 | s/69 | |
| E64 | #country | s/65 | |
| F64 | 国家 | s/65 | |
| G64 | 文本 | s/66 | |
| H64 | 预置属性 | s/70 | |
| E65 | current_server_id | s/65 | |
| F65 | 服务器id | s/65 | |
| G65 | 数值 | s/66 | |
| H65 | 公共属性 | s/70 | |
| E66 | lottery_type | s/71 | |
| F66 | 抽奖类型 | s/65 | |
| G66 | 文本 | s/66 | |
| I66 | 装备/符文/普通招募/高级招募 | s/78 | |
| E67 | lottery_count | s/62 | |
| F67 | 消耗的抽奖道具数量 | s/62 | |
| G67 | 数值 | s/63 | |
| A68 | 养成线 | s/113 | |
| B68 | player_level | s/116 | |
| C68 | 玩家等级 | s/116 | |
| D68 | 玩家等级升级时触发 | s/116 | |
| E68 | #account_id | s/56 | |
| F68 | 角色ID | s/56 | |
| G68 | 文本 | s/57 | |
| H68 | 预置属性 | s/69 | |
| E69 | #country | s/65 | |
| F69 | 国家 | s/65 | |
| G69 | 文本 | s/66 | |
| H69 | 预置属性 | s/70 | |
| E70 | current_server_id | s/65 | |
| F70 | 服务器id | s/65 | |
| G70 | 数值 | s/66 | |
| H70 | 公共属性 | s/70 | |
| E71 | player_level | s/65 | |
| F71 | 玩家等级 | s/71 | |
| G71 | 数值 | s/66 | |
| E72 | player_power | s/62 | |
| F72 | 主角攻击力 | s/62 | |
| G72 | 数值 | s/63 | |
| A73 | 活动 | s/113 | |
| B73 | activity_mission | s/116 | |
| C73 | 关卡冲刺 | s/116 | |
| D73 | 玩家达到要求时触发 | s/116 | |
| E73 | #account_id | s/56 | |
| F73 | 角色ID | s/56 | |
| G73 | 文本 | s/57 | |
| H73 | 预置属性 | s/69 | |
| E74 | #country | s/65 | |
| F74 | 国家 | s/65 | |
| G74 | 文本 | s/66 | |
| H74 | 预置属性 | s/70 | |
| E75 | current_server_id | s/65 | |
| F75 | 服务器id | s/65 | |
| G75 | 数值 | s/66 | |
| H75 | 公共属性 | s/70 | |
| E76 | activity_mission_id | s/62 | |
| F76 | 关卡要求 | s/62 | |
| G76 | 数值 | s/63 | |
| I76 | 活动要求通关的关卡ID | s/77 | |
| A77 | 留存 | s/121 | |
| B77 | InitGame | s/124 | |
| C77 | 加载游戏 | s/124 | |
| D77 | 每达到一个步骤即触发 | s/124 | |
| E77 | #account_id | s/56 | |
| F77 | 角色ID | s/56 | |
| G77 | 文本 | s/57 | |
| H77 | 预置属性 | s/69 | |
| E78 | #country | s/65 | |
| F78 | 国家 | s/65 | |
| G78 | 文本 | s/66 | |
| H78 | 预置属性 | s/70 | |
| E79 | step | s/65 | |
| F79 | 步骤 | s/65 | |
| G79 | 文本 | s/66 | |
| H79 | 公共属性 | s/70 | |
| I79 | 细分从启动APP到成功加载完第一关场景中间的所有步骤 | s/77 | |
| A80 | 养成线 | s/113 | |
| B80 | card_level | s/116 | |
| C80 | 卡牌等级 | s/116 | |
| D80 | 卡牌升级时触发 | s/116 | |
| E80 | #account_id | s/56 | |
| F80 | 角色ID | s/56 | |
| G80 | 文本 | s/57 | |
| H80 | 预置属性 | s/69 | |
| E81 | #country | s/65 | |
| F81 | 国家 | s/65 | |
| G81 | 文本 | s/66 | |
| H81 | 预置属性 | s/70 | |
| E82 | current_server_id | s/65 | |
| F82 | 服务器id | s/65 | |
| G82 | 数值 | s/66 | |
| H82 | 公共属性 | s/70 | |
| E83 | card_id | s/65 | |
| F83 | 卡牌id | s/71 | |
| G83 | 数值 | s/66 | |
| E84 | card_step | s/62 | |
| F84 | 卡牌阶级 | s/62 | |
| G84 | 数值 | s/63 | |
| A85 | 留存 | s/113 | |
| B85 | mission_result | s/116 | |
| C85 | 关卡结算 | s/116 | |
| D85 | 关卡结算时触发(胜利、失败、手动退出) | s/116 | |
| E85 | #account_id | s/56 | |
| F85 | 角色ID | s/56 | |
| G85 | 文本 | s/57 | |
| H85 | 预置属性 | s/69 | |
| E86 | #country | s/65 | |
| F86 | 国家 | s/65 | |
| G86 | 文本 | s/66 | |
| H86 | 预置属性 | s/70 | |
| E87 | current_server_id | s/65 | |
| F87 | 服务器id | s/65 | |
| G87 | 数值 | s/66 | |
| H87 | 公共属性 | s/70 | |
| E88 | mission_id | s/71 | |
| F88 | 关卡ID | s/71 | |
| G88 | 数值 | s/66 | |
| E89 | mission_result | s/71 | |
| F89 | 关卡结果 | s/71 | |
| G89 | 文本 | s/66 | |
| I89 | 分三种情况:胜利、失败、手动退出 | s/78 | |
| E90 | round | s/71 | |
| F90 | 波次 | s/71 | |
| G90 | 数值 | s/203 | |
| I90 | 关卡结算时所在的波次 | s/78 | |
| E91 | wall_hp | s/71 | |
| F91 | 城墙血量 | s/71 | |
| G91 | 数值 | s/203 | |
| I91 | 记当前城墙的血量 | s/78 | |
| E92 | monster_count | s/71 | |
| F92 | 剩余怪物数量 | s/71 | |
| G92 | 数值 | s/203 | |
| I92 | 记当前场面剩下的怪物数量 | s/78 | |
| E93 | card_count | s/71 | |
| F93 | 释放卡牌次数 | s/71 | |
| G93 | 数值 | s/203 | |
| I93 | 从开始累计到此刻为止,共使用的卡牌次数 | s/78 | |
| E94 | skill_count | s/62 | |
| F94 | 释放大招次数 | s/62 | |
| G94 | 数值 | s/63 | |
| I94 | 从开始累计到此刻为止,共使用的大招次数 | s/77 | |
| A95 | 留存 | s/113 | |
| B95 | auto_battle | s/116 | |
| C95 | 自动战斗 | s/116 | |
| D95 | 开启/关闭自动战斗时触发 | s/116 | |
| E95 | #account_id | s/56 | |
| F95 | 角色ID | s/56 | |
| G95 | 文本 | s/57 | |
| H95 | 预置属性 | s/69 | |
| E96 | #country | s/65 | |
| F96 | 国家 | s/65 | |
| G96 | 文本 | s/66 | |
| H96 | 预置属性 | s/70 | |
| E97 | current_server_id | s/65 | |
| F97 | 服务器id | s/65 | |
| G97 | 数值 | s/66 | |
| H97 | 公共属性 | s/70 | |
| E98 | mission_id | s/71 | |
| F98 | 关卡ID | s/71 | |
| G98 | 数值 | s/66 | |
| E99 | auto_battle | s/62 | |
| F99 | 自动战斗开关 | s/62 | |
| G99 | 文本 | s/63 | |
| I99 | 记录开启或关闭 | s/77 |
全部单元格记录 891;公式 0。只有样式的空格在结构JSON,不省略其原结构。
工作表 #公共事件属性
sheetId 5;状态 visible;部件 xl/worksheets/sheet5.xml。DEMO/正式版保持原名称,各自独立呈现。
合并区域:无。样式、颜色、尺寸、隐藏行列、批注/绘图关系保留于结构。
| 坐标 | 内容/缓存 | 公式 | 类型/样式 |
|---|---|---|---|
| A1 | 属性名(必填) | s/51 | |
| B1 | 属性显示名 | s/51 | |
| C1 | 属性类型(必填) | s/51 | |
| D1 | 状态 | s/48 | |
| E1 | 属性说明 | s/52 | |
| A2 | #country | s/13 | |
| B2 | 国家 | s/13 | |
| C2 | 文本 | s/13 | |
| E2 | 默认预置属性 | s/53 | |
| A3 | #account_id | s/13 | |
| B3 | 角色ID | s/13 | |
| C3 | 文本 | s/13 | |
| E3 | 默认预置属性 | s/53 | |
| A4 | #device_type | s/13 | |
| B4 | 设备类型 | s/13 | |
| C4 | 文本 | s/13 | |
| E4 | 默认预置属性 | s/53 | |
| A5 | #device_model | s/13 | |
| B5 | 设备型号 | s/13 | |
| C5 | 文本 | s/13 | |
| E5 | 默认预置属性 | s/53 | |
| A6 | #ram | s/13 | |
| B6 | 内存 | s/13 | |
| C6 | 数值 | s/13 | |
| E6 | 默认预置属性 | s/53 | |
| A7 | #zone_offset | s/13 | |
| B7 | 时区偏移 | s/13 | |
| C7 | 数值 | s/13 | |
| E7 | 默认预置属性 | s/53 | |
| A8 | current_server_id | s/13 | |
| B8 | 服务器id | s/13 | |
| C8 | 文本 | s/13 | |
| E8 | 新增公共属性 | s/53 |
全部单元格记录 40;公式 0。只有样式的空格在结构JSON,不省略其原结构。
工作表 #用户属性
sheetId 6;状态 visible;部件 xl/worksheets/sheet6.xml。DEMO/正式版保持原名称,各自独立呈现。
合并区域:无。样式、颜色、尺寸、隐藏行列、批注/绘图关系保留于结构。
| 坐标 | 内容/缓存 | 公式 | 类型/样式 |
|---|---|---|---|
| A1 | 属性名(必填) | s/48 | |
| B1 | 属性显示名 | s/48 | |
| C1 | 属性类型(必填) | s/48 | |
| D1 | 更新方式 | s/48 | |
| E1 | 属性说明 | s/48 | |
| F1 | 状态 | s/48 | |
| G1 | 备注 | s/48 | |
| A2 | #account_id | s/13 | |
| B2 | 账户ID | s/13 | |
| C2 | 文本 | s/13 | |
| D2 | user_setOnce | s/13 | |
| E2 | 相当于游戏内角色ID | s/13 |
全部单元格记录 14;公式 0。只有样式的空格在结构JSON,不省略其原结构。
工作表 数据类型设计原则
sheetId 7;状态 visible;部件 xl/worksheets/sheet7.xml。DEMO/正式版保持原名称,各自独立呈现。
合并区域:B3:F3。样式、颜色、尺寸、隐藏行列、批注/绘图关系保留于结构。
| 坐标 | 内容/缓存 | 公式 | 类型/样式 |
|---|---|---|---|
| B3 | TA系统目前支持以下数据类型,系统内字段类型由首次导入时,该字段的类型决定,因此建议在埋点时重点确认字段相关类型 | s/130 | |
| B4 | TA数据类型 | s/42 | |
| C4 | 取值样例 | s/42 | |
| D4 | 取值说明 | s/42 | |
| E4 | JSON数据类型 | s/42 | |
| F4 | 建议场景 | s/45 | |
| B5 | 数值 | s/42 | |
| C5 | 123,1.23 | s/43 | |
| D5 | 数据范围是-9E15至9E15, ▲数值类数据精度为: 上报时,系统会截断并保留小数点后16位数字; 在模型分析结果展示时小数位数限制为 4位; 数值属性作为分组项时, 仅四舍五入显示小数点后6位 | s/43 | |
| E5 | Number | s/46 | |
| F5 | 1.属性具备数值型运算场景(总和、中位数、均值等),如充值金额、消耗钻石量、过关时间(秒)、等级..... 2.id相关属性,且id的先后关系和数值大小成正相关,如关卡id、服务器id等,如这类id非纯数值,则作为文本处理 3.接上,对于用户相关id,如角色id等,虽然可能由全数字组成,但本身无数值含义,且位数可能很大,建议作为文本处理 | s/23 | |
| B6 | 文本 | s/42 | |
| C6 | "ABC","上海" | s/43 | |
| D6 | 字符的默认上限是2KB | s/43 | |
| E6 | String | s/46 | |
| F6 | 不适用其它类型的属性,都可以考虑使用文本类型,包括一些目前TA不支持的复杂类型,如map类型等 | s/23 | |
| B7 | 时间 | s/42 | |
| C7 | "2019-01-01 00:00:00","2019-01-01 00:00:00.000" | s/43 | |
| D7 | "yyyy-MM-dd HH:mm:ss.SSS"或"yyyy-MM-dd HH:mm:ss",如需表示日期,可使用"yyyy-MM-dd 00:00:00" | s/43 | |
| E7 | String | s/46 | |
| F7 | 如注册时间、首次充值时间、月卡到期时间等 | s/23 | |
| B8 | 布尔 | s/42 | |
| C8 | true,false | s/43 | |
| D8 | - | s/43 | |
| E8 | Boolean | s/46 | |
| F8 | 如是否首次过关、是否付费用户等 | s/23 | |
| B9 | 列表 | s/42 | |
| C9 | ["a","1","true"] | s/43 | |
| D9 | 列表中的元素都会转变为文本类型 | s/43 | |
| E9 | Array | s/46 | |
| F9 | 如参战卡牌id["关羽"、"张飞"、"赵云“],用户标签["高付费用户"、"潜在流失用户"] | s/23 | |
| B10 | 对象 | s/44 | |
| C10 | {"item_name":"英雄碎片","item_num":5} | s/43 | |
| D10 | 须符合子属性的取值规则,如子属性为文本,子属性的取值需符合字符的默认上限是2KB | s/43 | |
| E10 | Object | s/21 | |
| F10 | / | s/24 | |
| B11 | 对象组 | s/44 | |
| C11 | [ {"item_name":"英雄碎片","item_num":5}, {"item_name":"皮肤碎片","item_num":2}, {"item_name":"荣耀积分","item_num":10} ] | s/43 | |
| D11 | 须符合子属性的取值规则,如子属性为文本,子属性的取值需符合字符的默认上限是2KB | s/43 | |
| E11 | Array(Object) | s/21 | |
| F11 | 例如一次战斗中多个角色出征,对象类型的属性可以包含不同类型的多个子属性,用于描述某个英雄的名称、星级、战力等;对象组类型可以将多个对象类型以数组的形式用一个字段表达,用以描述整个出征阵容。 | s/23 |
全部单元格记录 45;公式 0。只有样式的空格在结构JSON,不省略其原结构。
工作表 公共事件属性设置方式
sheetId 8;状态 visible;部件 xl/worksheets/sheet8.xml。DEMO/正式版保持原名称,各自独立呈现。
合并区域:B3:N3, B4:N39。样式、颜色、尺寸、隐藏行列、批注/绘图关系保留于结构。
全部单元格记录 596;公式 0。只有样式的空格在结构JSON,不省略其原结构。
工作表 多端接入注意点
sheetId 9;状态 visible;部件 xl/worksheets/sheet9.xml。DEMO/正式版保持原名称,各自独立呈现。
合并区域:无。样式、颜色、尺寸、隐藏行列、批注/绘图关系保留于结构。
| 坐标 | 内容/缓存 | 公式 | 类型/样式 |
|---|---|---|---|
| B3 | TA系统支持多端的数据接入,如客户端、服务端以及第三方数据,并且可以将多端数据接入同个项目中,以解决数据孤岛问题,但过程中有以下注意点,请在接入前予以关注 | s/29 | |
| B5 | 1、ID匹配: | s/31 | |
| B6 | 客户端数据里一定有访客ID上传,服务端上传的时候建议带上访客ID,确保两边的数据可以对应上(上报的时候带上ID,系统在ETL的时候会去映射) | s/32 | |
| B7 | 因为并不确定第一条【同时出现】【#account_id 和 #distinct_id】的数据是客户端还是服务端,所以最稳妥的处理方式就是:在能获取到两个ID的情况下,双端全部携带上报 | s/32 | |
| B9 | 2、海外多地区发行(存在时间先后问题) | s/31 | |
| B10 | 2.1 建议方案:按当地时间+时区上报 | s/32 | |
| B11 | 2.2 客户端sdk:默认使用本机时间+时区 作为事件发生时间上报;也可指定偏移到某一时区再上报数据,参考sdk文档配置; | s/32 | |
| B12 | 2.3 服务端sdk:需要自行设置时区字段; | s/32 | |
| B13 | (若服务器无法获取客户端当地时间,则按服务器时区上报) | s/32 | |
| B15 | 3、服务端上报注意 | s/31 | |
| B16 | 3.1 服务端上报数据时,#time字段需赋值=事件发生时间,#ip取客户端ip | s/32 | |
| B17 | // 设置用户的ip地址,TA系统会根据IP地址解析用户的地理位置信息,如果不设置的话,则默认不上报 | s/32 | |
| B18 | properties.put("#ip", "192.168.1.1"); | s/32 | |
| B19 | 3.2 正式环境下,建议使用服务端sdk+logbus的方式上报(LoggerConsumer方式),如果使用batch方式上报,在长时间网络中断情况下,存在数据丢失的风险。 | s/32 | |
| B21 | 4、服务端属性问题 | s/31 | |
| B22 | 4.1服务端获取不到预制属性的问题: | s/32 | |
| B23 | a.服务端上报的事件,不需要用到这部分预制属性进行分析的话,服务端可以选择不上报这些属性 | s/32 | |
| B24 | b.如果服务端上报的事件,需要用到部分公共属性(预制属性)进行分析,那就得从客户端进行通信获取到这些属性后再上报 | s/32 | |
| B25 | 4.2 数数不会对双端的公共事件属性进行自动补齐,因此前后端都需要留意携带必要的公共事件属性 | s/32 | |
| B27 | 5、客户端校准时间 | s/31 | |
| B28 | SDK 默认会使用本机时间作为事件发生时间上报,如果用户手动修改设备时间会影响到您的业务分析,自 v2.5.0 版本开始,您可以使用从服务端获取的当前时间戳对 SDK 的时间进行校准。此后,所有未指定时间的调用,包括事件数据和用户属性设置操作,都会使用校准后的时间作为发生时间。 | s/33 | |
| B29 | 时间校准 | s/34 |
全部单元格记录 28;公式 0。只有样式的空格在结构JSON,不省略其原结构。
工作表 多用户id体系的埋点建议
sheetId 10;状态 visible;部件 xl/worksheets/sheet10.xml。DEMO/正式版保持原名称,各自独立呈现。
合并区域:B9:I10。样式、颜色、尺寸、隐藏行列、批注/绘图关系保留于结构。
| 坐标 | 内容/缓存 | 公式 | 类型/样式 |
|---|---|---|---|
| B3 | 在游戏分析场景下,往往需要从多个角度分析用户,如角色、账号、设备或一些第三方id等,因此对于id的设计会直接影响到TA系统后续的使用过程 | s/3 | |
| B4 | 以下以一个基础场景,来解释在TA系统埋点时,如果设计用户id体系,如有更复杂的场景,可以随时找数数的服务人员沟通 | s/3 | |
| B6 | 假设目前项目存在如下id体系,如角色id、账号id、设备相关id(包括设备id或一些第三方基于设备的id,如adjust_id) | s/3 | |
| B7 | 在TA系统内,是以#account_id作为第一标准去识别单个用户的,即不同的#account_id一定对应不同的#user_id,#user_id即TA系统内的用户的识别依据 | s/3 | |
| B8 | 一般建议以最小的不可分割的业务id作为#account_id,上述场景下为角色id,以设备相关id作为#distinct_id,如设备id、数数客户端sdk生成的访客id,或自定义的访客id | s/3 | |
| B9 | 此外的其它id,都建议作为通用事件属性(如其和角色存在多对多的关系,如设备id)或用户属性进行记录,基于上述逻辑,建议埋点如下(下述访客id为数数客户端sdk的默认访客id,实际场景下可自定义设置 ) | s/171 | |
| B12 | #account_id | s/28 | |
| C12 | #distinct_id | s/28 | |
| D12 | 账号id(自定义属性) | s/28 | |
| E12 | 设备id(自定义属性) | s/28 | |
| F12 | 其它id(自定义属性) | s/28 | |
| B13 | 角色id | s/22 | |
| C13 | 访客id | s/22 | |
| D13 | 账号id | s/22 | |
| E13 | 设备id | s/22 | |
| F13 | 平台id、adjust_id等 | s/22 | |
| B15 | 当然在实际埋点中,可能存在部分id不存在的问题,如设备激活时是没有角色id的,此时留空即可,当然访客id不管任何情况,理论上一定会存在的 | s/3 | |
| B16 | 以下从实际的业务场景入手,来说明各个场景下的id设置 | s/3 | |
| B18 | 埋点场景 | s/28 | |
| C18 | #account_id | s/28 | |
| D18 | #distinct_id | s/28 | |
| E18 | 账号id(自定义属性) | s/28 | |
| F18 | 设备id(自定义属性) | s/28 | |
| B19 | 设备激活 | s/22 | |
| C19 | - | s/22 | |
| D19 | 访客id1 | s/22 | |
| E19 | - | s/22 | |
| F19 | 设备id1 | s/22 | |
| B20 | sdk初始化 | s/22 | |
| C20 | - | s/22 | |
| D20 | 访客id1 | s/22 | |
| E20 | - | s/22 | |
| F20 | 设备id1 | s/22 | |
| B21 | 注册账号 | s/22 | |
| C21 | - | s/22 | |
| D21 | 访客id1 | s/22 | |
| E21 | 账号id1 | s/22 | |
| F21 | 设备id1 | s/22 | |
| B22 | 创角角色 | s/22 | |
| C22 | 角色id1 | s/22 | |
| D22 | 访客id1 | s/22 | |
| E22 | 账号id1 | s/22 | |
| F22 | 设备id1 | s/22 | |
| B23 | 开始战斗 | s/22 | |
| C23 | 角色id1 | s/22 | |
| D23 | 访客id1 | s/22 | |
| E23 | 账号id1 | s/22 | |
| F23 | 设备id1 | s/22 | |
| B25 | 因此,总体来说,遵循有则填充,无则留空的逻辑,基于上述埋点,可以将用户登陆前后的数据进行关联,并且后续TA系统也会提供对应的功能 | s/3 | |
| B26 | 从各个角度针对用户进行分析,如设备留存、账号漏斗转化等 | s/3 |
全部单元格记录 192;公式 0。只有样式的空格在结构JSON,不省略其原结构。
工作表 ID体系常见疑问
sheetId 11;状态 visible;部件 xl/worksheets/sheet11.xml。DEMO/正式版保持原名称,各自独立呈现。
合并区域:D14:G14, B2:B3, B10:B11, C62:G66, C33:G37, D4:G4, D5:G5, D6:G6, D12:G12, D13:G13。样式、颜色、尺寸、隐藏行列、批注/绘图关系保留于结构。
| 坐标 | 内容/缓存 | 公式 | 类型/样式 |
|---|---|---|---|
| B1 | 游戏类型 | s/4 | |
| B2 | 单账号多角色 | s/190 | |
| B4 | 属性显示名 | s/6 | |
| C4 | 属性名 | s/6 | |
| D4 | 赋值说明 | s/202 | |
| B5 | 账户id | s/7 | |
| C5 | #account_id | s/7 | |
| D5 | 设置为角色id,角色所属账户ID设置为角色的自定义属性(整个项目唯一,不能重复) | s/189 | |
| B6 | 访客id | s/7 | |
| C6 | #distinct_id | s/7 | |
| D6 | 设备相关id或业务内的访客id,如使用客户端sdk,则可以选择自动生成访客ID | s/189 | |
| B9 | 游戏类型 | s/4 | |
| B10 | 单账号单角色 | s/190 | |
| B12 | 属性显示名 | s/6 | |
| C12 | 属性名 | s/6 | |
| D12 | 赋值说明 | s/202 | |
| B13 | 账户id | s/7 | |
| C13 | #account_id | s/7 | |
| D13 | 设置为玩家账号ID即可 | s/189 | |
| B14 | 访客id | s/7 | |
| C14 | #distinct_id | s/7 | |
| D14 | 设备相关id或业务内的访客id,如使用客户端sdk,则可以选择自动生成访客ID | s/189 | |
| B17 | 单账号多角色ID绑定解释 | s/9 | |
| B18 | 事件表数据: | s/11 | |
| C18 | 序号 | s/12 | |
| D18 | 埋点场景(事件数据) | s/12 | |
| E18 | #user_id(数数生成) | s/17 | |
| F18 | #account_id | s/18 | |
| G18 | #distinct_id | s/18 | |
| H18 | 账号id(自定义属性) | s/12 | |
| I18 | 设备id(自定义属性) | s/12 | |
| C19 | 1 | n/13 | |
| D19 | 设备激活 | s/14 | |
| E19 | A | s/13 | |
| F19 | - | s/13 | |
| G19 | 访客id1 | s/13 | |
| H19 | - | s/13 | |
| I19 | 设备id1 | s/13 | |
| C20 | 2 | n/13 | |
| D20 | 注册账号 | s/14 | |
| E20 | A | s/13 | |
| F20 | - | s/13 | |
| G20 | 访客id1 | s/13 | |
| H20 | 账号id1 | s/13 | |
| I20 | 设备id1 | s/13 | |
| C21 | 3 | n/13 | |
| D21 | 创角角色(完成绑定) | s/14 | |
| E21 | A | s/13 | |
| F21 | 角色id1 | s/13 | |
| G21 | 访客id1 | s/13 | |
| H21 | 账号id1 | s/13 | |
| I21 | 设备id1 | s/13 | |
| C22 | 4 | n/13 | |
| D22 | 开始战斗 | s/14 | |
| E22 | A | s/13 | |
| F22 | 角色id1 | s/13 | |
| G22 | 访客id1 | s/13 | |
| H22 | 账号id1 | s/13 | |
| I22 | 设备id1 | s/13 | |
| C23 | 5 | n/13 | |
| D23 | 创建新角色(依旧携带访客ID) | s/14 | |
| E23 | B | s/13 | |
| F23 | 角色id2 | s/13 | |
| G23 | 访客id1 | s/13 | |
| H23 | 账号id1 | s/13 | |
| I23 | 设备id1 | s/13 | |
| C25 | 第5步创建新角色,事件数据中,角色id2和访客id1会一起上报; | s/3 | |
| C26 | 但是由于访客id1已经和角色id1已经完成了绑定,此时在绑定关系(用户表中),实际数据为 | s/3 | |
| B28 | 用户表数据: | s/15 | |
| E28 | #user_id(数数生成) | s/17 | |
| F28 | #account_id | s/18 | |
| G28 | #distinct_id | s/18 | |
| H28 | 账号id(自定义属性) | s/12 | |
| E29 | A | s/13 | |
| F29 | 角色id1 | s/13 | |
| G29 | 访客id1 | s/13 | |
| H29 | 账号id1 | s/13 | |
| E30 | B | s/13 | |
| F30 | 角色id2 | s/13 | |
| G30 | (空) | s/13 | |
| H30 | 账号id1 | s/13 | |
| B33 | 疑问解答: | s/15 | |
| C33 | 1、在数数后台的统计中,这种情况下【用户数=2】,但是访客ID在埋点事件上报的时候都有记录,所以都是可以溯源的,只是在绑定记录中,新的角色没有和访客ID绑定上。 2、关于账号和角色的记录: 在公共事件属性中携带,可以看到二者的关联关系。比如以上的数据,统计【账号数=1】 | s/193 | |
| B40 | 注意事项: | s/15 | |
| C40 | 1、单账号的账号ID,一定要作为【公共属性/用户属性】记录在玩家数据中,不然后续无法拆分账号数据 | s/3 | |
| C41 | 2、设备ID/区服ID/渠道等通用信息,也要记录在【公共属性/用户属性】中,不然后续分析会缺少维度 | s/3 | |
| B44 | 访客ID卸载重装情况解释 | s/9 | |
| B45 | 事件表数据: | s/11 | |
| C45 | 序号 | s/12 | |
| D45 | 埋点场景(事件数据) | s/12 | |
| E45 | #user_id(数数生成) | s/17 | |
| F45 | #account_id | s/18 | |
| G45 | #distinct_id | s/18 | |
| C46 | 1 | n/21 | |
| D46 | 设备激活 | s/22 | |
| E46 | A | s/21 | |
| F46 | - | s/21 | |
| G46 | 访客id1 | s/21 | |
| C47 | 2 | n/21 | |
| D47 | 注册账号(完成绑定) | s/22 | |
| E47 | A | s/21 | |
| F47 | 账号id1 | s/21 | |
| G47 | 访客id1 | s/21 | |
| C48 | 3 | n/21 | |
| D48 | 开始战斗 | s/22 | |
| E48 | A | s/21 | |
| F48 | 账号id1 | s/21 | |
| G48 | 访客id1 | s/21 | |
| C49 | 4 | n/21 | |
| D49 | 卸载重装 | s/22 | |
| E49 | B | s/21 | |
| F49 | - | s/21 | |
| G49 | 访客id2 | s/21 | |
| C50 | 5 | n/21 | |
| D50 | 账号登录 | s/22 | |
| E50 | A | s/21 | |
| F50 | 账号id1 | s/21 | |
| G50 | 访客id2 | s/21 | |
| C51 | 6 | n/21 | |
| D51 | 开始战斗 | s/22 | |
| E51 | A | s/21 | |
| F51 | 账号id1 | s/21 | |
| G51 | 访客id2 | s/21 | |
| C53 | 第5步账号登录,事件数据中,账号id1和访客id2会一起上报; | s/3 | |
| C54 | 但是由于账号id1已经和访客id1完成了绑定,已经生成了user-A,还是会记录在user-A上; | s/3 | |
| C55 | 此时在绑定关系(用户表中),实际数据为: | s/3 | |
| B57 | 用户表数据: | s/15 | |
| E57 | #user_id(数数生成) | s/25 | |
| F57 | #account_id | s/25 | |
| G57 | #distinct_id | s/25 | |
| E58 | A | s/13 | |
| F58 | 账号id1 | s/13 | |
| G58 | 访客id1 | s/13 | |
| E59 | B | s/13 | |
| F59 | (空) | s/13 | |
| G59 | 访客id2 | s/13 | |
| B62 | 疑问解答: | s/15 | |
| C62 | 比如在数数后台的统计中,实际分析玩法时,访客ID发生变化,但是登录后的数据还是记录在账号id1所对应的用户user-A身上,所以并不影响正常的游戏行为分析,只是【卸载重装后,重新登录前】的数据,会记录在user-B上 同时,比如看事件数据中,账号ID维度对应的访客ID去重数,可以判断是否有卸载重装行为 | s/173 | |
| B68 | 一句话总结,事件行为会优先归因到#account_id所在用户身上 | s/26 |
全部单元格记录 413;公式 0。只有样式的空格在结构JSON,不省略其原结构。
图片 xl/media/image1.png

SHA-256 1673bc0bd5fa433d85415609a67b0910f0c804b460ef967f085f7376abb52229。绘图锚点、对象关系与颜色样式在结构中保留,不重建画布。