Acesso antecipadoSó por convite, e os SDKs ainda não foram publicados.Pedir um convite
Ir para o conteúdo
Docs

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.

IdQuem defineO que significa
user_idO seu app (setUser)O seu próprio id para a pessoa: um id de conta, um id de jogador. Até 128 bytes.
session_idO SDKUma visita. Num dispositivo, uma nova sessão começa depois de 30 minutos sem nenhum evento; num servidor, veja abaixo.
install_idO SDKUma 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:

SDKSessão
SwiftUma nova depois de 30 minutos sem eventos (sessionTimeout)
AndroidUma nova depois de 30 minutos sem eventos (sessionTimeoutMillis)
React Native, FlutterA do SDK nativo: uma nova depois de 30 minutos sem eventos (sessionTimeoutMs, sessionTimeout)
JavaScript, navegadorUma 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, NodeUma por processo, enquanto ele rodar
PythonUma por processo, e uma nova depois de 30 minutos sem eventos (session_timeout)
GoUma por processo, enquanto ele rodar
JVMUma 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.