roblox-analytics

Roblox 分析リファレンス

読み込むタイミング

プレイヤーの行動、経済イベント、ファネル、オンボーディングのトレースを追跡する場合や、AnalyticsService の計測機能を構築する場合に読み込みます。

クイックリファレンス

主なルール：

• 組み込みの AnalyticsService を使用します。サードパーティ製 SDK は不要です。
• イベントの種類：カスタム（カウンター／値）、経済（通貨の流れ）、ファネル（ステップの進行）
• レート制限：毎分 120 + （20 × CCU）回。可能な場合はバッチ処理します。
• 経済イベントは確定した変更を報告します。診断イベントでは失敗した試行を記録できます。
• 確定した変更が返した残高を報告します。leaderstats のレプリカから再計算してはいけません。再加算により二重計上されます。
• 経済イベントでは、通貨の獲得元（収入）と消費先（支出）を個別に追跡します。
• ファネルのステップは順番どおりに発生させる必要はありません。後続のステップを記録すると、スキップされたステップも遡って補完されます。
• ダッシュボードへの反映には約 24 時間かかります。「View Events」ではリアルタイムで検証できます。
• サーバー側での記録を推奨します。クライアント側での記録は UI 操作の追跡にのみ使用します。
• Creator Rewards：AnalyticsService に付与イベントはありません。先行指標（セッション時間、オンボーディング、紹介）を追跡してください。支払いは Creator Dashboard が管理します。
• 初回セッションのトレース：上限付きバッファー、共有の保存担当、RTBF と保持期間。適格性はトレースの有無ではなく、プレイヤーの履歴に基づいて判断します。試行も重要です。full.md §8。

経済の健全性（意思決定レイヤー）：

• 初日から計測します。過去の履歴を後から補完することはできません。
• 通貨ごとに収入元と支出先の両方を記録し、SKU と変更後に返された残高も含めます。
• 健全性のシグナル：支出／収入比率、インフレ、上位支出者への集中度、弾力性、支出先の充足度、D1／D7 コホート。しきい値は経験則です。
• 経済が破綻した場合：イベントを検証し、最も限定的な問題のシグナルを確認し、レバーを 1 つだけ変更して再確認します。

関連項目： roblox-growth-design（監査ワークフロー）、roblox-monetization（購入ファネル）。

詳細情報が必要ですか？ references/full.md：コード例、API テーブル、エッジケース。