User Insights
注釈：本資料はAI技術を用いて翻訳されています。
Overview
User Insights は、ADT Admin Portal のアナリティクス機能であり、ゲーム開発者がゲーム内の個々のユーザーについて、セッションをまたいだ永続的なビューを得られるようにします。クラッシュやセッションを個別のイベントとして捉えるのではなく、開発者は単一のユーザーの完全な履歴（そのユーザーが誰か、どのようなハードウェアで動作させているか、何回のセッションを行ったか、何回のクラッシュを経験したか）を追跡できます。
User Insights は Health の柱の一部であり、Admin Portal の Debugging セクション内に位置し、ゲームごとにスコープが設定されます。
Why User Insights Exists
セッション ID は、ユーザーがゲームを起動するたびに変わります。安定した ID がなければ、同じユーザーから発生した 2 件のクラッシュも、10 人の異なるユーザーから発生した 10 件のクラッシュと区別がつきません。その結果、以下のことが困難になります。
- 繰り返しクラッシュしているユーザー（「困っているユーザー」）を特定すること
- 広範囲にわたる問題と、単一ユーザーのハードウェア問題を区別すること
- 修正が影響を受けたユーザーにとって実際に問題を解決したかどうかを追跡すること
- 影響を受けたユニークユーザーの数に基づいてバグ調査の優先順位を付けること
User Insights は、セッションをまたいで永続する安定した User ID を導入します。これにより、時間の経過とともにイベントを関連付け、セッション単位のデータでは見えてこないパターンを明らかにできます。
How User Insights Works
The User ID
ゲーム内のすべてのユーザーには、セッション作成時に SDK が自動的に送信する 2 つの ID シグナルから導出される永続的な User ID が割り当てられます。
- ADT アカウント / コンピューターのユーザー名 — セッションリクエストの
ComputerUsernameフィールド - マシン名 — デバイスのホスト名
結果として得られる User ID は、次の 2 つの形式のいずれかを取ります。
| Format | Meaning |
|---|---|
platform-{uuid} | ユーザーはリンクされた AGS (AccelByte Game Services) アカウントを持っています |
device-{uuid} | ユーザーはデバイスのみで識別されます — AGS アカウントはリンクされていません |
platform-* プレフィックスは、より信頼性の高い（アカウントに裏付けられた）ID を示し、device-* は匿名またはデバイスのみのユーザーを示します。どちらのタイプも User Insights に表示され、セッションをまたいで追跡できます。
Device Metadata
User ID に加えて、ADT は最初のセッション作成時に、ユーザーごとにハードウェアおよび環境のメタデータを保存します。このメタデータには以下が含まれます。
- CPU および GPU のモデル
- オペレーティングシステムおよび OS のバージョン
- レンダラー、システムアーキテクチャ、メモリ
- IP アドレス、国コード、ロケール
IP アドレスは、適用されるプライバシー規制（例: GDPR）の下では個人データに該当します。規制対象地域のユーザーに対して User Insights を有効化する前に、スタジオのプライバシーポリシーおよびデータ処理契約がこのフィールドの収集を対象としていることを確認してください。
このデータは、ダッシュボードのフィルタリングおよびセグメンテーション機能を支えます。
Data Flow
- ゲームクライアントは、コンピューターのユーザー名とデバイスメタデータを含むセッションリクエストを送信します。これは SDK によって自動的に処理されるため、追加の統合作業は不要です。
- プロファイリングサービスは安定した User ID を計算して保存し、そのユーザーからの後続のすべてのセッションとクラッシュを同じ ID に関連付けます。
- Admin Portal はプロファイリングサービスにクエリを実行し、User Insights ダッシュボードにユーザーごとの集計データを表示します。
User ID は、機能フラグが有効化された時点から割り当てられます。有効化前に記録されたクラッシュやセッションは、遡って User ID に紐付けられることはありません。
Key Benefits
- 困っているユーザーの特定 — 単発の孤立したクラッシュを経験したユーザーと区別して、繰り返しクラッシュを経験しているユーザーを浮かび上がらせます
- 完全なユーザー履歴 — 個々のクラッシュレポートを横断的に検索することなく、特定のユーザーのすべてのセッションとクラッシュを 1 か所で確認できます
- ハードウェアを考慮したデバッグ — CPU、GPU、OS、地域でユーザーをフィルタリングし、クラッシュがハードウェア固有か環境固有かを判断できます
- プラットフォームによるセグメンテーション — AGS にリンクされたユーザー（
platform-*）と匿名のデバイスユーザー（device-*）の内訳を把握できます - SDK の変更は不要 — User Insights は SDK がすでに送信しているデータをもとに機能するため、追加の計装は必要ありません
Limitations and Considerations
- 機能フラグが必要 — User Insights はデフォルトで無効になっています。ダッシュボードを表示する前に、ネームスペース管理者が ADT Web > Namespace Settings > Labs の下にある User Insights トグルを有効にする必要があります。
- デバイスのみの ID はアカウント単位ではありません —
device-*ユーザーは、ログインしたアカウントではなくマシンによって識別されます。ユーザーが OS を再インストールしたりマシンを変更したりすると、新しいユーザーとして表示される場合があります。 - 権限が必要 — User Insights へのアクセスには
NAMESPACE:{namespace}:SESSION [READ]権限が必要です。この権限を持たないユーザーはダッシュボードを表示できません。
Supported Platforms
User Insights はバックエンドおよび Admin Portal の機能です。セッションレポートに ADT SDK を使用するあらゆるプラットフォームからデータを受信できます。
| Engine | Platform | Supported |
|---|---|---|
| Unreal Engine | Windows | Yes |
| Unreal Engine | PS5, Xbox | Yes |
| Unreal Engine | macOS | Yes |
| Unreal Engine | iOS, Android | Yes |
| Unity | Windows | Yes |
| Unity | macOS | Yes |
| Unity | iOS, Android | Yes |
プラットフォーム固有の SDK 設定は必要ありません。サポートの条件は、SDK が ADT にセッションデータを送信していることのみです。