setUserId

통사론

newrelic.setUserId(value: string|null)

페이지의 후속 이벤트에 사용자 정의 식별자 문자열을 추가합니다.

요구 사항

• 브라우저 Lite, Pro 또는 Pro+SPA 에이전트(v1.230.0 이상)

• npm을 사용하여 브라우저 에이전트를 설치하는 경우 BrowserAgent 클래스를 인스턴스화할 때 하나 이상의 기능을 활성화해야 합니다. 예를 들어, features 배열에 다음을 추가합니다.

  import { Metrics } from '@newrelic/browser-agent/features/metrics'
  
  const options = {
    info: { ... },
    loader_config: { ... },
    init: { ... },
    features: [
      Metrics
    ]
  }

  카피

  자세한 내용은 npm 브라우저 설치 설명서를 참조하세요.

설명

유효한 값으로 이 함수를 실행하면 브라우저 에이전트는 속성이 수동으로 설정 해제될 때까지 모든 이벤트와 함께 값을 enduser.id 속성으로 기록합니다. 식별자는 브라우저에 저장되므로 동일한 출처의 후속 페이지 방문 시 이벤트 within a session 범위에 식별자가 연결됩니다. 이 기능은 최종 사용자 브라우저 개인 정보 보호 설정에 따라 달라질 수 있습니다. 이 함수가 value = null 와 함께 호출되면 기존 사용자 ID가 both 현재 페이지의 이벤트 및 저장소에서 삭제됩니다.

ID는 특히 오류 받은 편지함 사용을 위해 JavaScriptError 이벤트에 첨부됩니다. 호환되는 에이전트 버전으로 SPA 모니터링을 사용하는 경우 사용자 ID도 newrelic.interaction 이벤트에 포함됩니다.

에이전트 버전 1.307.0부터, resetSession 속성이 true 로 설정된 경우 사용자 식별자가 업데이트될 때 브라우저 에이전트 세션이 재설정됩니다. 그러나 enduser.id 속성이 아직 지정되지 않은 경우 세션은 재설정되지 않습니다.

매개변수

예시 - 기기/장치당 사용자 한 명

사용자 세션 시작 표시

newrelic.setUserId('user-1234')

현재 사용자에 대한 속성 이벤트 중지

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

예시 - 기기/장치당 여러 사용자

사용자 세션 시작 표시

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

다른 사용자 세션으로 전환

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

사용자 세션 종료

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