Utilisateurs, sessions et installations
Les trois identifiants qui relient les événements à une personne, une visite et un appareil.
| Identifiant | Qui le définit | Ce qu'il signifie |
|---|---|---|
user_id | Votre app (setUser) | Votre propre identifiant pour la personne : un identifiant de compte ou de joueur. Jusqu'à 128 octets. |
session_id | Le SDK | Une visite. Sur un appareil, une nouvelle session commence après 30 minutes sans aucun événement ; sur un serveur, voir plus bas. |
install_id | Le SDK | Une 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 :
| SDK | Session |
|---|---|
| Swift | Une nouvelle après 30 minutes sans événement (sessionTimeout) |
| Android | Une nouvelle après 30 minutes sans événement (sessionTimeoutMillis) |
| React Native, Flutter | Celle du SDK natif : une nouvelle après 30 minutes sans événement (sessionTimeoutMs, sessionTimeout) |
| JavaScript, navigateur | Une 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, Node | Une par processus, tant qu'il tourne |
| Python | Une par processus, et une nouvelle après 30 minutes sans événement (session_timeout) |
| Go | Une par processus, tant qu'il tourne |
| JVM | Une 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.