데이터 수집 사용자 정의 규칙¶

자동 Action 수집 규칙에는 ft-sdk 0.1.16 이상이 필요합니다.

Action¶

• FTRUMConfig.setEnableTraceUserAction(true)를 활성화해야 합니다.
• 용도: ArkUI 컴포넌트를 기준으로 자동 Click Action 수집을 필터링합니다.

setActionTrackingHandler(...)로 핸들러를 설정합니다. null을 반환하면 SDK가 해당 Action을 수집하지 않습니다. undefined를 반환하면 SDK는 기본 자동 수집 프로세스에 따라 Action 이름, 속성, 위치 및 View 연결 정보를 보고합니다.

import {
  ActionEventWrapper,
  FTActionTrackingHandler,
  FTRUMConfig
} from '@guancecloud/ft_sdk/Index';

const actionHandler: FTActionTrackingHandler = {
  resolveHandlerAction: (event: ActionEventWrapper): null | undefined => {
    const source = event.getSource();

    // 지정된 컴포넌트가 트리거한 Action을 무시합니다.
    if (source?.getId() === 'ignore_action_view') {
      return null;
    }

    // 다른 작업은 SDK의 기본 자동 수집 로직을 계속 사용합니다.
    return undefined;
  }
};

const rumConfig = new FTRUMConfig()
  .setEnableTraceUserAction(true)
  .setActionTrackingHandler(actionHandler);

ActionEventWrapper는 다음 정보를 제공합니다.

• getSource(): 작업을 트리거한 ArkUI FrameNode입니다. 컴포넌트 ID, 유형 또는 사용자 정의 속성으로 필터링할 수 있습니다.
• getSourceType(): 작업 소스 유형입니다. 현재 HarmonyOS 자동 수집 경로는 ActionSourceType.CLICK_VIEW를 전달합니다.
• getExtra(): 추가 정보입니다. 현재 자동 Click 수집은 추가 정보를 전달하지 않으며 null을 반환합니다.