用户、会话和安装
把事件与一个用户、一次访问和一台设备关联起来的三个 id。
| Id | 由谁设置 | 含义 |
|---|---|---|
user_id | 你的应用(setUser) | 你自己给用户的 id:账户 id、玩家 id。最长 128 字节。 |
session_id | SDK | 一次访问。在设备上,30 分钟没有任何事件后会开始新会话;服务器上的情况见下文。 |
install_id | SDK | 应用的一次安装:保存在设备上的随机 UUID。 |
用户
一旦知道用户是谁,就调用 setUser,之后的每个事件都会带上这个 id。传入 nil / null / None / ""
可以清除它(在退出登录时)。Lyrelog 从不编造用户 id:在 setUser 之前记录的事件没有用户 id。
每个项目都可以在 Settings 中选择怎么称呼自己的用户(users、players、customers……)。 控制台处处使用这个词:游戏的 Players 页面,到了商店就是 Customers 页面。
会话
各 SDK 如何划分会话:
| SDK | 会话 |
|---|---|
| Swift | 30 分钟没有事件后开始新会话(sessionTimeout) |
| Android | 30 分钟没有事件后开始新会话(sessionTimeoutMillis) |
| React Native、Flutter | 沿用原生 SDK:30 分钟没有事件后开始新会话(sessionTimeoutMs、sessionTimeout) |
| JavaScript,浏览器 | 每个标签页一个,连同最后一次活动的时间保存在 sessionStorage 中,所以刷新页面会延续同一会话;空闲 30 分钟后开始新会话 |
| JavaScript,Node | 每个进程一个,持续到进程结束 |
| Python | 每个进程一个,30 分钟没有事件后开始新会话(session_timeout) |
| Go | 每个进程一个,持续到进程结束 |
| JVM | 每个进程一个,持续到进程结束 |
在服务器上,会话很难说明某个用户的情况:请改按 user_id 分组。
稍后才到达的报告,比如在下次启动时才上报的崩溃,会保留它实际发生的时间。Swift 的这类报告没有会话;Android 的崩溃保留它所终止的那个会话。
安装
安装 id 在多次启动和更新之间保持不变,但重新安装后会改变。它不是广告标识符,也不与设备上的任何其他信息关联。
在 Android 上,它保存在 noBackupFilesDir 中,所以永远不会出现在恢复到另一台设备的备份里。在 Web 上,它保存在
localStorage 中。在服务器上(Node、Python、Go、JVM),每个进程都是一个新的 id。React Native 和 Flutter 应用沿用原生 SDK 的安装 id。
用户 id 不会被保存:每次启动后,一旦知道用户是谁,请再次调用 setUser。