抢先体验仅限邀请,SDK 尚未发布。申请邀请
跳到正文
文档

用户、会话和安装

把事件与一个用户、一次访问和一台设备关联起来的三个 id。

Id由谁设置含义
user_id你的应用(setUser)你自己给用户的 id:账户 id、玩家 id。最长 128 字节。
session_idSDK一次访问。在设备上,30 分钟没有任何事件后会开始新会话;服务器上的情况见下文。
install_idSDK应用的一次安装:保存在设备上的随机 UUID。

用户

一旦知道用户是谁,就调用 setUser,之后的每个事件都会带上这个 id。传入 nil / null / None / "" 可以清除它(在退出登录时)。Lyrelog 从不编造用户 id:在 setUser 之前记录的事件没有用户 id。

每个项目都可以在 Settings 中选择怎么称呼自己的用户(users、players、customers……)。 控制台处处使用这个词:游戏的 Players 页面,到了商店就是 Customers 页面。

会话

各 SDK 如何划分会话:

SDK会话
Swift30 分钟没有事件后开始新会话(sessionTimeout)
Android30 分钟没有事件后开始新会话(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。

本页目录