사용자 식별자 커스터마이징¶
SDK는 익명 사용자를 위한 식별자를 생성합니다. 사용자가 로그인한 후 setUser()를 호출하여 안정적인 비즈니스 사용자 정보를 기록하면, 세션 간에 동일 사용자의 View, Action, Resource, Error를 조회할 수 있습니다.
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
String | 아니요 | 안정적이고 민감한 정보를 직접 노출하지 않는 비즈니스 사용자 ID를 권장합니다 |
name |
String | 아니요 | 사용자 닉네임 또는 표시 이름 |
email |
String | 아니요 | 사용자 이메일 |
| 기타 필드 | Unknown | 아니요 | 비즈니스에 필요한 사용자 속성(예: 멤버십 등급) |
최소한 id를 제공하는 것이 좋습니다. 자주 변경되는 닉네임이나 이메일로 안정적인 사용자 ID를 대체하지 마세요.
사용자 분석에서 비즈니스 사용자를 연결할 때, 최초 설정 또는 비즈니스 사용자 전환 시 반드시 안정적이고 비어 있지 않은 id를 전달해야 합니다. SDK의 user.id는 탐색기의 저장 필드 userid에 해당합니다. SDK가 자동 생성한 비어 있지 않은 식별자도 사용자 통계에 포함될 수 있으며, 이름이나 이메일을 제공할 필요는 없습니다.
동일한 워크스페이스 내 여러 애플리케이션을 통합 분석해야 하는 경우, 일관된 비즈니스 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 예시¶
로그아웃 또는 사용자 전환¶
setUser()와 clearUser()는 사용자 컨텍스트만 업데이트하며, 세션을 자동으로 종료하거나 새로 생성하지 않습니다. SDK 3.3.6부터 로그인 또는 계정 전환 후에는 먼저 전체 비즈니스 사용자 정보를 설정한 다음, startSession()을 호출하여 새 Session 경계를 생성할 수 있습니다.
로그아웃 시에는 먼저 비즈니스 사용자 정보를 지운 다음 새 Session을 생성하여, 이후 이벤트가 기존 비즈니스 사용자에게 계속 연결되지 않도록 해야 합니다.
CDN 연동은 window.DATAFLUX_RUM의 동일한 이름의 메서드를 사용합니다. 비동기 로드 시 onReady 콜백 내에서 실행합니다.
동일 사용자의 이름이나 기타 속성만 업데이트하려면 setUserProperty()로 부분 업데이트를 수행하고, id가 없는 setUser()로 기존 사용자 컨텍스트를 덮어쓰지 마세요. 또한 이 경우 startSession()을 호출할 필요도 없습니다.
페이지 새로고침 및 로컬 저장소¶
기본 사용자 컨텍스트는 탭 메모리에 유지되며, 새로고침 후에는 애플리케이션이 로그인 상태를 복원한 다음 사용자 정보를 설정해야 합니다. storeContextsToLocal을 활성화하면 사용자 컨텍스트가 새로고침 후에도 복원될 수 있습니다. 로그아웃 시에는 반드시 clearUser()를 호출하여 영속화된 비즈니스 사용자 정보를 지워야 합니다.
동일 출처의 여러 애플리케이션이 로컬 저장소를 사용하는 경우, storeContextsKey를 통해 워크스페이스, 애플리케이션, 환경을 구분해야 합니다. 동일 출처에서 동일한 Key를 사용하는 탭 간에는 사용자 컨텍스트가 동기화될 수 있습니다. 비즈니스 컨텍스트의 저장 격리는 Session 격리와 동일하지 않으므로, 다중 계정 시나리오에서 세션 귀속을 검증해야 합니다. 매개변수 설명은 Web 애플리케이션 연동을 참조하세요.
주의사항¶
- 비밀번호, 액세스 Token, 주민등록번호 등 민감한 정보를 기록하지 마세요.
- 사용자 정보는 설정 이후에 발생하는 이벤트에만 영향을 미치며, 이미 업로드된 데이터는 수정하지 않습니다.
- 사용자 전환 후에는 사용자 정보와 Session을 함께 업데이트하여 두 계정의 데이터가 동일한 Session에 포함되지 않도록 해야 합니다.
사용자 분석에서 여러 사용자가 포함되었거나 전체 사용자 귀속을 확인할 수 없는 세션은 리플레이를 제공하지 않습니다. 사후에 사용자 정보를 업데이트해도 과거 세션의 귀속은 수정되지 않습니다.
검증¶
사용자를 설정한 후 페이지 작업을 한 번 트리거하고, View 또는 Action 탐색기에서 userid가 설정한 user.id와 일치하는지 확인합니다. 로그인, 계정 전환 또는 로그아웃 후에는 위 순서대로 사용자 컨텍스트를 업데이트하고 startSession()을 호출한 다음, 새 이벤트의 session_id가 변경되었고 기존 비즈니스 사용자에게 계속 연결되지 않는지 확인합니다.
setUserProperty()만으로 동일 사용자의 속성을 업데이트한 경우, userid와 session_id가 모두 변경되지 않는지 확인합니다.