définirUserId

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
    ]
  }

  Copier

  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 .

À partir de la version 1.307.0 de l'agent, si l'attribut resetSession est défini sur true, lorsque l'identifiant utilisateur est mis à jour, la session de l'agent de navigateur est réinitialisée. Cependant, la session ne se réinitialise pas si l'attribut enduser.id n'est pas encore spécifié.

Paramètres

Exemples - un utilisateur par machine/appareil

Marquer le début d'une session utilisateur

newrelic.setUserId('user-1234')

Arrêter d'attribuer des événements à l'utilisateur actuel

// Note: events are still attributed to the same session id
newrelic.setUserId(null)

Exemples - plusieurs utilisateurs par machine/appareil

Marquer le début d'une session utilisateur

// Note: associates the specified userid to the current session id
newrelic.setUserId('user-1234', true)

Passer à une autre session utilisateur

// Note: resets the session, events will be attributed to a new user + session id
newrelic.setUserId('user-567', true)

Terminer une session utilisateur

// Note: resets the session, effectively ending it.  Events will be attributed to a new session id going forward.
newrelic.setUserId(null, true)