数据采集自定义规则¶

自动 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);

注意

返回 null 的 Action 会被跳过；返回 undefined 时，SDK 继续默认自动采集。该处理器仅影响自动 Click 采集，不影响手动调用 FTRUMGlobalManager.addAction(...) 或 startAction(...)。

ActionEventWrapper 提供以下信息：

getSource()：触发操作的 ArkUI FrameNode；可用于按组件 ID、类型或自定义属性过滤。
getSourceType()：操作来源类型。当前 HarmonyOS 自动采集链路传入 ActionSourceType.CLICK_VIEW。
getExtra()：附加信息；当前自动 Click 采集未传入附加信息，返回 null。