Nutzer, Sessions und Installationen
Die drei IDs, die Events mit einer Person, einem Besuch und einem Gerät verknüpfen.
| ID | Wer sie setzt | Was sie bedeutet |
|---|---|---|
user_id | Deine App (setUser) | Deine eigene ID für die Person: eine Konto-ID, eine Spieler-ID. Bis zu 128 Bytes. |
session_id | Das SDK | Ein Besuch. Auf einem Gerät beginnt eine neue Session nach 30 Minuten ohne Event; auf einem Server siehe unten. |
install_id | Das SDK | Eine Installation der App: eine zufällige UUID, die auf dem Gerät gespeichert wird. |
Nutzer
Ruf setUser auf, sobald du weißt, wer die Person ist, und jedes folgende Event trägt diese ID.
Übergib nil / null / None / "", um sie zu löschen (beim Abmelden). Lyrelog denkt sich nie
eine Nutzer-ID aus: Events, die vor setUser geloggt wurden, haben keine.
Jedes Projekt wählt in den Settings das Wort für seine Personen (Nutzer, Spieler, Kunden...). Das Dashboard verwendet es überall: Die Seite Players eines Spiels ist die Seite Customers eines Shops.
Sessions
Wie jedes SDK Sessions bildet:
| SDK | Session |
|---|---|
| Swift | Eine neue nach 30 Minuten ohne Event (sessionTimeout) |
| Android | Eine neue nach 30 Minuten ohne Event (sessionTimeoutMillis) |
| React Native, Flutter | Die des nativen SDKs: eine neue nach 30 Minuten ohne Event (sessionTimeoutMs, sessionTimeout) |
| JavaScript, Browser | Eine pro Tab, in sessionStorage mit der Zeit der letzten Aktivität gespeichert, sodass ein Neuladen sie fortsetzt; eine neue nach 30 Minuten Inaktivität |
| JavaScript, Node | Eine pro Prozess, solange er läuft |
| Python | Eine pro Prozess und eine neue nach 30 Minuten ohne Event (session_timeout) |
| Go | Eine pro Prozess, solange er läuft |
| JVM | Eine pro Prozess, solange er läuft |
Auf einem Server sagt eine Session wenig über eine Person aus: Gruppiere stattdessen nach
user_id.
Berichte, die später ankommen, etwa ein Absturz, der beim nächsten Start gemeldet wird, behalten die Zeit, zu der sie passiert sind. Die von Swift haben keine Session; ein Android-Absturz behält die Session, die er beendet hat.
Installationen
Die Installations-ID übersteht Starts und Updates, aber keine Neuinstallation. Sie ist keine
Werbe-ID und mit nichts anderem auf dem Gerät verknüpft. Auf Android liegt sie in
noBackupFilesDir und ist daher nie in einem Backup, das auf einem anderen Gerät wiederhergestellt
wird. Im Web liegt sie in localStorage. Auf Servern (Node, Python, Go, die JVM) ist sie für jeden
Prozess eine neue ID. React-Native- und Flutter-Apps behalten die des nativen SDKs.
Die Nutzer-ID wird nicht gespeichert: Ruf setUser bei jedem Start erneut auf, sobald du weißt,
wer die Person ist.