コミュニティ統計

コミュニティ統計は、エンゲージメントを高め、プレイヤーがゲームに深く関わるよう促す強力なツールです。ゲームタイトルレベルで統計を集計することで、開発者はプレイヤー間のコラボレーションを促す共通の目標や課題を作成できます。このアプローチは、個々のプレイヤーの行動をコミュニティ全体の目標への貢献に変え、プレイヤーが共に集団的なマイルストーンを達成しようとすることで、持続的なエンゲージメントを促進します。プレイヤーは自分の個々の貢献がより大きなコミュニティにとって重要だと感じ、ゲームや他のプレイヤーとのつながりが強まります。たとえば、全プレイヤーが 1 週間以内に合計 1,000 万エリミネーションを達成すると特別なゲーム内イベントがアンロックされる、グローバルなボスバトルを実装することを想像してください。プレイヤーは自分の貢献ごとにコミュニティのプログレスバーが進むのを見ることで、目標達成を助ける動機を得ます。この動きは、特にリアルタイムの進捗更新やマイルストーン報酬と組み合わさると、投資と参加の強力なフィードバックループを生み出します。 PlayFab では、次の 2 つの統計を定義することでコミュニティ統計を簡単に管理できます: 1 つはプレイヤーレベルの統計 (集計元)、もう 1 つはタイトルまたはグループレベルの統計 (集計先) です。プレイヤー統計への更新は、自動的に集計先の統計に反映されます。現在のコミュニティスコアを取得するには、集計先エンティティの統計を読み取ります。 PlayFab は 2 種類のコミュニティ統計をサポートします:

Title-level: すべてのプレイヤーの更新をタイトル全体の 1 つの統計に集計します。プレイヤーベース全体で共有するグローバル目標に最適です。
Group-level: プレイヤーの更新をグループエンティティ統計に集計します。共有目標に向けてプレイヤーの一部が取り組む、クランチャレンジ、ギルド目標、チームベースの目標に最適です。

タイトルレベルのコミュニティ統計

集計元となる統計定義の作成

まず、集計元として機能するプレイヤー用の統計定義を作成します:

// Use the PlayFabAuthenticationContext to call the API
PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);
CreateStatisticDefinitionRequest statDefinitionRequest = new CreateStatisticDefinitionRequest()
{
    Name = "sourceStat",
    AuthenticationContext = context,
    EntityType = "title_player_account",
    VersionConfiguration = new VersionConfiguration()
    {
        MaxQueryableVersions = 1,
        ResetInterval = ResetInterval.Manual,
    },
    Columns = new List<StatisticColumn>()
    {
        new StatisticColumn()
        {
            Name = "Eliminations",
            AggregationMethod = StatisticAggregationMethod.Sum,
        },
    },
};

PlayFabResult<PlayFab.LeaderboardsModels.EmptyResponse> createStatDefResult = await statsAPI.CreateStatisticDefinitionAsync(statDefinitionRequest);

集計先となる統計定義の作成

次に、集計先として機能するタイトル用の統計定義を作成します。タイトル統計定義の集計元として、プレイヤー統計定義を指定します:

// Use the PlayFabAuthenticationContext to call the API
PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);
CreateStatisticDefinitionRequest statDefinitionRequest = new CreateStatisticDefinitionRequest()
{
    Name = "communityStat",
    AuthenticationContext = context,
    EntityType = "title",
    Columns = new List<StatisticColumn>()
    {
        new StatisticColumn()
        {
            Name = "Eliminations",
            AggregationMethod = StatisticAggregationMethod.Sum,
        },
    },
    AggregationSources = new string[] { "sourceStat" };
};

PlayFabResult<PlayFab.LeaderboardsModels.EmptyResponse> createStatDefResult = await statsAPI.CreateStatisticDefinitionAsync(statDefinitionRequest);

NOTE: 次のように設定してください

EntityType を title に設定し、AggregationSources にプレイヤーレベルで定義した統計を参照させます。コミュニティ統計を作成すると、プレイヤーレベルで行われた更新はタイトルレベルで集計され始めます。集計されるのは新しい更新のみです。集計元の統計がしばらく前から存在していても、システムはそれらの過去の値をタイトルレベルにバックフィルしません。

タイトルコミュニティ統計の読み取り

タイトルレベルの統計の現在のスコアを取得するには、タイトルエンティティの統計を読み取ります:

// Use the PlayFabAuthenticationContext to call the API
PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);

GetStatisticsRequest request = new GetStatisticsRequest()
{
    AuthenticationContext = context,
    Entity = new PlayFab.LeaderboardsModels.EntityKey()
    {
        Id = "<title id in hex>",
        Type = "title"
    },
};

PlayFabResult<GetStatisticsResponse> result = await statsAPI.GetStatisticsAsync(request); 

グループレベルのコミュニティ統計

グループレベルのコミュニティ統計を使うと、クランやギルドといった特定のグループ内でプレイヤーの行動を集計できます。この集計は、メンバーが共通の目標に向けて協力するクランチャレンジのようなシナリオで役立ちます。

集計先となる統計定義の作成

EntityType を group に設定した統計定義を作成します。集計元にはプレイヤー統計定義を指定します:

// Use the PlayFabAuthenticationContext to call the API
PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);
CreateStatisticDefinitionRequest statDefinitionRequest = new CreateStatisticDefinitionRequest()
{
    Name = "groupCommunityStat",
    AuthenticationContext = context,
    EntityType = "group",
    Columns = new List<StatisticColumn>()
    {
        new StatisticColumn()
        {
            Name = "Eliminations",
            AggregationMethod = StatisticAggregationMethod.Sum,
        },
    },
    AggregationSources = new string[] { "sourceStat" }
};

PlayFabResult<PlayFab.LeaderboardsModels.EmptyResponse> createStatDefResult = await statsAPI.CreateStatisticDefinitionAsync(statDefinitionRequest);

集計元の統計定義 (プレイヤーレベル) は、タイトルレベルのコミュニティ統計で使用したものと同じです。既存の集計元統計定義を再利用できます。

集計元統計の更新

グループレベルの集計のためにプレイヤーの集計元統計を更新するときは、StatisticUpdate オブジェクトの AggregationTargetEntityKeys プロパティに対象のグループエンティティを指定します。このプロパティは、更新をどのグループエンティティに集計するかを PlayFab に伝えます。

// Use the PlayFabAuthenticationContext to call the API
PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);

UpdateStatisticsRequest request = new UpdateStatisticsRequest()
{
    AuthenticationContext = context,
    Entity = new PlayFab.LeaderboardsModels.EntityKey()
    {
        Id = "<player entity id>",
        Type = "title_player_account"
    },
    Statistics = new List<StatisticUpdate>()
    {
        new StatisticUpdate()
        {
            Name = "sourceStat",
            Scores = new List<string> { "5" },
            AggregationTargetEntityKeys = new List<PlayFab.LeaderboardsModels.EntityKey>()
            {
                new PlayFab.LeaderboardsModels.EntityKey()
                {
                    Id = "<group entity id>",
                    Type = "group"
                }
            }
        }
    }
};

PlayFabResult<UpdateStatisticsResponse> result = await statsAPI.UpdateStatisticsAsync(request);

タイトルレベルのコミュニティ統計では、タイトルが既定の集計対象であるため AggregationTargetEntityKeys は必須ではありません。グループレベルのコミュニティ統計では、グループエンティティキーを指定する必要があります。現時点で、AggregationTargetEntityKeys に指定できるエンティティキーは 1 つだけです。

グループコミュニティ統計の読み取り

グループコミュニティ統計の現在のスコアを取得するには、グループエンティティの統計を読み取ります:

// Use the PlayFabAuthenticationContext to call the API
PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);

GetStatisticsRequest request = new GetStatisticsRequest()
{
    AuthenticationContext = context,
    Entity = new PlayFab.LeaderboardsModels.EntityKey()
    {
        Id = "<group entity id>",
        Type = "group"
    },
};

PlayFabResult<GetStatisticsResponse> result = await statsAPI.GetStatisticsAsync(request);

制限事項

コミュニティ統計に指定できる集計元は 1 つだけです。
コミュニティ統計にはバージョン構成を指定できません。集計元統計に指定したバージョン構成がコミュニティ統計にも適用されます。
コミュニティ統計の EntityType は title または group である必要があります。
いずれの列にも Last 集計を使用できません。
集計元統計を更新する際に AggregationTargetEntityKeys に指定できるエンティティキーは 1 つだけです。

XBOX Services

PlayFab

タイトルレベルのコミュニティ統計

集計元となる統計定義の作成

集計先となる統計定義の作成

タイトルコミュニティ統計の読み取り

グループレベルのコミュニティ統計

集計先となる統計定義の作成

集計元統計の更新

グループコミュニティ統計の読み取り

制限事項

関連項目

​タイトルレベルのコミュニティ統計

​集計元となる統計定義の作成

​集計先となる統計定義の作成

​タイトルコミュニティ統計の読み取り

​グループレベルのコミュニティ統計

​集計先となる統計定義の作成

​集計元統計の更新

​グループコミュニティ統計の読み取り

​制限事項

​関連項目

タイトルレベルのコミュニティ統計

集計元となる統計定義の作成

集計先となる統計定義の作成

タイトルコミュニティ統計の読み取り

グループレベルのコミュニティ統計

集計先となる統計定義の作成

集計元統計の更新

グループコミュニティ統計の読み取り

制限事項

関連項目