Syntaxe
newrelic.setUserId(value: string|null)
Ajoute une chaîne d'identifiant définie par l'utilisateur à l'événement ultérieur sur la page.
Exigences
Agent navigateur Lite, Pro ou Pro+SPA (v1.230.0 ou supérieur)
Si vous utilisez npm pour installer l'agent du navigateur, vous devez activer au moins une fonctionnalité lors de l'instanciation de la classe
BrowserAgent
. Par exemple, ajoutez ce qui suit dans l’éventailfeatures
:import { Metrics } from '@newrelic/browser-agent/features/metrics'const options = {info: { ... },loader_config: { ... },init: { ... },features: [Metrics]}Pour plus d'informations, consultez la documentation d'installation du navigateur npm.
Description
Lors de l'exécution de cette fonction avec une valeur valide, l'agent du navigateur enregistre la valeur comme attribut enduser.id
avec tous les événements jusqu'à ce que l'attribut soit désactivé manuellement. L'identifiant sera stocké dans le navigateur, afin que les visites ultérieures de pages de la même origine l'attachent à l'événement within a session span. Notez que cette fonctionnalité peut fluctuer en fonction des paramètres de confidentialité du navigateur de l'utilisateur final. Si cette fonction est appelée avec un value = null
, tout ID utilisateur existant sera supprimé de both l'événement de la page courante et du stockage.
L'ID sera attaché à l'événement JavaScriptError notamment pour l'utilisation Errors Inbox . Si vous utilisez monitoringSPA avec une version d'agent compatible, l'ID utilisateur sera également inclus dans l'événement newrelic.interaction
.
Paramètres
paramètres | Description |
---|---|
chaîne OU null | Requis. Une chaîne d'identifiant pour l'utilisateur final, utile pour lier tous les événements du navigateur à un utilisateur spécifique. Le paramètre La transmission d’une valeur |
Exemples
Marquer le « début de session » d'un utilisateur final
newrelic.setUserId('user-1234-v1.0')
Arrêt de l'événement de l'attribut à l'utilisateur actuel
newrelic.setUserId(null)