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

# Statistics メーター

> PlayFab Statistics の課金メーターの仕組み、測定される読み取り/書き込み、および Statistics の使用が請求にどのように反映されるかを学びます。

Statistics メーターは 3 つのカテゴリに分かれています。

## Statistics Reads

ランク付けの有無にかかわらず、エンティティの統計を読み取ると Statistics Read メーターが 1 回インクリメントされます。このインクリメントは、エンティティの単一または複数の統計を要求した場合の両方で発生します。

このメーターをインクリメントする API の一覧は次のとおりです。

| API 名                    | API リファレンス                                                                                                                                    |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
| GetStatistics            | [Get Statistics](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/statistics/get-statistics)                           |
| GetStatisticsForEntities | [Get Statistics For Entities](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/statistics/get-statistics-for-entities) |

## Statistics Writes

ランク付けの有無にかかわらず、エンティティの統計を更新すると Statistics Write メーターが 1 回インクリメントされます。このインクリメントは、エンティティの 1 つまたは複数の (バッチ化した) 統計を更新した場合の両方で発生します。

リーダーボード上でランク付けされている場合、Statistic Writes は (Statistic Writes メーターに加えて) Leaderboard Write メーターにもインクリメントを発生させます。インクリメントの回数はリクエスト内のランク付き統計の数に依存します。リクエスト内の統計定義数を N (1 つの場合もあります)、そのセット内のランク付き統計数を M とすると、Leaderboard Writes メーターは M 回インクリメントされます。

Community Statistics では、ソース統計への書き込みが 1 つ以上の集計先に対してもインクリメントを発生させます。インクリメントの回数はソース統計の集計先の数に依存します。一般に 1 + N で、N は集計先の数です。たとえば、プレイヤーごとの統計がタイトル レベルの単一統計に集計される場合、プレイヤーへの各更新は Statistic Writes メーターを 2 回インクリメント (プレイヤー用に 1 回、タイトル レベルの集計用にもう 1 回) します。

このメーターをインクリメントする API の一覧は次のとおりです。

| API 名            | API リファレンス                                                                                                                |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------- |
| UpdateStatistics | [Update Statistics](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/statistics/update-statistics) |

## Transactional Writes

Transactional Write メーターは Statistics Writes メーターの別の派生で、同じ条件で動作しますが、リクエストをトランザクションとして扱う機能が追加されており、各リクエストが 1 回のみ実行されることを保証します。

このメーターはこの API に限られ、クライアントのトランザクション ID を示す特別なパラメーターが必要です。このパラメーターを指定すると、Transactional Write メーターが有効になります。

| API 名            | API リファレンス                                                                                                                |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------- |
| UpdateStatistics | [Update Statistics](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/statistics/update-statistics) |

## Statistics Storage

このメーターは、サービスに保存されている統計データの量を追跡します。

各エンティティ統計について、統計のバージョンごとに消費されるストレージは以下の要素の合計として計算されます。

* Scores: スコア リストの長さと `sizeof(long)` の積。
* Metadata: フィールドの長さ。
* Timestamp: `sizeof(long)`。
* エンティティ ID の長さ。

## 関連項目

* [Leaderboards メーター](/services/playfab/pricing/meters/leaderboard-meters)


## Related topics

- [Leaderboards メーター](/ja-jp/services/playfab/pricing/meters/leaderboard-meters.md)
- [PFStatisticsGetStatisticsGetResult](/ja-jp/services/playfab/api-references/c/pfstatistics/functions/pfstatisticsgetstatisticsgetresult.md)
- [PFStatisticsDeleteStatisticsGetResult](/ja-jp/services/playfab/api-references/c/pfstatistics/functions/pfstatisticsdeletestatisticsgetresult.md)
- [PFStatisticsUpdateStatisticsGetResult](/ja-jp/services/playfab/api-references/c/pfstatistics/functions/pfstatisticsupdatestatisticsgetresult.md)
- [XblUserStatisticsTrackStatistics](/ja-jp/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticstrackstatistics.md)