콘텐츠로 이동

사용자 정의 사용자 식별자

SDK는 익명 사용자를 위한 식별자를 생성합니다. 사용자가 로그인하면 setUser()를 호출하여 안정적인 비즈니스 사용자 정보를 기록할 수 있으며, 이를 통해 세션 간에 동일 사용자의 View, Action, Resource 및 Error를 조회할 수 있습니다.

속성 유형 필수 설명
id String 아니요 안정적이고 민감한 정보를 직접 노출하지 않는 비즈니스 사용자 ID를 입력하는 것이 좋습니다
name String 아니요 사용자 닉네임 또는 표시 이름
email String 아니요 사용자 이메일
기타 필드 Unknown 아니요 비즈니스에 필요한 사용자 속성(예: 멤버십 등급)

최소한 id를 제공하는 것이 좋습니다. 자주 변경되는 닉네임이나 이메일을 안정적인 사용자 ID 대신 사용하지 마세요.

NPM 예제

import { datafluxRum } from "@cloudcare/browser-rum"

datafluxRum.setUser({
  id: "user-1234",
  name: "John Doe",
  email: "john@example.com",
  membership_level: "gold"
})

CDN 예제

window.DATAFLUX_RUM &&
  window.DATAFLUX_RUM.setUser({
    id: "user-1234",
    name: "John Doe",
    email: "john@example.com"
  })
window.DATAFLUX_RUM.onReady(function () {
  window.DATAFLUX_RUM.setUser({
    id: "user-1234",
    name: "John Doe",
    email: "john@example.com"
  })
})

로그아웃 또는 사용자 전환

로그아웃 시 clearUser()를 호출하여 이후 이벤트가 원래 사용자와 계속 연결되지 않도록 합니다.

datafluxRum.clearUser()

SDK 3.3.6부터는 로그인, 로그아웃 또는 계정 전환 후 사용자 정보를 먼저 업데이트한 다음 startSession()을 호출하여 즉시 새 세션 경계를 생성할 수 있습니다.

datafluxRum.setUser({ id: "user-5678" })
datafluxRum.startSession()

CDN 통합은 window.DATAFLUX_RUM.clearUser()window.DATAFLUX_RUM.startSession()을 사용합니다.

주의사항

  1. 비밀번호, 액세스 토큰, 주민등록번호 등 민감한 정보를 입력하지 마세요.
  2. 사용자 정보는 설정 이후에 생성된 이벤트에만 영향을 미치며, 이미 보고된 데이터는 수정되지 않습니다.
  3. 사용자 전환 후 사용자 정보와 세션을 동기화하여 두 계정의 데이터가 동일한 세션에 포함되지 않도록 해야 합니다.

확인

사용자를 설정한 후 페이지 작업을 트리거하고 View 또는 Action 탐색기에서 이벤트에 user.id가 포함되었는지 확인합니다. 로그아웃하고 clearUser()를 호출한 후에는 새로 생성된 이벤트가 원래 사용자와 연결되지 않아야 합니다.

문서 평가

이 페이지가 도움이 되었나요?