Unreal Engine 5 ドキュメントは Epic Developer Community に移動しました

エンジンのアナリティクス API は、UObject 非依存となるように作成されています。従って、ブループリントから C++ コードへの変換レイヤーが必要です。Epic ではこの変換レイヤーをブループリント ライブラリ プラグイン として提供しています。このプラグインを有効にすると、ブループリントからアナリティクス API のコールを開始できます。プラグインがコールを変換し、 プロジェクト用に登録したデフォルトの分析プロバイダーへ送ります。デフォルト プロバイダーを登録していないと、プロジェクトのログ ファイルに警告が出ます。

Start Session

現在のプレイヤーに対して、新規のアナリティクス セッションを開始します。それぞれのプレイ セッションは固有のセッションとして処理されるので、分析データはユーザーがゲームをプレイする頻度と継続時間をキャプチャすることができます。前のセッションが動作中だと、たいていのプロバイダーは前のセッションを自動的に終了して新しいセッションを開始します。

End Session

所定のセッションに対するイベントの記録を停止します。データをコレクタにフラッシュするプロバイダーもあります。

Record Event

関連する属性をもたないイベントを記録する場合、 Record Event ノードを使います。これらの種類のイベントは、多くの場合、ユーザーが特定のオプションを何回実行したか数えるために使われます。

Record Event With Attribute

単一の属性で名前ごとにイベントを記録するので、固有の属性全体におけるそのイベントの頻度の比較ができます。例えば、次の Item.Equipped イベントは、ユーザーがゲームで武器を装備する頻度を記録します。 そうすることで、ゲーム中のプレイヤーの間で最も人気の高いアイテムが分かります。

Record Event With Attribute

イベントをもっと細かく設定するためには、 Record Event with Attributes を使います。イベントのコンテキストとして複数の属性を設定したい場合に、これを使います。 次の例では、どんなアイテムが作成されたか、使用されたマテリアルは何か、プレイヤーの好みのダメージ モディファイアを表しています。この例を見ると、作成するアイテムに対するプレイヤーの好みが分かりますし、 バランス的な問題を事前に見出します。

Make AnalyticsEventAttr

文字列を 2 つ受け取り、それらをアナリティクス API が必要な構造体に簡単に変換できます。

Flush Events

プロバイダーの中には、収集した分析データを、閾値を満たすまで、あるいはセッションが終了するまでローカルにキャッシュするものもあります。このコールにより、プロバイダーはローカルにキャッシュされたデータをすべてコミットするように指示されます。

Record Item Purchase

インゲーム通貨を使ったインゲーム アイテムの購入を記録します。現実世界のような現金取引とは違って、これでインゲーム通貨を使って購入したアイテムを 追跡します。このインゲーム通貨は徐々に増やしたり、本物の現金で直接購入することができます。現金によるゲーム通貨の購入の追跡には、 Record Currency Purchase ノードを使用します。

Record Currency Given

ゲームがプレイヤーにインゲーム通貨を与えると記録します。クエストの完了、アイテムの販売、箱をあけることなどができます。インゲームの経済全体がどのように回っているのかを把握するために、 このデータの記録が重要になります。

Record Currency Purchase

現実世界の現金で支払ったインゲーム通貨の購入、つまりアプリ内課金を記録します。Apsalar など、この情報を自動的にキャプチャするプロバイダーもあります。 通常は、情報を手動でキャプチャしたいかどうかによって、このビヘイビアの設定のオンオフを切り替えることができます。