データモデル

Framedash SDK が収集・送信するデータの構造を説明します。

イベント

すべてのテレメトリはイベントとして送信されます。各イベントには共通フィールドとカスタムプロパティがあります。

共通フィールド

フィールド	型	説明
event_type	string	イベントの種類 (例: performance_sample, player_death)
timestamp	ISO 8601	イベント発生時刻
session_id	UUID	ゲームセッション ID
device_id	string	デバイス識別子
build_id	string	ビルドバージョン

パフォーマンスサンプル

SDK が自動収集するパフォーマンスデータ:

フィールド	型	単位
fps	float	frames/sec
frame_time	float	ms
gpu_time	float	ms
memory_used	int64	bytes
position	vec3	world units

カスタムイベント

開発者が定義するゲーム固有のイベント。properties フィールドに任意の JSON オブジェクトを格納できます。

セッション

ゲームの起動から終了までを 1 セッションとして管理します。セッションには以下のメタデータが含まれます:

• デバイス情報 (OS, GPU, RAM)
• ビルド情報 (バージョン, プロファイル)
• プレイヤー情報 (任意)

次のステップ

• API リファレンス — REST API でデータにアクセス
• ヒートマップ — 位置データの可視化