RUM 設定¶

    // RUM を有効化
    FTRumConfig *rumConfig = [[FTRumConfig alloc]initWithAppid:appid];
    rumConfig.enableTraceUserView = YES;
    rumConfig.deviceMetricsMonitorType = FTDeviceMetricsMonitorAll;
    rumConfig.monitorFrequency = FTMonitorFrequencyRare;
    rumConfig.enableTraceUserAction = YES;
    rumConfig.enableTraceUserResource = YES;
    rumConfig.enableTrackAppFreeze = YES;
    rumConfig.enableTrackAppCrash = YES;
    rumConfig.enableTrackAppANR = YES;
    rumConfig.errorMonitorType = FTErrorMonitorAll;
    [[FTMobileAgent sharedInstance] startRumWithConfigOptions:rumConfig];

    let rumConfig = FTRumConfig(appid: appid)
    rumConfig.enableTraceUserView = true
    rumConfig.deviceMetricsMonitorType = .all
    rumConfig.monitorFrequency = .rare
    rumConfig.enableTraceUserAction = true
    rumConfig.enableTraceUserResource = true
    rumConfig.enableTrackAppFreeze = true
    rumConfig.enableTrackAppCrash = true
    rumConfig.enableTrackAppANR = true
    rumConfig.errorMonitorType = .all
    FTMobileAgent.sharedInstance().startRum(withConfigOptions: rumConfig)

/// ページを作成します
///
/// `-startViewWithName` メソッドの前に呼び出します。このメソッドはページの読み込み時間を記録するために使用します。読み込み時間を取得できない場合は、このメソッドを呼び出す必要はありません。
/// - Parameters:
///  - viewName: ページ名
///  - loadTime: ページ読み込み時間（ナノ秒）
-(void)onCreateView:(NSString *)viewName loadTime:(NSNumber *)loadTime;

/// ページに遷移します
/// - Parameters:
///  - viewName: ページ名
///  - property: イベントのカスタムプロパティ（オプション）
-(void)startViewWithName:(NSString *)viewName property:(nullable NSDictionary *)property;

/// 現在の RUM View の読み込み時間を更新します。
/// `-startView` と `-stopView` メソッドの間でのみ呼び出すことで有効になります。
/// - Parameter duration: 読み込み時間（ナノ秒）。
-(void)updateViewLoadingTime:(NSNumber *)duration;

/// ページを離脱します
/// - Parameter property: イベントのカスタムプロパティ（オプション）
-(void)stopViewWithProperty:(nullable NSDictionary *)property;

/// ページを作成します
///
/// `-startViewWithName` メソッドの前に呼び出します。このメソッドはページの読み込み時間を記録するために使用します。読み込み時間を取得できない場合は、このメソッドを呼び出す必要はありません。
/// - Parameters:
///  - viewName: ページ名
///  - loadTime: ページ読み込み時間（ns）
open func onCreateView(_ viewName: String, loadTime: NSNumber)

/// ページに遷移します
/// - Parameters:
///  - viewName: ページ名
///  - property: イベントのカスタムプロパティ（オプション）
open func startView(withName viewName: String, property: [AnyHashable : Any]?)

/// 現在の RUM View の読み込み時間を更新します。
/// `-startView` と `-stopView` メソッドの間でのみ呼び出すことで有効になります。
/// - Parameter duration: 読み込み時間（ナノ秒）。
open func updateViewLoadingTime(_ duration: NSNumber)

/// ページを離脱します
/// - Parameter property: イベントのカスタムプロパティ（オプション）
open func stopView(withProperty property: [AnyHashable : Any]?)

- (void)viewDidAppear:(BOOL)animated{
  [super viewDidAppear:animated];
  // シナリオ 1：
  [[FTExternalDataManager sharedManager] startViewWithName:@"TestVC"];

  // シナリオ 2：動的パラメータ
  [[FTExternalDataManager sharedManager] startViewWithName:@"TestVC" property:@{@"custom_key":@"custom_value"}];
}
-(void)viewDidDisappear:(BOOL)animated{
  [super viewDidDisappear:animated];
  // シナリオ 1：
  [[FTExternalDataManager sharedManager] stopView];

  // シナリオ 2：動的パラメータ
  [[FTExternalDataManager sharedManager] stopViewWithProperty:@{@"custom_key":@"custom_value"}];
}

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    // シナリオ 1：
    FTExternalDataManager.shared().startView(withName: "TestVC")
    // シナリオ 2：動的パラメータ
    FTExternalDataManager.shared().startView(withName: "TestVC",property: ["custom_key":"custom_value"])
}
override func viewDidDisappear(_ animated: Bool) {
    super.viewDidDisappear(animated)
    // シナリオ 1：
    FTExternalDataManager.shared().stopView()
    // シナリオ 2：動的パラメータ
    FTExternalDataManager.shared().stopView(withProperty: ["custom_key":"custom_value"])
}

import SwiftUI
import GuanceSDK
struct HomeView: View {
    var body: some View {
        VStack {
            Text("Home")
        }
        .ftTrackRUMView(
            name: "Home",
            property: ["page_type": "home"]
        )
    }
}

/// RUM Action を開始します。
///
/// RUM はこの Action がトリガーする可能性のある Resource、Error、LongTask イベントをバインドします。0.1 秒以内に複数回追加しないでください。同じ View は同時に 1 つの Action のみに関連付けられ、前の Action が終了していない場合、新しい Action は破棄されます。
/// `addAction:actionType:property` メソッドで追加された Action とは相互に影響しません。
///
/// - Parameters:
///   - actionName: イベント名
///   - actionType: イベントタイプ
///   - property: イベントのカスタムプロパティ（オプション）
- (void)startAction:(NSString *)actionName actionType:(NSString *)actionType property:(nullable NSDictionary *)property;

/// Action イベントを追加します。破棄ロジックはなく、Resource、Error、LongTask イベントはバインドされません。
///
/// `startAction:actionType:property:` で開始された RUM Action とは相互に影響しません。
/// - Parameters:
///   - actionName: イベント名
///   - actionType: イベントタイプ
///   - property: イベントのカスタムプロパティ（オプション）
- (void)addAction:(NSString *)actionName actionType:(NSString *)actionType property:(nullable NSDictionary *)property;

/// RUM Action を開始します。
///
/// RUM はこの Action がトリガーする可能性のある Resource、Error、LongTask イベントをバインドします。0.1 秒以内に複数回追加しないでください。同じ View は同時に 1 つの Action のみに関連付けられ、前の Action が終了していない場合、新しい Action は破棄されます。
/// `addAction:actionType:property` メソッドで追加された Action とは相互に影響しません。
///
/// - Parameters:
///   - actionName: イベント名
///   - actionType: イベントタイプ
///   - property: イベントのカスタムプロパティ（オプション）
open func startAction(_ actionName: String, actionType: String, property: [AnyHashable : Any]?)

/// Action イベントを追加します。破棄ロジックはなく、Resource、Error、LongTask イベントはバインドされません。
///
/// `startAction:actionType:property:` で開始された RUM Action とは相互に影響しません。
/// - Parameters:
///   - actionName: イベント名
///   - actionType: イベントタイプ
///   - property: イベントのカスタムプロパティ（オプション）
open func addAction(_ actionName: String, actionType: String, property: [AnyHashable : Any]?)

// startAction
[[FTExternalDataManager sharedManager] startAction:@"action" actionType:@"click" property:@{@"action_property":@"testActionProperty1"}];
// addAction
[[FTExternalDataManager sharedManager] addAction:@"action" actionType:@"click" property:@{@"action_property":@"testActionProperty1"}];

// startAction
FTExternalDataManager.shared().startAction("custom_action", actionType: "click",property: nil)
// addAction
FTExternalDataManager.shared().addAction("custom_action", actionType: "click",property: nil)

import SwiftUI
import GuanceSDK
struct ProductView: View {
    var body: some View {
        Button("Buy") {
            FTRUMSwiftUI.trackTapAction(
                name: "buy_click",
                property: ["source": "product_detail"]
            )

            // ビジネス上のクリックロジックを実行
            buy()
        }
    }

    private func buy() {
        // ...
    }
}

import SwiftUI
import GuanceSDK
struct ProductCard: View {
    var body: some View {
        Text("Buy")
            .ftTrackRUMTapAction(
                name: "buy_click",
                property: ["source": "product_card"]
            )
    }
}

/// Error イベントを追加します
/// - Parameters:
///   - type: error タイプ
///   - message: エラーメッセージ
///   - stack: スタック情報
///   - property: イベントのカスタムプロパティ（オプション）
- (void)addErrorWithType:(NSString *)type message:(NSString *)message stack:(NSString *)stack property:(nullable NSDictionary *)property;

/// Error イベントを追加します
/// - Parameters:
///   - type: error タイプ
///   - state: プログラム実行状態
///   - message: エラーメッセージ
///   - stack: スタック情報
///   - property: イベントのカスタムプロパティ（オプション）
- (void)addErrorWithType:(NSString *)type state:(FTAppState)state  message:(NSString *)message stack:(NSString *)stack property:(nullable NSDictionary *)property;

/// Error イベントを追加します
/// - Parameters:
///   - type: error タイプ
///   - message: エラーメッセージ
///   - stack: スタック情報
///   - property: イベントのカスタムプロパティ（オプション）
open func addError(withType: String, message: String, stack: String, property: [AnyHashable : Any]?)

/// Error イベントを追加します
/// - Parameters:
///   - type: error タイプ
///   - state: プログラム実行状態
///   - message: エラーメッセージ
///   - stack: スタック情報
///   - property: イベントのカスタムプロパティ（オプション）
open func addError(withType type: String, state: FTAppState, message: String, stack: String, property: [AnyHashable : Any]?)

// シナリオ1
[[FTExternalDataManager sharedManager] addErrorWithType:@"type" message:@"message" stack:@"stack"];
// シナリオ2: 動的パラメータ
[[FTExternalDataManager sharedManager] addErrorWithType:@"ios_crash" message:@"crash_message" stack:@"crash_stack" property:@{@"custom_key":@"custom_value"}];
// シナリオ3: 動的パラメータ
[[FTExternalDataManager sharedManager] addErrorWithType:@"ios_crash" state:FTAppStateUnknown message:@"crash_message" stack:@"crash_stack" property:@{@"custom_key":@"custom_value"}];

// シナリオ1
FTExternalDataManager.shared().addError(withType: "custom_type", message: "custom_message", stack: "custom_stack")
// シナリオ2: 動的パラメータ
FTExternalDataManager.shared().addError(withType: "custom_type", message: "custom_message", stack: "custom_stack",property: ["custom_key":"custom_value"])
// シナリオ3: 動的パラメータ
FTExternalDataManager.shared().addError(withType: "custom_type", state: .unknown, message: "custom_message", stack: "custom_stack", property: ["custom_key":"custom_value"])

/// 処理落ちイベントを追加します
/// - Parameters:
///   - stack: 処理落ちスタック
///   - duration: 処理落ち時間（ナノ秒）
///   - property: イベントのカスタムプロパティ（オプション）
- (void)addLongTaskWithStack:(NSString *)stack duration:(NSNumber *)duration property:(nullable NSDictionary *)property;

/// 処理落ちイベントを追加します
/// - Parameters:
///   - stack: 処理落ちスタック
///   - duration: 処理落ち時間（ナノ秒）
///   - property: イベントのカスタムプロパティ（オプション）
func addLongTask(withStack: String, duration: NSNumber, property: [AnyHashable : Any]?)

// シナリオ1
[[FTExternalDataManager sharedManager] addLongTaskWithStack:@"stack string" duration:@1000000000];
// シナリオ2: 動的パラメータ
[[FTExternalDataManager sharedManager] addLongTaskWithStack:@"stack string" duration:@1000000000 property:@{@"custom_key":@"custom_value"}];

// シナリオ1
FTExternalDataManager.shared().addLongTask(withStack: "stack string", duration: 1000000000)
// シナリオ2: 動的パラメータ
FTExternalDataManager.shared().addLongTask(withStack: "stack string", duration: 1000000000 ,property: [["custom_key":"custom_value"]])

/// HTTP リクエスト開始
/// - Parameters:
///   - key: リクエスト識別子
///   - property: イベントのカスタムプロパティ（オプション）
- (void)startResourceWithKey:(NSString *)key property:(nullable NSDictionary *)property;

/// HTTP リクエストデータを追加
///
/// - Parameters:
///   - key: リクエスト識別子
///   - metrics: リクエスト関連のパフォーマンスプロパティ
///   - content: リクエスト関連データ
- (void)addResourceWithKey:(NSString *)key metrics:(nullable FTResourceMetricsModel *)metrics content:(FTResourceContentModel *)content;

/// HTTP リクエスト終了
/// - Parameters:
///   - key: リクエスト識別子
///   - property: イベントのカスタムプロパティ（オプション）
- (void)stopResourceWithKey:(NSString *)key property:(nullable NSDictionary *)property;

/// HTTP リクエスト開始
/// - Parameters:
///   - key: リクエスト識別子
///   - property: イベントのカスタムプロパティ（オプション）
open func startResource(withKey key: String, property: [AnyHashable : Any]?)

/// HTTP リクエスト終了
/// - Parameters:
///   - key: リクエスト識別子
///   - property: イベントのカスタムプロパティ（オプション）
open func stopResource(withKey key: String, property: [AnyHashable : Any]?)

/// HTTP リクエストデータを追加
///
/// - Parameters:
///   - key: リクエスト識別子
///   - metrics: リクエスト関連のパフォーマンスプロパティ
///   - content: リクエスト関連データ
open func addResource(withKey key: String, metrics: FTResourceMetricsModel?, content: FTResourceContentModel)

// ステップ1：リクエスト開始前
[[FTExternalDataManager sharedManager] startResourceWithKey:key];

// ステップ2：リクエスト完了
[[FTExternalDataManager sharedManager] stopResourceWithKey:key];

// ステップ3：Resource データを構築
// FTResourceContentModel データ
FTResourceContentModel *content = [[FTResourceContentModel alloc]init];
content.httpMethod = request.HTTPMethod;
content.requestHeader = request.allHTTPHeaderFields;
content.responseHeader = httpResponse.allHeaderFields;
content.httpStatusCode = httpResponse.statusCode;
content.responseBody = responseBody;
// ios native
content.error = error;

// 各フェーズの時間データを取得できる場合
// FTResourceMetricsModel
// ios native で NSURLSessionTaskMetrics データを取得した場合、FTResourceMetricsModel のイニシャライザを直接使用
FTResourceMetricsModel *metricsModel = [[FTResourceMetricsModel alloc]initWithTaskMetrics:metrics];

// その他のプラットフォーム すべての時間データはナノ秒単位
FTResourceMetricsModel *metricsModel = [[FTResourceMetricsModel alloc]init];

// ステップ4：add resource 時間データがない場合、metrics は nil を渡す
[[FTExternalDataManager sharedManager] addResourceWithKey:key metrics:metricsModel content:content];

// ステップ1：リクエスト開始前
FTExternalDataManager.shared().startResource(withKey: key)

// ステップ2：リクエスト完了
FTExternalDataManager.shared().stopResource(withKey: resource.key)

// ステップ3：① Resource データを構築
let contentModel = FTResourceContentModel(request: task.currentRequest!, response: task.response as? HTTPURLResponse, data: resource.data, error: error)

//② 各フェーズの時間データを取得できる場合
// FTResourceMetricsModel
// ios native で NSURLSessionTaskMetrics データを取得した場合、FTResourceMetricsModel のイニシャライザを直接使用
var metricsModel:FTResourceMetricsModel?
if let metrics = resource.metrics {
   metricsModel = FTResourceMetricsModel(taskMetrics:metrics)
}
// その他のプラットフォーム すべての時間データはナノ秒単位
metricsModel = FTResourceMetricsModel()
...

// ステップ4：add resource 時間データがない場合、metrics は nil を渡す
FTExternalDataManager.shared().addResource(withKey: resource.key, metrics: metricsModel, content: contentModel)