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

# 統計情報のクイックスタート

> PlayFab Statistics クイックスタートでは、統計情報を定義し、プレイヤーの値を書き込み、SDK を使用して結果を読み取ることで進捗トラッキングをブートストラップする方法を示します。

# 統計情報のクイックスタート

このガイドでは、Statistics サービス用の開発環境をセットアップする方法を説明します。また、[Game Manager](https://developer.playfab.com) のウェブサイトから素早くリーダーボードを作成する方法についても学びます。

## 前提条件

PlayFab Statistics サービスを使用するには、PlayFab アカウントが必要です。アカウントの作成手順については、[認証](/services/playfab/identity/dev-identity/authentication/aad-authentication)を参照してください。

## 統計情報の作成

左側のメニューから Progression を選択します。

<img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/player-progression/statistics/game-manager-main-menu.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=f8afb627f579da6ba1f9677d3296a3ee" alt="PlayFab Statistics main menu" width="1280" height="900" data-path="images/playfab/player-progression/statistics/game-manager-main-menu.png" />

次に、上部メニューから Statistics タブを選択します。

<img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/player-progression/statistics/statistic-menu.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=78393c583a8ff1afaf920b9bde60eaa7" alt="PlayFab Statistics add statistic" width="1280" height="900" data-path="images/playfab/player-progression/statistics/statistic-menu.png" />

その後、「New Statistic」ボタンをクリックして、統計情報の定義を作成します。

<img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/player-progression/statistics/new-statistic.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=16b828e676d1bede541bcb9331dbe133" alt="PlayFab Statistics Usage" width="1239" height="888" data-path="images/playfab/player-progression/statistics/new-statistic.png" />

ここでは、統計情報のあらゆる側面を設定できます。利用可能なパラメーターと統計情報の作成方法の詳細については、こちらをご覧ください。

* [基本的なリーダーボードを作成する](/services/playfab/player-progression/statistics/create-basic-statistics)
* [API リファレンス](/services/playfab/player-progression/statistics/api-reference)

最終結果は以下のようになるはずです。

<img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/player-progression/statistics/stat-result.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=1c145637328915af6a2a81ef56ecccd8" alt="PlayFab Statistics final result" width="1872" height="822" data-path="images/playfab/player-progression/statistics/stat-result.png" />

## 環境のセットアップ

ここでは、C# SDK を使用するための開発者環境のセットアップ方法を学びますが、ここで提示する概念は他の SDK や単純な HTTP リクエストでも機能します。

## TitleId と DeveloperSecretKey の設定

Title Entity として認証する際に DeveloperSecretKey が必要です。

```C# theme={null}
PlayFabSettings.staticSettings.TitleId = ""; // Change this value to your own titleId from PlayFab Game Manager
PlayFabSettings.staticSettings.DeveloperSecretKey = ""; // Change this to your title's secret key from Game Manager
```

## タイトルの作成とシークレットキーの取得

* [https://developer.playfab.com/](https://developer.playfab.com/) にログインする
* タイトルを作成する
  * settings の下の API Features セクションで Title ID を見つけます。
* シークレットキーを生成する:
  * タイトルビューの左上のタイトル名の横にある歯車アイコン
  * Title Settings
  * Secret Keys
  * New secret key

Game Manager 内で Secret Key セクションを見つけたときの UI の外観は次のとおりです。

<img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/player-progression/statistics/secret-keys.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=864e20d34e00d5eb96b9a392c7cc8e0b" alt="PlayFab Statistics keys" width="2541" height="1152" data-path="images/playfab/player-progression/statistics/secret-keys.png" />

## Title としてログイン

書き込み操作については、ゲームサーバーから TitleEntity を使用することをお勧めします。このメソッドは、行うすべてのリクエストで使用される `AuthenticationContext` を返します。

```C# theme={null}
public static async Task<PlayFabAuthenticationContext> LoginAsTitleEntity()
{
    GetEntityTokenRequest request = new GetEntityTokenRequest()
    {
        Entity = new PlayFab.AuthenticationModels.EntityKey()
        {
            Id = PlayFabSettings.staticSettings.TitleId,
            Type = "title",
        },                
    };

    PlayFabResult<GetEntityTokenResponse> entityTokenResult = await PlayFabAuthenticationAPI.GetEntityTokenAsync(request);

    PlayFabAuthenticationContext authContext = new PlayFabAuthenticationContext
    {
        EntityToken = entityTokenResult.Result.EntityToken
    };
    
    return authContext;
}
```

## Player としてログイン (Player の作成)

PlayFab API に対して直接読み取り操作を行うには、プレイヤーとしてログインします。このメソッドは、行うすべてのリクエストで使用される `AuthenticationContext` を返します。

```C# theme={null}
private static async Task<PlayFabAuthenticationContext> LoginAsPlayer(string customId = "GettingStartedGuide")
{
    LoginWithCustomIDRequest request = new LoginWithCustomIDRequest { CustomId = customId, CreateAccount = true };

    PlayFabResult<LoginResult> loginResult = await PlayFabClientAPI.LoginWithCustomIDAsync(request);

    return loginResult.Result.AuthenticationContext;
}

```

## エンティティの表示名プロパティを設定する

Get Statistics API の応答の一部として `DisplayName` プロパティを使用できるようにするには、作成した各エンティティに対して以下のコードを実行する必要があります。このプロセスは、エンティティをゲームのカスタム表示名にマッピングします。

```C# theme={null}
private static async Task UpdateEntityDisplayName(PlayFabAuthenticationContext context, string customId)
{
    SetDisplayNameRequest request = new SetDisplayNameRequest()
    {
        AuthenticationContext = context,
        DisplayName = customId,
        Entity = new PlayFab.ProfilesModels.EntityKey()
        {
            Id = context.EntityId,
            Type = context.EntityType,
        },
    };

    PlayFabResult<SetDisplayNameResponse> updateNameResult = await PlayFabProfilesAPI.SetDisplayNameAsync(request);

}
```

## 関連項目

* [基本的な統計情報を作成する](/services/playfab/player-progression/statistics/create-basic-statistics)
* [統計情報でさらに多くのことを行う](/services/playfab/player-progression/statistics/doing-more-statistics)
* [シーズナル統計情報](/services/playfab/player-progression/statistics/seasonal-statistics)
* [統計情報にコンテキストデータを追加する](/services/playfab/player-progression/statistics/metadata-statistics)
* [トランザクション書き込み](/services/playfab/player-progression/statistics/transactional-writes)
* [API リファレンス](/services/playfab/player-progression/statistics/api-reference)
* [制限](/services/playfab/player-progression/statistics/limits-statistics)
* [クォータ](/services/playfab/player-progression/statistics/quota-statistics)
* [統計情報メーター](/services/playfab/pricing/meters/statistics-meters)


## Related topics

- [基本的な統計情報を作成する](/ja-jp/services/playfab/player-progression/statistics/create-basic-statistics.md)
- [プレイヤー インベントリのクイックスタート](/ja-jp/services/playfab/economy-monetization/economy-v2/inventory/quickstart.md)
- [トーナメントとリーダーボードのクイックスタート](/ja-jp/services/playfab/community/leaderboards/tournaments-leaderboards/quickstart.md)
- [Game Manager クイックスタート](/ja-jp/services/playfab/live-service-management/gamemanager/quickstart.md)
- [アイテム (レガシー Economy) のクイックスタート](/ja-jp/services/playfab/economy-monetization/economy/items/quickstart.md)
