クイックスタート¶

このドキュメントでは、Unity RUM SDK を最短で導入するための手順を説明し、最小限のステップでデータ送信を検証できるようにします。

事前準備¶

開始する前に、以下の準備を行ってください。

1. リアルユーザーモニタリング（RUM）で Unity Android と Unity iOS のアプリをそれぞれ作成し、対応する App ID を取得します
2. 送信先 URL と認証方式を確認します：
3. ローカル環境へのデプロイ：datakitUrl を準備します
4. パブリック DataWay：datawayUrl と clientToken を準備します
5. プロジェクトに ft-sdk-unity.unitypackage がインポートされていることを確認します
6. プロジェクトに "com.unity.nuget.newtonsoft-json" がインストールされていることを確認します

導入手順¶

1. FTSDK.prefab を最初のシーンにドラッグします
2. アプリ起動時に FTUnityBridge.Install(...) を呼び出します
3. RUMConfig を初期化し、Android と iOS のそれぞれに対応する App ID を渡します
4. 必要に応じて LogConfig と TraceConfig を初期化します
5. アプリを実行し、ページ表示、ログ出力、ネットワークリクエストのいずれかを 1 回発生させます
6. Unity コンソールとGuanceプラットフォームでデータが正常に送信されたことを確認します

最小初期化例¶

FTUnityBridge.Install(new SDKConfig
{
    // ローカル環境へのデプロイでは datakitUrl を使用します
    datakitUrl = "http://10.0.0.1:9529",
    // パブリック DataWay では datawayUrl + clientToken を使用します
    // datawayUrl = "https://open.dataway.url",
    // clientToken = "client-token",
    env = "prod",
    debug = true,
});

FTUnityBridge.InitRUMConfig(new RUMConfig
{
    androidAppId = "androidAppId",
    iOSAppId = "iOSAppId",
    sampleRate = 1.0f,
});

datakitUrl と datawayUrl はどちらか一方を指定します。パブリック DataWay を使用する場合は、合わせて clientToken を渡してください。

任意：Log と Trace の初期化¶

FTUnityBridge.InitLogConfig(new LogConfig
{
    enableCustomLog = true,
    enableLinkRumData = true,
    sampleRate = 1.0f,
});

FTUnityBridge.InitTraceConfig(new TraceConfig
{
    enableNativeAutoTrace = true,
    enableLinkRumData = true,
    sampleRate = 1.0f,
});

任意：Unity の例外監視の追加¶

Unity の例外を RUM Error に変換したい場合は、Application.logMessageReceived を監視できます。

void OnEnable()
{
    Application.logMessageReceived += LogCallBack;
}

void OnDisable()
{
    Application.logMessageReceived -= LogCallBack;
}

void LogCallBack(string condition, string stackTrace, LogType type)
{
    if (type == LogType.Exception)
    {
        FTUnityBridge.AddError(stackTrace, condition);
    }
}

導入の成功を確認する¶

1. debug = true を有効にしたままアプリを実行します
2. ページを開くか、ネットワークリクエストを 1 回実行します
3. Unity コンソールに SDK 初期化とデータ同期に関するログが表示されることを確認します
4. Guanceコンソールに戻り、アプリに対応する RUM データが表示されていることを確認します

さらに詳しく調査する場合は、トラブルシューティング を参照してください。

次のステップ¶

• インストールと初期化の詳細は、アプリ導入 を参照してください
• すべての初期化パラメータの説明は、SDK 初期化 を参照してください
• RUM、Log、Trace の詳細な設定は、RUM 設定、Log 設定、Trace 設定 を参照してください
• プロジェクトがネイティブと Unity のハイブリッド開発の場合は、ネイティブと Unity のハイブリッド開発 を参照してください
• View、Action、Resource、Error、LongTask を手動で収集する場合は、RUM 手動トラッキング を参照してください