Early AccessNur auf Einladung, und die SDKs sind noch nicht veröffentlicht.Einladung anfragen
Zum Inhalt springen
Docs

Nutzer, Sessions und Installationen

Die drei IDs, die Events mit einer Person, einem Besuch und einem Gerät verknüpfen.

IDWer sie setztWas sie bedeutet
user_idDeine App (setUser)Deine eigene ID für die Person: eine Konto-ID, eine Spieler-ID. Bis zu 128 Bytes.
session_idDas SDKEin Besuch. Auf einem Gerät beginnt eine neue Session nach 30 Minuten ohne Event; auf einem Server siehe unten.
install_idDas SDKEine 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:

SDKSession
SwiftEine neue nach 30 Minuten ohne Event (sessionTimeout)
AndroidEine neue nach 30 Minuten ohne Event (sessionTimeoutMillis)
React Native, FlutterDie des nativen SDKs: eine neue nach 30 Minuten ohne Event (sessionTimeoutMs, sessionTimeout)
JavaScript, BrowserEine 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, NodeEine pro Prozess, solange er läuft
PythonEine pro Prozess und eine neue nach 30 Minuten ohne Event (session_timeout)
GoEine pro Prozess, solange er läuft
JVMEine 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.