사용자 작업 추적¶

브라우저 모니터링은 사용자의 상호작용을 자동으로 감지하고, 애플리케이션에서 매번 클릭을 수동으로 감지할 필요 없이 사용자 행동을 깊이 이해할 수 있도록 합니다.

다음 목표를 달성할 수 있습니다.

주요 상호작용의 성능 이해 (예: 특정 액션 버튼 클릭)
기능 채택률 정량화
특정 브라우저 오류의 단계 확인

Action 수집 활성화 제어¶

trackUserInteractions 초기화 파라미터는 애플리케이션 내 사용자 클릭을 수집할 수 있습니다. 즉, 페이지에 포함된 민감 및 개인 데이터가 사용자가 상호작용하는 요소를 식별하기 위해 포함될 수 있습니다.

window.DATAFLUX_RUM &&
  window.DATAFLUX_RUM.init({
    // 기타 초기화 설정
    trackUserInteractions: true
  })

사용자 상호작용 추적¶

RUM SDK는 클릭을 자동으로 추적합니다. 다음 조건을 모두 충족하면 클릭 Action이 생성됩니다.

클릭 후 활동이 감지됨, 즉 페이지 활동 상태
클릭이 새 페이지 로드로 이어지지 않음 (이 경우 RUM SDK는 다른 RUM View 이벤트를 생성함)
Action 이름을 가져올 수 있음

Action 메트릭¶

메트릭	유형	설명
`action.duration`	number(ns)	액션의 로드 시간.
`action.action_long_task_count`	number	이 액션에 대해 수집된 모든 긴 작업의 개수.
`action.action_resource_count`	number	이 액션에 대해 수집된 모든 리소스의 개수.
`action.action_error_count`	number	이 액션에 대해 수집된 모든 오류의 개수.

RUM SDK는 각 클릭 후 페이지 활동을 모니터링하여 액션 로드 시간을 계산합니다. 페이지에 더 이상 활동이 없으면 액션이 완료된 것으로 간주됩니다.

Action 속성¶

속성	유형	설명
`action.action_id`	String	사용자 작업의 UUID
`action.action_type`	String	사용자 작업 유형. 사용자 지정 사용자 작업의 경우 `custom`으로 설정
`action.action_target`	String	사용자가 상호작용한 요소. 자동 수집된 작업에만 적용됨
`action.action_name`	String	사용자 친화적인 이름 생성 (예: "#checkout 클릭"). 사용자 지정 사용자 작업의 경우 API 호출에 지정된 작업 이름

Action 작업 이름¶

RUM SDK는 클릭 가능한 요소와 그 상위 요소를 기반으로 Action 이름을 유추합니다. 자동 생성된 이름이 충분히 안정적이지 않은 경우 내장 속성을 사용하여 명시적으로 이름을 지정할 수 있습니다.

클릭 가능한 요소 또는 그 상위 요소에 data-guance-action-name을 추가합니다.

<button type="button" data-guance-action-name="주문 제출">주문 제출</button>

actionNameAttribute 초기화 파라미터를 사용하여 요소에 사용자 지정 속성을 추가하여 작업 이름을 지정할 수 있습니다.

초기화 시 속성 이름을 지정합니다.

window.DATAFLUX_RUM &&
  window.DATAFLUX_RUM.init({
    // 기타 초기화 설정
    trackUserInteractions: true,
    actionNameAttribute: "data-custom-name"
  })

클릭 가능한 요소 또는 그 상위 요소에 해당 속성을 설정합니다.

<button type="button" data-custom-name="주문 제출">주문 제출</button>

요소에 내장 속성과 actionNameAttribute로 설정된 사용자 지정 속성이 동시에 존재하는 경우 내장 속성이 우선합니다.

사용자 지정 Action¶

클릭으로 표현할 수 없는 비즈니스 작업은 addAction API를 사용하여 사용자 지정 Action을 생성하세요.

연결 확인¶

명확한 이름이 있는 버튼을 클릭합니다.
브라우저 Network에서 /v1/write/rum上报 요청이 있는지 확인합니다.
해당 웹 애플리케이션의 Action 탐색기에서 Action 이름, 지속 시간 및 연결된 Resource와 Error 개수를 확인합니다.

Action이 없는 경우, trackUserInteractions가 true인지, 현재 세션이 샘플링에 포함되었는지, 클릭 후 귀속 가능한 페이지 활동이 발생했는지 순서대로 확인하세요.