ユーザー、セッション、インストール
イベントをユーザー、訪問、デバイスに結び付ける 3 つの ID。
| ID | 設定するもの | 意味 |
|---|---|---|
user_id | アプリ(setUser) | ユーザーに付けるアプリ独自の ID。アカウント ID、プレイヤー ID など。最大 128 バイト。 |
session_id | SDK | 1 回の訪問。デバイスでは、イベントが 30 分間ないと新しいセッションが始まります。サーバーについては下記を参照してください。 |
install_id | SDK | アプリの 1 回のインストール。デバイスに保存されるランダムな UUID です。 |
ユーザー
ユーザーが誰かわかった時点で setUser を呼ぶと、以降のすべてのイベントにその ID が付きます。クリアするには(サインアウト時など)nil / null / None / "" を渡します。Lyrelog がユーザー ID を勝手に作ることはありません。setUser より前に記録されたイベントには ID がありません。
各プロジェクトは、ユーザーを呼ぶ言葉(users、players、customers など)を Settings で選べます。ダッシュボードはそれをどこでも使います。ゲームの Players ページは、ショップなら Customers ページになります。
セッション
各 SDK のセッションの作り方は次のとおりです。
| SDK | セッション |
|---|---|
| Swift | イベントが 30 分間ないと新しいセッション(sessionTimeout) |
| Android | イベントが 30 分間ないと新しいセッション(sessionTimeoutMillis) |
| React Native、Flutter | ネイティブ SDK に従い、イベントが 30 分間ないと新しいセッション(sessionTimeoutMs、sessionTimeout) |
| JavaScript(ブラウザー) | タブごとに 1 つ。最後の操作の時刻とともに sessionStorage に保存されるので、リロードしても続きます。30 分間操作がないと新しいセッション |
| JavaScript(Node) | プロセスごとに 1 つ。プロセスが動いている間ずっと続きます |
| Python | プロセスごとに 1 つ。イベントが 30 分間ないと新しいセッション(session_timeout) |
| Go | プロセスごとに 1 つ。プロセスが動いている間ずっと続きます |
| JVM | プロセスごとに 1 つ。プロセスが動いている間ずっと続きます |
サーバーでは、セッションからユーザーについてわかることはほとんどありません。代わりに user_id でグループ化してください。
次回起動時に報告されるクラッシュのように後から届くレポートは、それが起きた時刻を保持します。Swift ではセッションが付きません。Android のクラッシュには、そのクラッシュで終了したセッションが付きます。
インストール
インストール ID は起動やアップデートをまたいで残りますが、再インストールすると変わります。広告識別子ではなく、デバイス上のほかの何とも結び付いていません。Android では noBackupFilesDir に保存されるので、別のデバイスに復元されるバックアップに含まれることはありません。Web では localStorage に保存されます。サーバー(Node、Python、Go、JVM)ではプロセスごとに新しい ID になります。React Native と Flutter のアプリは、ネイティブ SDK の ID を使います。
ユーザー ID は保存されません。起動のたびに、ユーザーが誰かわかった時点で再び setUser を呼んでください。