setUserId

통사론

newrelic.setUserId(value: string|null, resetSession?: boolean)

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

요구 사항

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

• npm을 통해 수분 에이전트를 설치하고 선택한 기능으로 사용자 정의 에이전트를 구축하는 경우 Agent 를 생성할 때 최소한 하나의 기능을 활성화해야 합니다. 예를 들어, 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는 특히 에러스 인박스(errors inbox) 사용을 위해 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)