Skip to main content
このチュートリアルでは、新しい Statistic Service を使用して基本的な統計情報を作成する方法を紹介します。プレイヤーがロングショットを決めるたびに追跡したいと考えているシューティングゲームを例に始めましょう。

統計情報の作成

最初のステップは、ロングショットを追跡するための主要な要素を含む統計情報の定義を作成することです。今回のシューティングゲームでは、ロングショットの距離を示す列が 1 つだけ必要です。次の例は、C# SDK を使用して統計情報の定義を作成する方法を示しています。
それでは、この例の主要な要素について説明します。
  • AuthenticationContext: このパラメーターは、当社のサービスへのすべてのリクエストの背後にある認証を処理します。詳細な説明については、次のページを参照してください: 統計情報のクイックスタート
  • Name: このパラメーターは、統計情報の定義を識別するのに役立ちます。情報を取得するための他のリクエストで使用されるため、関連性のある名前を付けることが重要です。
  • EntityType: このパラメーターは、統計情報を作成するエンティティのタイプを指定します。詳細については、こちらをご覧ください: Entity プログラミングモデル
  • VersionConfiguration: このパラメーターを使用すると、一定期間後に自己リセットする統計情報のバージョニング戦略を設定できます。この概念については、こちらで詳しく説明しています: シーズナル統計情報
  • Columns: ここでは、統計情報の列数を定義します。定義ごとに最大 5 列です。この例では、ロングショット用に 1 列のみを設定しています。また、AggregationMethod を Max として定義しており、これは新しい値が前の値より大きい場合にのみ統計情報が更新されることを意味します。
    • AggregationMethod には 4 つの値があります。
      • Max: 新しい値が前の値より大きい必要があります。
      • Min: 新しい値が前の値より小さい必要があります。
      • Last: 常に最新の値で更新されます。
      • Sum: 前の値と新しい値が合算されます。
これらすべての情報が明確になったので、例を実行して最初の統計情報を作成する準備ができました。

統計情報の定義を取得する

この統計情報にデータを追加する前に、正しく作成されたことを確認したいと思います。この操作を行うには、統計情報の定義を取得する方法の例を示します。
統計情報の定義を取得するには、作成した統計情報の名前を指定します。複数の統計情報の定義がある場合は、次の例を使用して、1 回のリクエストですべての統計情報の定義を取得できます。

統計情報の定義を更新する

統計情報の定義を更新する場合は、次のようにできます。
なお、Columns、EntityType、および ResetInterval は更新の一部として変更できないことに注意してください。

統計情報にデータを追加する

シューティングゲームの例を続けると、統計情報の定義を作成し、取得し、必要に応じて削除する方法がわかりました。次のステップは、統計情報にデータを追加し始めることです。 これらの統計情報はエンティティベースの統計情報であり、エントリはエンティティであることに留意してください。この具体的な例では、エンティティタイプ title_player_account を使用しているため、統計情報はプレイヤーの情報を追跡します。ただし、他のエンティティタイプも使用できることを覚えておいてください。こちらで確認できます: 利用可能な組み込みエンティティタイプ それでは、統計情報にデータを追加する方法を見てみましょう。
それでは、この例の主要な要素について説明します。
  • Entity: このパラメーターは、統計情報を更新したいエンティティに対応します。
  • Statistics: このパラメーターは、エンティティの実際の統計情報のセットに対応します。
  • StatisticUpdate: このパラメーターは、追加される統計情報の値に対応します。
    • Scores: このパラメーターは、1 つのエンティティに追加できるスコアのリストに対応します。統計情報には複数の列があることを覚えておいてください。これらの概念については、こちらで詳しく確認できます: 統計情報でさらに多くのことを行う
    • Name: このパラメーターは、統計情報の定義を作成したときに設定した統計情報の名前に対応します。
これらの概念が明確になったので、統計情報にデータを追加する準備ができました。

統計情報からデータを取得する

簡単におさらいしましょう。この時点で、統計情報を作成し、すべての設定の詳細を確認し、データを追加し始めました。ここで、一部のプレイヤーがすでにあなたのゲームを使用しており、全員が印象的なロングショットを持っていると想像してみましょう。そのうちの 1 人をクエリしたいと思います。次の例では、この操作を行う方法を示します。
ここでは、エンティティに関連付けられたすべての統計情報をクエリし、対応する値とともに名前を表示します。

統計情報の値を削除する

統計情報は期待どおりに動作しており、ゲームには多くのプレイヤーがいます。ただし、ゲーム内で異常な動作に気づき始めたため、リセットして統計情報のデータを削除することにしました。次の例では、統計情報からデータを削除する方法を確認できます。
それでは、この例の主要な要素について説明します。
  • Entity: このパラメーターは、削除する対象のエンティティです。
  • List<StatisticDelete>: このパラメーターは、削除したい統計情報の名前のリストです。

まとめ

このチュートリアルでは、次の操作の方法を学びました。
  • 統計情報の作成
  • 統計情報の設定の確認
  • 統計情報の設定の更新
  • 統計情報の設定の削除
  • 統計情報へのデータの追加
  • 統計情報のエントリの削除

関連項目

最終更新日 2026年8月25日