コンテンツにスキップ

データ収集のカスタムルール¶

自動 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 が返されます。