コンテンツレジストリ

コンテンツレジストリは、ゲーム内のマップ・アイテム・スキルなどの静的メタデータを管理し、テレメトリデータと紐づける機能です。

なぜ必要か

汎用のテレメトリツールでは、イベントデータに含まれる ID が何を指しているかわかりません。コンテンツレジストリを使うことで:

• item_id: "sword_01" → 「炎の剣 (レア / 武器カテゴリ)」
• map_id: "map_desert" → 「砂漠アリーナ (PvP マップ)」

テレメトリにゲーム文脈を付与し、意味のある分析を可能にします。

コンテンツの種類

種類	説明	例
map	ゲームマップ	ステージ、アリーナ、ワールド
item	ゲーム内アイテム	武器、消耗品、装備
skill	スキル/アビリティ	攻撃、バフ、パッシブ
character	キャラクター	プレイアブル、NPC
custom	カスタム定義	任意のゲーム要素

データ同期

コンテンツレジストリのデータは、ゲームのマスタデータと同期します。

手動登録

ダッシュボードまたは REST API (POST /v1/content) から個別に登録できます。

一括インポート (推奨)

CI パイプラインから CLI でマスタデータを JSON 一括インポート:

framedash content import ./game-content.json

game-content.json の形式:

[
  {
    "type": "item",
    "external_id": "item_hp_01",
    "name": "Health Potion",
    "metadata": { "rarity": "common", "category": "consumable" }
  }
]

テレメトリとの連携

SDK でイベントを送信する際に external_id を含めると、ダッシュボードでコンテンツ名やメタデータが自動表示されます。

次のステップ

• API リファレンス — コンテンツレジストリ API
• CLI リファレンス — データ同期コマンド