Usuarios, sesiones e instalaciones
Los tres ids que unen los eventos a una persona, una visita y un dispositivo.
| Id | Quién lo fija | Qué significa |
|---|---|---|
user_id | Tu app (setUser) | Tu propio id para la persona: un id de cuenta, un id de jugador. Hasta 128 bytes. |
session_id | El SDK | Una visita. En un dispositivo, empieza una sesión nueva tras 30 minutos sin ningún evento; en un servidor, mira más abajo. |
install_id | El SDK | Una instalación de la app: un UUID aleatorio que se guarda en el dispositivo. |
Usuarios
Llama a setUser en cuanto sepas quién es la persona, y todos los eventos siguientes llevarán
ese id. Pasa nil / null / None / "" para borrarlo (al cerrar sesión). Lyrelog nunca se
inventa un id de usuario: los eventos registrados antes de setUser no tienen ninguno.
Cada proyecto elige la palabra que usa para sus personas (usuarios, jugadores, clientes...) en Settings. El panel la usa en todas partes: la página Players de un juego es la página Customers de una tienda.
Sesiones
Cómo crea las sesiones cada SDK:
| SDK | Sesión |
|---|---|
| Swift | Una nueva tras 30 minutos sin eventos (sessionTimeout) |
| Android | Una nueva tras 30 minutos sin eventos (sessionTimeoutMillis) |
| React Native, Flutter | La del SDK nativo: una nueva tras 30 minutos sin eventos (sessionTimeoutMs, sessionTimeout) |
| JavaScript, navegador | Una por pestaña, guardada en sessionStorage con la hora de la última actividad, así que una recarga la continúa; una nueva tras 30 minutos de inactividad |
| JavaScript, Node | Una por proceso, mientras se ejecute |
| Python | Una por proceso, y una nueva tras 30 minutos sin eventos (session_timeout) |
| Go | Una por proceso, mientras se ejecute |
| JVM | Una por proceso, mientras se ejecute |
En un servidor, una sesión dice poco sobre una persona: agrupa por user_id.
Los informes que llegan más tarde, como un crash que se notifica en el siguiente arranque, conservan la hora en que ocurrieron. Los de Swift no tienen sesión; un crash de Android conserva la sesión que terminó.
Instalaciones
El id de instalación sobrevive a los arranques y a las actualizaciones, pero no a una
reinstalación. No es un identificador publicitario y no está vinculado a nada más del
dispositivo. En Android vive en noBackupFilesDir, así que nunca está en una copia de seguridad
restaurada en otro dispositivo. En la web vive en localStorage. En los servidores (Node,
Python, Go, la JVM) es un id nuevo para cada proceso. Las apps de React Native y Flutter conservan
el del SDK nativo.
El id de usuario no se guarda: vuelve a llamar a setUser en cada arranque en cuanto sepas quién
es la persona.