プロンプトひとつで導入できるGodotのゲーム分析

1. 01

   Zivaに頼む

   知りたい内容を伝えます。例：「ゲームに分析機能を追加して。プレイヤーがコインを集めたときと、最初のレベルをクリアしたときを記録して」

2. 02

   ZivaがSDKを導入

   Zivaのアカウントに分析プロジェクトを作成し、ZivaAnalyticsを自動読み込み（Autoload）に登録して、設定をproject.godotに保存します。続けて、イベントを記録する呼び出しを追加します。

3. 03

   プレイして確認

   ゲームを実行してから、Zivaに分析の確認（「check analytics」）を頼むと、イベントが届いたかを確かめられます。イベントは通常5-15秒でダッシュボードに表示されます。

ZivaAnalytics.track("level_complete", {"level": 3, "time_s": 41.2})
ZivaAnalytics.identify("Bobby")

session_start

ゲームの起動時に、Godotのバージョンとロケールとともに記録します。

scene_changed

現在のシーンが切り替わったときに、シーン名とともに記録します。

heartbeat

60秒ごとに、その時点までのプレイ時間とともに記録します。

session_end

ウィンドウを閉じるときに、合計プレイ時間とともに記録します（送信できない場合があります）。

各イベントには、セッションID、ランダムなプレイヤーID、プラットフォーム、設定済みの場合はゲームのバージョンも含まれます。

分析機能は、エディター、Zivaのプレイテスト、Webビルドを含むエクスポートしたゲームで動作します。SDKはイベントをバックグラウンドで送信するため、ゲームの動作を止めません。サーバーがイベントを拒否した場合は、ゲームを止めずに、そのセッションの分析機能だけを停止します。