> ## 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 統計と統計ルールを構成する

> Partner Center で data platform 2013 の統計ルールを追加および変更し、タイトルが XBOX サービスにイベントを送信した際にプレイヤー統計が更新されるようにします。

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

XBOX サービス構成の概要については、[Service configuration](/services/xbox-services/fundamentals/portal-config/live-service-config-ids-mp) を参照してください。Data Platform 2013 の概要については、XDK トピック **How the XBOX Live data platform 2013 works** を参照してください。

<a id="ID4EMB" />

## 統計ルールとは？

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

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

* 難易度ハードでショットガンで倒したゾンビの総数
* 試合で倒した敵の最高数
* レースを完走する最速タイム
* 最も最近運転した車の名前

プレイヤー統計は、プレイヤーのゲームハブ UI にフィーチャードまたはヒーロー統計として表示したり、リーダーボードに表示したり、実績のアンロックに使用したりできます。

個々の統計ルールは、以下のいずれかを生成するように構成できます:

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

統計と統計ルールについては、XDK ドキュメントの以下のトピックを参照してください。

* **User Stats for Data Platform 2013**
* **User Stat Rules**
* **User Stats Scenarios**

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

<img src="https://mintcdn.com/microsoft-4404708b/66WJ_HwgXG1cFJFn/publishing/game-publishing/how-to/data-platform-2013/media/dataplatformtaxonomy-documentation-01-event_to_stat.jpg?fit=max&auto=format&n=66WJ_HwgXG1cFJFn&q=85&s=b981fb7b2e9b8f7e613b91515ffdf747" alt="イベントフロー" width="1280" height="720" data-path="publishing/game-publishing/how-to/data-platform-2013/media/dataplatformtaxonomy-documentation-01-event_to_stat.jpg" />

<a id="ID4ENC" />

## 統計ルールを構成する

<Steps>
  <Step title="[Partner Center](https://developer.microsoft.com...) にアカウントでサインインします">
    [Partner Center](https://developer.microsoft.com/dashboard/windows/overview) にアカウントでサインインします。
  </Step>

  <Step title="タイトルを選択し、**Services** > **XBOX Live** に移動します。">
    タイトルを選択し、**Services** > **XBOX Live** に移動します。
  </Step>

  <Step title="**Stat rules** のリンクを選択します。">
    **Stat rules** のリンクを選択します。
  </Step>

  <Step title="**Events and stat rules** ページで、イベントおよびイベントに基づいた統計ルールを構成します...">
    **Events and stat rules** ページで、イベントおよびそれらのイベントに基づいた統計ルールを構成します。
  </Step>
</Steps>

統計ルールはイベントに基づくため、統計ルールを作成する前にイベントを作成する必要があります。詳細は [Partner Center で data platform 2013 用の XBOX Live イベントを構成する](/publishing/game-publishing/how-to/data-platform-2013/how-to-configure-events-2013) を参照してください。

<a id="ID4ELC" />

## 統計ルールを作成する

1. **Events & Stat Rules** ページで **New stat rule** を選択します。
2. **Add Stat Rule** ダイアログで、次のフィールドの値を指定します。
   * **Base event**<br />ドロップダウンリストで、この統計ルールをトリガーするベースイベントを選択します。
   * **Event fields added to the stat rule**
     * この任意フィールドで、統計ルールの一部としてベースイベントに含まれるフィールドを選択できます。
     * ドロップダウンリストで、統計ルールに追加するフィールドを選択します。この方法で複数のフィールドを追加できます。選択したフィールドは統計ルールのルート名に追加され、ドット文字で区切られます。
     * フィールドを削除するには、名前の横の X を選択します。
   * **Stat Rule Name**<br />統計ルールを特徴付け、覚えやすく認識しやすい名前を指定します。統計ルールの名前は *ルート* 名で構成され、必要に応じてドット文字で区切られた 1 つ以上の *フィールド* が続きます。統計ルール名の命名要件については、XDK トピック **User Stat Rules** を参照してください。
   * **Operator**<br />次のいずれかの演算子を選択します。
     * **Sum**<br />既存の統計値を **Parameter** フィールドで指定した値で増分します。
     * **Min**<br />既存の統計値と **Parameter** フィールドの値のうち最小値を使用します。
     * **Max**<br />既存の統計値と **Parameter** フィールドの値のうち最大値を使用します。
     * **Replace**<br />統計値を **Parameter** フィールドで指定した値で置き換えます。実績を駆動する統計に対しては **Replace** 演算子の使用は推奨しません。イベントは必ずしも順序どおりに処理されるとは限らないため、実績がアンロックされない原因になる場合があります。代わりに **SUM** 演算子を使用してください。
   * **Parameter**<br />**Operator** フィールドで選択した演算子で使用する値を指定します。
     * 指定する静的な数値を使用したい場合は、**literal** オプションを選択し、その下のボックスに値を指定します。
     * フィールドの値を使用したい場合は、**field** オプションを選択し、その下のドロップダウンリストで使用するフィールドを選択します。
   * **Restrict other features like achievements and featured stats from accessing this info.**<br />統計ルールを非公開にするには、このチェックボックスをオンにします。
   * **Only allow changes to this stat from a server event. Client events will be ignored.**<br />統計ルールが本体や PC で動作するゲームクライアントからではなく、サーバー間 API 経由で送信されたイベントによってのみトリガーされることを示すには、このチェックボックスをオンにします。
3. すべてのフィールドと値を構成した後、**Save** を選択してダイアログを閉じます。

新しい統計ルールは、ルールのイベントが選択されている場合に **Events & Stat Rules** ページに一覧表示されます。

<a id="ID4E2C" />

## 既存の統計ルールを変更する

<Warning>
  タイトルが Final Certification に合格した後、そのタイトル内のイベントの既存の統計ルールは変更または削除できなくなります。
</Warning>

1. 製品インスタンスの **Events and stat rules** ページの **Stat rules** 列で、変更したい統計ルールを選択します。
2. イベントの **Update stat rule** ダイアログで変更を行います。
3. **Save** を選択します。

<a id="ID4ELE" />

## 統計ルールを編集する

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

<a id="ID4EMS" />

## 既存の統計ルールをコピーする

<Warning>
  タイトルが Final Certification に合格した後、そのタイトル内のイベントの既存の統計ルールは変更または削除できなくなります。
</Warning>

1. 製品インスタンスの **Events and stat rules** ページで、削除したい統計ルールの行を見つけます。
2. その行の **Actions** 列で **Copy** を選択します。
3. イベントの **Update stat rule** ダイアログで変更を行います。
4. **Save** を選択します。

<a id="ID4EMF" />

## 既存の統計ルールを削除する

<Warning>
  * タイトルが Final Certification に合格した後、そのタイトル内のイベントの既存の統計ルールは変更または削除できなくなります。
  * 統計ルールの削除は永続的な操作で、元に戻したり取り消したりすることはできません。
  * 統計ルールを削除すると、それに連鎖する依存関係もすべて削除されます。統計ルールを削除する前に、その依存関係もすべて削除したいことを必ず確認してください。
</Warning>

1. 製品インスタンスの **Events and stat rules** ページで、削除したい統計ルールの行を見つけます。
2. その行の **Actions** 列で **Delete** を選択します。
3. **Confirmation** ダイアログで **Delete** を選択します。

<img src="https://mintcdn.com/microsoft-4404708b/66WJ_HwgXG1cFJFn/publishing/game-publishing/how-to/data-platform-2013/media/event_delete_dependency.png?fit=max&auto=format&n=66WJ_HwgXG1cFJFn&q=85&s=18f149e565417485187df9a2a9ae1fab" alt="イベント削除の依存関係" width="624" height="297" data-path="publishing/game-publishing/how-to/data-platform-2013/media/event_delete_dependency.png" />
