Accès anticipéSur invitation, et les SDK ne sont pas encore publiés.Demander une invitation
Aller au contenu
Docs

Utilisateurs, sessions et installations

Les trois identifiants qui relient les événements à une personne, une visite et un appareil.

IdentifiantQui le définitCe qu'il signifie
user_idVotre app (setUser)Votre propre identifiant pour la personne : un identifiant de compte ou de joueur. Jusqu'à 128 octets.
session_idLe SDKUne visite. Sur un appareil, une nouvelle session commence après 30 minutes sans aucun événement ; sur un serveur, voir plus bas.
install_idLe SDKUne installation de l'app : un UUID aléatoire conservé sur l'appareil.

Utilisateurs

Appelez setUser dès que vous savez qui est la personne, et tous les événements suivants portent cet identifiant. Passez nil / null / None / "" pour l'effacer (à la déconnexion). Lyrelog n'invente jamais d'identifiant utilisateur : les événements loggés avant setUser n'en ont pas.

Chaque projet choisit le mot qu'il utilise pour ses personnes (utilisateurs, joueurs, clients...) dans Settings. Le tableau de bord l'emploie partout : la page Players d'un jeu est la page Customers d'une boutique.

Sessions

Comment chaque SDK crée les sessions :

SDKSession
SwiftUne nouvelle après 30 minutes sans événement (sessionTimeout)
AndroidUne nouvelle après 30 minutes sans événement (sessionTimeoutMillis)
React Native, FlutterCelle du SDK natif : une nouvelle après 30 minutes sans événement (sessionTimeoutMs, sessionTimeout)
JavaScript, navigateurUne par onglet, conservée dans sessionStorage avec l'heure de la dernière activité, pour qu'un rechargement la poursuive ; une nouvelle après 30 minutes d'inactivité
JavaScript, NodeUne par processus, tant qu'il tourne
PythonUne par processus, et une nouvelle après 30 minutes sans événement (session_timeout)
GoUne par processus, tant qu'il tourne
JVMUne par processus, tant qu'il tourne

Sur un serveur, une session en dit peu sur une personne : regroupez plutôt par user_id.

Les rapports qui arrivent plus tard, comme un plantage signalé au lancement suivant, gardent l'heure où ils se sont produits. Ceux de Swift n'ont pas de session ; un plantage Android garde la session qu'il a interrompue.

Installations

L'identifiant d'installation survit aux lancements et aux mises à jour, mais pas à une réinstallation. Ce n'est pas un identifiant publicitaire et il n'est lié à rien d'autre sur l'appareil. Sur Android, il vit dans noBackupFilesDir, il ne figure donc jamais dans une sauvegarde restaurée sur un autre appareil. Sur le web, il vit dans localStorage. Sur les serveurs (Node, Python, Go, la JVM), c'est un nouvel identifiant pour chaque processus. Les apps React Native et Flutter gardent celui du SDK natif.

L'identifiant utilisateur n'est pas conservé : appelez setUser à nouveau à chaque lancement dès que vous savez qui est la personne.