> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# イベント ベースの統計のポータル構成

> ゲーム イベントがプレイヤー統計を更新してリーダーボードを駆動するように、Partner Center でイベント ベースの XBOX Live ステータス ルールを追加、編集、コピー、および削除します。

> [!NOTE]
>
> このトピックでは、適切な権限がある場合にのみ利用できる機能について説明します。詳細は、アカウント マネージャーまたは Microsoft の他の窓口にお問い合わせください。

このトピックでは、タイトルの Partner Center サービス構成でステータス ルールを追加および変更する手順について説明します。プレイヤー統計は、ゲームが XBOX services にイベントを送信したときにトリガーされるステータス ルールに従って作成および更新されます。

XBOX services 構成の概要については、[ポータル構成の概要](/ja-jp/services/xbox-services/fundamentals/portal-config/live-portal-config-overview) を参照してください。

Data Platform 2013 の概要については、[イベント ベースのプレイヤー データの概要](/ja-jp/services/xbox-services/player-data/stats-leaderboards/event-based/live-how-data-platform-works) を参照してください。

このトピックでは、次の内容について説明します。

* [ステータス ルールとは](#ID4EMB)
* [ステータス ルールの構成準備](#ID4ENC)
* [ステータス ルールの作成](#ID4ELC)
* [既存のステータス ルールの変更](#ID4E2C)
* [ステータス ルールの編集](#ID4ELE)
* [既存のステータス ルールのコピー](#ID4EMS)
* [既存のステータス ルールの削除](#ID4EMF)

## ステータス ルールとは

*ステータス ルール* は、特定の名前を持つイベントが XBOX データ プラットフォーム サービスによって受信されたときにトリガーされます。(適切なイベントを送信することで) ステータス ルールをトリガーすると、サービスは 1 つ以上のプレイヤー統計を作成または更新します。

プレイヤー統計は、開発者によって定義され、XBOX services データ プラットフォーム サービスによって計算され、ユーザーごとに名前と値のペアとして格納されます。プレイヤー統計の例をいくつか示します。

* 難易度ハードでショットガンを使ってゾンビを倒した総数
* マッチで倒した敵の最大数
* レースを完走した最速タイム
* 最も最近運転した車の名前

プレイヤー統計は、プレイヤーのゲーム ハブ UI で注目統計または hero stats として表示されたり、リーダーボードに表示されたり、実績の解除に使用されたりできます。

個別のステータス ルールは、次のいずれかを生成するように構成できます。

* プレイヤー統計の単一インスタンス
* ステータス テンプレートに基づくプレイヤー統計の複数インスタンス

ステータスとステータス ルールの詳細は、次のトピックを参照してください。

* [イベント ベースの統計の概要](/ja-jp/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview)
* [イベント ベースの統計ルールの概要](/ja-jp/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-user-stat-rules)
* [ユーザー ステータス シナリオ](/ja-jp/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-user-stats-scenarios)

次の図は、ステータス インスタンスを更新するステータス ルールをトリガーするイベントのフローを示しています。

![ステータス インスタンスを更新するステータス ルールをトリガーするイベントのフローを示す図の画像。](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/event-stat-rule-instance-template.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=6f4d1a70d3fd9a0695069b7bd042f138)

[このトピックの先頭に戻る。](#top)

## ステータス ルールの構成準備

**前提条件:** ステータス ルールはイベントに基づいているため、ステータス ルールを作成する前にイベントを作成する必要があります。詳細は、[イベントのポータル構成](/ja-jp/services/xbox-services/player-data/stats-leaderboards/event-based/events/config/live-events-portal) を参照してください。

1. [Partner Center](https://partner.microsoft.com/dashboard/) にアカウントでサインインします。**Overview** ページが表示され、製品のリストが表示されます。

2. タイトルを見つけて選択します。**Game overview** ページが次のように表示されます。

   ![Partner Center の Game overview ページのスクリーンショット。](https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-product2013-gameoverview.png?fit=max\&auto=format\&n=ktEik-YaZoen6Rhy\&q=85\&s=ca66802159931973825dcdda5a0c5415)

3. 灰色の背景を持つ左側のナビゲーションで、**XBOX Live** を選択して展開し、**Gameplay settings** を選択します。**Gameplay Setting** ページが次のように表示されます。

   ![Partner Center の Gameplay Setting ページのスクリーンショット。](https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-gameplay-setting-page.png?fit=max\&auto=format\&n=ktEik-YaZoen6Rhy\&q=85\&s=e4039ad49909a9898ad54d538fe56e70)

4. ページの上部で、**Player stats** メニューを選択し、次のように **Stat rules** を選択します。
   この Partner Center UI では、「player stats」は「イベント ベースの User Stats」を意味します。

   ![Partner Center の Player stats メニューのスクリーンショット。](https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-stat-rules-menu.png?fit=max\&auto=format\&n=ktEik-YaZoen6Rhy\&q=85\&s=c34c095faeb6de3c53d98309df1aaa26)

   **Gameplay Setting** ページで、次のように **Events and stat rules** ページが表示されます。

   ![Partner Center の Events and stat rules ページのスクリーンショット。](https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-events-and-stat-rules-page.png?fit=max\&auto=format\&n=ktEik-YaZoen6Rhy\&q=85\&s=7011f4c8333bfef7d5b9ec476aa087ec)

   最初、ページの下部にある表は空です。「No player stats configured」となっています。

5. **Events and stat rules** ページで、それらのイベントに基づくイベントおよびステータス ルールを構成します。詳細は、以下のセクションを参照してください。

[このトピックの先頭に戻る。](#top)

## ステータス ルールの作成

**前提条件:** ステータス ルールはイベントに基づいています。したがって、ステータス ルールを作成する前にイベントを作成する必要があります。詳細は、[イベントのポータル構成](/ja-jp/services/xbox-services/player-data/stats-leaderboards/event-based/events/config/live-events-portal) を参照してください。

1. 前のセクションで説明したように **Events and stat rules** ページに移動します。

2. イベントの行で、右側の **Actions** 列で省略記号ボタン (...) を選択し、次のように **New stat rule** を選択します。

   ![Partner Center でステータス ルールを作成するためのイベントを選択したスクリーンショット。](https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/new-stat-rule-menuitem.png?fit=max\&auto=format\&n=ktEik-YaZoen6Rhy\&q=85\&s=109ee57f08b99f317c6eb2f71a6d336b)

   **Add stat rule** ダイアログが次のように表示されます。

   ![Partner Center の Add stat rule ダイアログのスクリーンショット。](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/add-stat-rule-dbox.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=469b04002c0bf6b93cb05e148e490256)

   * **ステータス ルールに追加されるイベント フィールド**
     * このオプションのフィールドを使用して、ステータス ルールの一部としてベース イベントに含まれるフィールドを選択します。
     * ドロップダウンで、ステータス ルールに追加するフィールドを選択します。この方法で複数のフィールドを追加できます。選択したフィールドは、ドット (.) 文字で区切られてステータス ルールのルート名に追加されます。
     * フィールドを削除するには、その名前の横の **X** を選択します。

   * **ステータス ルール名**
     ステータス ルールを特徴付け、簡単に記憶し認識できる名前を指定します。ステータス ルールの名前は、*ルート* 名と、オプションでドット (.) 文字で区切られた 1 つ以上の *フィールド* で構成されます。ステータス ルール名の命名要件の詳細は、[イベント ベースの統計ルールの概要](/ja-jp/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-user-stat-rules) を参照してください。

   * **演算子**
     次の演算子のいずれかを選択します。

     * **Sum**
       既存のステータス値を **Parameter** フィールドで指定された値でインクリメントします。

     * **Min**
       既存のステータス値と **Parameter** フィールドの値の最小値を使用します。

     * **Max**
       既存のステータス値と **Parameter** フィールドの値の最大値を使用します。

     * **Replace**
       ステータス値を **Parameter** フィールドで指定された値で置き換えます。

       このオプションは主に文字列に使用することを意図しており、実績を駆動するステータスに対して **Replace** 演算子を使用することは推奨されません。イベントは常に順番どおりに処理されるわけではないため、この演算子によって実績が永久に解除されない可能性があります。代わりに **SUM** 演算子を使用してください。

       このため、**Replace** オプションが使用されると、対応するステータス ルールは Partner Center UI で *Deprecated* とマークされます。

   * **パラメーター**
     **Operator** フィールドで選択された演算子で使用する値を指定します。

     * 指定した静的な数値を使用したい場合、**literal** オプション ボタンを選択し、オプション ボタンの後のボックスに値を指定します。

     * フィールドの値を使用したい場合、**field** オプション ボタンを選択し、オプション ボタンの後のドロップダウン リストで、使用したいフィールドを選択します。

   * **実績や注目統計などの他の機能がこの情報にアクセスするのを制限する。**
     ステータス ルールを非公開にするには、このチェックボックスをオンにします。

   * **このステータスの変更はサーバー イベントからのみ許可する。クライアント イベントは無視されます。**
     ステータス ルールが、コンソールまたは PC で実行されているゲーム クライアントからではなく、サーバー間 API を介して送信されるイベントによってのみトリガーされることを示すには、このチェックボックスをオンにします。

新しいステータス ルールは、ルールのイベントが選択されるたびに **Events & Stat Rules** ページに表示されるようになります。

[このトピックの先頭に戻る。](#top)

## 既存のステータス ルールの変更

> [!NOTE]
>
> タイトルが Final Certification を通過した後は、そのタイトルのイベントの既存のステータス ルールを変更または削除することはできません。

1. 製品インスタンスの **Events and stat rules** ページの **Stat rules** 列で、変更したいステータス ルールを選択します。

2. イベントの **Update stat rule** ダイアログで変更を加えます。

3. **Save** を選択します。

[このトピックの先頭に戻る。](#top)

## ステータス ルールの編集

ステータス ルールの編集は、ステータス ルールの名前やイベント フィールドが削除、追加、または並べ替えられたときに行われます。
この操作は、ステータス ルールの削除と新しいステータス ルールの作成として扱われます。この定義に従って、編集の一部としてすべてのステータス インスタンスが削除されます。

[このトピックの先頭に戻る。](#top)

## 既存のステータス ルールのコピー

> [!NOTE]
>
> タイトルが Final Certification を通過した後は、そのタイトルのイベントの既存のステータス ルールを変更または削除することはできません。

1. 製品インスタンスの **Events and stat rules** ページで、削除したいステータス ルールを含む行を見つけます。

2. その行の **Actions** 列で **Copy** を選択します。

3. イベントの **Update stat rule** ダイアログで変更を加えます。

4. **Save** を選択します。

[このトピックの先頭に戻る。](#top)

## 既存のステータス ルールの削除

> [!NOTE]
>
> * タイトルが Final Certification を通過した後は、そのタイトルのイベントの既存のステータス ルールを変更または削除することはできません。
>
> * ステータス ルールの削除は永続的な操作であり、元に戻したり取り消したりすることはできません。
>
> * ステータス ルールを削除すると、そのステータス ルールが持つ可能性のあるチェーン依存関係もすべて削除されます。ステータス ルールを削除する前に、その依存関係もすべて削除してよいことを確認してください。

1. 製品インスタンスの **Events and stat rules** ページで、削除したいステータス ルールを含む行を見つけます。

2. その行の **Actions** 列で **Delete** を選択します。

3. **Confirmation** ダイアログで **Delete** を選択します。

次の図は、ステータス イベント ルールの削除がそのルールへの依存関係も削除することを示しています。

![ステータス ルールの削除がそのルールへの依存関係を削除することを示す図の画像。](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/event_delete_dependency.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=c62fbfb172b5b3ea07af12d6aca27bf6)

[このトピックの先頭に戻る。](#top)


## Related topics

- [イベント ベースの統計とリーダーボードのポータル構成 (目次)](/ja-jp/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-statslb-eb-config-nav.md)
- [ステータス変更通知のポータル構成](/ja-jp/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stat-change-notif-portal.md)
- [注目の統計のポータル構成 (目次)](/ja-jp/services/xbox-services/player-data/stats-leaderboards/featured-stats/config/live-featured-stats-config-nav.md)
- [イベント ベースのチャレンジのポータル構成](/ja-jp/services/xbox-services/player-data/achievements/event-based/config/live-challenges-eb-portal.md)
- [イベント ベースの注目の統計のポータル設定](/ja-jp/services/xbox-services/player-data/stats-leaderboards/featured-stats/config/live-featuredstats-eb-portal.md)