Usuários, sessões e instalações
Os três ids que ligam os eventos a uma pessoa, a uma visita e a um dispositivo.
| Id | Quem define | O que significa |
|---|---|---|
user_id | O seu app (setUser) | O seu próprio id para a pessoa: um id de conta, um id de jogador. Até 128 bytes. |
session_id | O SDK | Uma visita. Num dispositivo, uma nova sessão começa depois de 30 minutos sem nenhum evento; num servidor, veja abaixo. |
install_id | O SDK | Uma instalação do app: um UUID aleatório guardado no dispositivo. |
Usuários
Chame setUser assim que souber quem é a pessoa, e todos os eventos seguintes levam esse id.
Passe nil / null / None / "" para limpá-lo (ao sair da conta). O Lyrelog nunca inventa um
id de usuário: os eventos registrados antes de setUser não têm nenhum.
Cada projeto escolhe a palavra que usa para as suas pessoas (usuários, jogadores, clientes...) em Settings. O painel a usa em todo lugar: a página Players de um jogo é a página Customers de uma loja.
Sessões
Como cada SDK cria as sessões:
| SDK | Sessão |
|---|---|
| Swift | Uma nova depois de 30 minutos sem eventos (sessionTimeout) |
| Android | Uma nova depois de 30 minutos sem eventos (sessionTimeoutMillis) |
| React Native, Flutter | A do SDK nativo: uma nova depois de 30 minutos sem eventos (sessionTimeoutMs, sessionTimeout) |
| JavaScript, navegador | Uma por aba, guardada em sessionStorage com a hora da última atividade, então recarregar a página a continua; uma nova depois de 30 minutos sem atividade |
| JavaScript, Node | Uma por processo, enquanto ele rodar |
| Python | Uma por processo, e uma nova depois de 30 minutos sem eventos (session_timeout) |
| Go | Uma por processo, enquanto ele rodar |
| JVM | Uma por processo, enquanto ele rodar |
Num servidor, uma sessão diz pouco sobre uma pessoa: agrupe por user_id.
Relatórios que chegam depois, como um crash reportado na abertura seguinte, mantêm a hora em que aconteceram. Os do Swift não têm sessão; um crash no Android mantém a sessão que ele encerrou.
Instalações
O id de instalação sobrevive a aberturas e atualizações do app, mas não a uma reinstalação. Não é
um identificador de publicidade e não está ligado a mais nada no dispositivo. No Android ele fica
em noBackupFilesDir, então nunca entra num backup restaurado em outro dispositivo. Na web ele
fica em localStorage. Nos servidores (Node, Python, Go, a JVM) é um id novo a cada processo.
Apps React Native e Flutter mantêm o do SDK nativo.
O id de usuário não é guardado: chame setUser de novo a cada abertura do app, assim que souber
quem é a pessoa.