> ## 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.

# イベント ベースの統計ルールの概要

> プロデューサー イベント、名前付け、演算子、パラメーター、プレイヤー統計用の統計テンプレートを含む、イベント ベースの XBOX Live ユーザー統計ルールの仕組み。

このトピックでは、ユーザー統計ルールの仕組みについて説明します。これらはイベント ベースの統計に使用されるものであり、タイトル管理の統計には使用されません。

各統計ルールは 4 つの部分から構成されます。

* プロデューサー イベント
* 名前
* 演算子
* パラメーター

## イベント

各統計ルールは、タイトルによってログに記録される特定のイベント名によってトリガーされます。単一のイベントによって複数の統計ルールをトリガーできることに注意してください。

## 名前付けの要件

* ルール名には "ルート" 名があります。オプションで、1 つ以上の "フィールド" が続きます。

* *ルート* は英数字の文字列です。最大 32 文字まで指定できます。

* 統計インスタンス名の合計長は 128 文字を超えてはなりません。

* 名前は英字で始まる必要があり、英字、数字、およびハイフン (-) 文字のみを含めることができます。スペース、コンマ、ピリオド、アンダースコア、その他の特殊文字は許可されません。名前の例として、"EnemiesDefeated"、"BestScoreUnder2Minutes"、"Total-Collectibles-Jewels" などがあります。

* フィールドはドット (.) 文字で区切られます。

* フィールド名は、プロデューサー イベントの一部であるフィールド名と正確に一致する必要があります。

<Info>統計ルール名の一部として 1 つ以上のフィールドが含まれている場合、そのルールは統計テンプレートになります。実行時に、プロデューサー イベントからのフィールドの実際の値が統計インスタンス名に挿入されます。</Info>

* 有効なテンプレート名の例として、"EnemiesDefeated.WeaponID"、"BestScoreUnder2Minutes.TrackId.DifficultyID"、"Total-Collectibles-Jewels.Found" などがあります。

* 有効なインスタンス名の例として、"EnemiesDefeated.WeaponID.17"、"BestScoreUnder2Minutes.TrackId.40.DifficultyID.Insane"、"Total-Collectibles-Jewels.Found.1" などがあります。

## データ型の推奨事項

* 統計テンプレート名の一部となるイベント フィールドには、整数データ型を使用することをお勧めします。

* イベント フィールドのデータ型がブール値の場合、挿入される値は `true` の場合は "1"、`false` の場合は "0" になります。

* イベント フィールドのデータ型が Unicode 文字列の場合は、そのフィールドで可能な値に (前述したような) 有効な文字のみが含まれるようにする必要があります。

## 演算子

統計インスタンスの値は、プロデューサー イベントが処理されるときに実行時に計算されます。統計ルールは、指定された *パラメーター* を使用して *演算* を実行します。サポートされている演算オプションは以下のとおりです。

* `SUM`
* `MAX`
* `MIN`
* `REPLACE`

## パラメーター

パラメーターは、次の表に示すように、定数値またはプロデュース イベントのフィールド名のいずれかです。

| 演算子       | パラメーター     |
| --------- | ---------- |
| `SUM`     | 定数またはフィールド |
| `MIN`     | フィールド      |
| `MAX`     | フィールド      |
| `REPLACE` | 定数またはフィールド |

結果となる統計インスタンスのデータ型は、パラメーターのデータ型によって決まります。

整数、浮動小数点、およびブール値のデータ型は、すべての演算子でサポートされています。

Unicode 文字列データ型は、`REPLACE` 演算子でのみサポートされています。

統計とパラメーターのデータ型を次の表に示します。

\| 統計データ型 | パラメーター データ型 | 備考 |
\| --- | --- |
\| 整数 | Int32、Int64、UInt32、UInt64、Boolean | サポートされる最大の整数値は 56 ビットです。ブール値は `TRUE` から 1 に、`FALSE` から 0 に変換されます。 |
\| 浮動小数点 | Float、Double | 64 ビット浮動小数点。 |
\| 文字列 | UnicodeString、GUID | 文字列の最大長は 50 文字です。 |


## Related topics

- [イベントベースの統計の概要](/ja-jp/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview.md)
- [イベントベースのリーダーボードの概要](/ja-jp/services/xbox-services/player-data/stats-leaderboards/event-based/live-leaderboards-eb-overview.md)
- [イベントベースの統計とリーダーボード](/ja-jp/services/xbox-services/player-data/stats-leaderboards/event-based/live-statslb-eb-nav.md)
- [イベントベースのプレイヤー データの概要](/ja-jp/services/xbox-services/player-data/stats-leaderboards/event-based/live-how-data-platform-works.md)
- [イベント ベースの実績の概要](/ja-jp/services/xbox-services/player-data/achievements/event-based/live-achievements-eb-overview.md)
