コンテンツにスキップ

クイックスタート

この記事では、Unity RUM SDK の最短の導入手順を示し、最小限の手順で検証可能なデータ送信を1回完了できるようにします。

アプリは Agent 自動導入と手動導入に対応しています。以下の手順では、手動導入の最小設定について説明します。

事前準備

開始前に、以下の準備を完了してください:

  1. リアルユーザーモニタリング(RUM)で Unity Android と Unity iOS のアプリをそれぞれ作成し、対応する App ID を取得します
  2. 送信先アドレスと認証方式を確認します:
  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. アプリを実行し、ページ表示、ログ出力、またはネットワークリクエストを一度発生させます
  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. ページを開くか、ネットワークリクエストを一度発行します
  3. Unity コンソールに SDK の初期化とデータ同期に関するログが出力されることを確認します
  4. Guanceコンソールに戻り、アプリに対応する RUM データが表示されていることを確認します

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

次のステップ

フィードバック

このページは役に立ちましたか?