イベントに基づく統計ルールの概要

このトピックでは、ユーザー統計ルールのしくみについて説明します。これは、タイトルで管理される統計ではなく、イベントに基づく統計に使用されます。

統計ルールはそれぞれ 4 つの部分で構成されます。

イベント

統計ルールはそれぞれ、タイトルによって記録される特定のイベント名によってトリガーされます。 1 つのイベントによって複数の統計ルールがトリガーされる場合があることに注意してください。

ルール名には "ルート" 名が含まれており、必要に応じて 1 つ以上の "フィールド" が続きます。
ルート は英数字の文字列で、最大 32 文字を使用できます。
統計インスタンス名の長さの合計は 128 文字を超えないようにする必要があります。
名前は先頭が英字でなければならず、使用できるのは英字、数字、およびハイフン (-) だけです。スペース、コンマ、ピリオド、アンダースコア、またはその他の特殊文字は使用できません。たとえば、"EnemiesDefeated"、"BestScoreUnder2Minutes"、"Total-Collectibles-Jewels" を名前として使用できます。
フィールドは、ドット (.) 文字で区切られます。
フィールド名は、プロデューサーイベントの一部であるフィールド名と完全に一致する必要があります。

Important

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

有効なテンプレート名の例としては、"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 文字列の場合は、そのフィールドに設定される可能性のある値に (前述した) 有効な文字のみが含まれることを確認する必要があります。

統計インスタンスの値は、プロデューサーイベントの処理中、実行時に計算されます。統計ルールによって、指定されたパラメーターで操作が実行されます。サポートされる操作オプションを次に示します。

次の表に示すように、パラメーターには、定数値または生成イベントからのフィールド名のいずれかを使用できます。

結果の成績インスタンスのデータ型は、パラメーターのデータ型によって決まります。

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

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

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

統計データの種類	パラメーターのデータ型	注意
Integer	Int32、Int64、UInt32、UInt64、Boolean	サポートされている最大の整数は 56 ビットです。ブール値は、`TRUE` は 1 に、`FALSE` は 0 に変換されます。
Float	Float、Double	64 ビット浮動小数点。
String	UnicodeString、GUID	文字列の最大長は 50 文字です。