プレイヤーとゲーム全体のグローバル統計データを追跡する

Last updated on July 15, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要

この記事では、ゲームとプレイヤーのグローバル統計データを追跡するための統計設定の方法について説明します。

目標

統計設定の概要を説明する
ユーザー統計データとグローバル統計データの設定方法を説明する
AccelByte SDK を使用した統計データの利用方法(一括更新機能の活用方法を含む)を説明する

前提条件

以下へのアクセスが必要です:

AccelByte 管理者ポータル
AccelByte Unreal または Unity SDK
参考用の AccelByte 統計データ API ドキュメント

ユーザーおよびグローバル統計設定の作成

ユーザーの進行状況を一貫して追跡するための永続的な統計追跡機能を備えることは、ゲームにとって非常に重要です。

管理者ポータルで統計設定を作成するには、以下の手順に従います。

管理者ポータルのサイドバーで、Progression & Inventory > Statistics > Configurations に移動します。
Statistic Configuration ページで、Add Configuration ボタンをクリックします。Add New Configuration フォームが表示されます。
必要な情報を入力します:
- 許可された形式で Stat Code を入力し、後から統計データを識別しやすくするために Name も入力します。統計データに関する補足情報を記載したい場合は、任意で Description を入力できます。
- サーバー側での追加検証として、任意の Min. Value と Max. Value を入力し、ユーザーが許可された範囲を超えないようにできます。また、各ユーザーの統計データの初期値を決定する Default Value は必須項目のため、必ず入力してください。
統計機能を完全に活用するために設定できる追加の設定もあります。以下のフォームを参照してください。
- Increment を true に設定すると、統計値が減少しないようにできます。この機能は、ユーザーが特定のゲームメカニクスを不正に利用できないようにするためのサーバー側検証として機能します。
- すべての対象ユーザーからの統計データの グローバル 累積値を追跡するには、Set as Global を true に設定します。これにより、個々のユーザー統計データだけでなく、グローバル統計データに寄与するすべてのユーザーの累積値も追跡されます。
- Set By フィールドを Server に設定すると、統計データを更新できるのをゲームサーバーのみに制限する検証を追加できます。これにより、ユーザーがゲームクライアントから直接統計データを更新することは拒否されます。これは、チートやゲームクライアントの改ざんを防ぐ効果的な方法でもあります。
- ゲーム内で統計データをグループ化して整理しやすくするために、任意で統計データに tags を設定できます。

Game SDK または Extend SDK を使用した統計データの使用

管理者ポータルで統計データを設定したら、このセクションで紹介する例を参考に、SDK を使用して統計データを利用できます。

サーバー主導型の統計データ管理については、サーバー主導型プレイヤー統計の実装ガイドも参照してください。

統計データの更新

この更新機能はゲームクライアントから直接呼び出すことができ、ゲームサーバーを利用しないシングルプレイヤーやピアツーピアマルチプレイヤーなど、非競争的なジャンルに適しています。

以下の表に示すとおり、複数の更新戦略がサポートされています。

更新戦略	使用方法	実装例
OVERRIDE	更新時に、統計データの既存の値を最新の値で置き換えます	ELO や MMR など、独自の計算を行う場合に適しています。最新の値を渡すだけで、サービスがその値を保存します。
INCREMENT	渡した値が正(+)か負(-)かに応じて、既存の値に新しい値が加算または減算されます	バトルで獲得した経験値を追跡するのに適しています。獲得したポイントを直接渡すだけで、サービスが加算処理を行います。
MAX	渡した値が既存の値よりも高い場合にのみ統計データを更新します	キル数や与ダメージ量などの最高スコアを追跡するのに適しています。渡したスコアが既存のスコアよりも低い場合、サービスは更新を無視します。
MIN	渡した値が既存の値よりも低い場合にのみ統計データを更新します	最速のラップタイムや最短クリア時間などの最小スコアを追跡するのに適しています。渡したスコアが既存のスコアよりも高い場合、サービスは更新を無視します。

単一ユーザー統計データの更新

FApiClientPtr ApiClient = AccelByteOnlineSubsystemPtr->GetApiClient();

FString AdditionalKey = " Your additional key";
FString StatCode = " Your stat code ";

FAccelByteModelsPublicUpdateUserStatItem UserStatItem{};
UserStatItem.UpdateStrategy = EAccelByteStatisticUpdateStrategy::OVERRIDE;
UserStatItem.Value = 100.0f;

ApiClient->Statistic.UpdateUserStatItemsValue(StatCode
    , AdditionalKey
    , UserStatItem
    , THandler<FAccelByteModelsUpdateUserStatItemValueResponse>::CreateLambda([](FAccelByteModelsUpdateUserStatItemValueResponse Result)
     {
      // Do something if UpdateUserStatItemsValue is successful
     })
    , FErrorHandler::CreateLambda([](int32 ErrorCode, FString ErrorMessage)
     {
      // Do something if UpdateUserStatItemsValue has an error
     }));

Statistic statistic = AccelByteSDK.GetClientRegistry().GetApi().GetStatistic();

string additionalKey = " Your additional key";
string statCode = " Your stat code ";

PublicUpdateUserStatItem userStatItem = new PublicUpdateUserStatItem
{
    updateStrategy = StatisticUpdateStrategy.OVERRIDE,
    value = 100
};

statistic.UpdateUserStatItemsValue(statCode, additionalKey, userStatItem, result =>
{
    if (result.IsError)
    {
        // Do something if UpdateUserStatItemsValue an error
        Debug.Log($"Error UpdateUserStatItemsValue, Error Code: {result.Error.Code} Error Message: {result.Error.Message}");
        return;
    }
    
    // Do something if UpdateUserStatItemsValue is successful
});

string additionalKey = "Your additional key";
string statCode = "Your stat code";
string userId = "<user-id>";

var response = sdk.Social.UserStatistic.UpdateUserStatItemValueOp
    .SetAdditionalKey(additionalKey)
    .SetBody(new StatItemUpdate()
    {
        UpdateStrategy = StatItemUpdateUpdateStrategy.OVERRIDE,
        Value = 100
    })
    .Execute(sdk.Namespace, statCode, userId);
if (response != null)
{
    //do something if success
}

userStatisticService := &social.UserStatisticService{
    Client:          factory.NewSocialClient(&repository.ConfigRepositoryImpl{}),
    TokenRepository: &repository.TokenRepositoryImpl{},
}
namespace := "mygame"
statCode := "mystatcode"
userId := "myuserid"
updateStrategy := socialclientmodels.StatItemUpdateUpdateStrategyOVERRIDE
value := float64(100)
body := socialclientmodels.StatItemUpdate {
    UpdateStrategy: &updateStrategy,
    Value: &value,
}
additionalKey := "myadditionalkey"
input := &user_statistic.UpdateUserStatItemValueParams{
    Body:          &body,
    Namespace:     namespace,
    StatCode:      statCode,
    UserID:        userId,
    AdditionalKey: &additionalKey,
}
result, err := userStatisticService.UpdateUserStatItemValueShort(input)

UserStatistic userStatisticWrapper = new UserStatistic(sdk);

String additionalKey = "Your additional key";
String statCode = "Your stat code";
String userId = "<user-id>";
StatItemIncResult response;
try {
    StatItemUpdate reqBody = StatItemUpdate.builder()
        .updateStrategy(StatItemUpdate.UpdateStrategy.OVERRIDE.toString())
        .value(100f)
        .build();
    response = userStatisticWrapper.updateUserStatItemValue(UpdateUserStatItemValue.builder()
        .namespace("<namespace>")
        .userId(userId)
        .statCode(statCode)
        .additionalKey(additionalKey)
        .body(reqBody)
        .build());
        } catch (Exception e) {
    // Do something when failed
    return;
}

if (response == null) {
    // Null response from server
} else {
    //do something if success
}

import accelbyte_py_sdk.api.social as social_service
import accelbyte_py_sdk.api.social.models as social_models

result, error = social_service.update_user_stat_item_value_1(
    body=social_models.StatItemUpdate()
        .with_update_strategy("OVERRIDE")
        .with_value(100.0)
    stat_code="YourStatCode",
    additional_key="YourAdditionalKey",
    user_id="********************************",
    namespace=namespace,  # optional, gets the value from the global instance if unspecified
    sdk=sdk,  # optional, gets the global instance  if unspecified
)
if error:
    exit(error)

1人のユーザーの複数の統計データを更新

FApiClientPtr ApiClient = AccelByteOnlineSubsystemPtr->GetApiClient();

FString AdditionalKey = " Your additional key";

FAccelByteModelsUpdateUserStatItemWithStatCode UserStatItem1{};
UserStatItem.StatCode = " Your 1st stat code "; 
UserStatItem.UpdateStrategy = EAccelByteStatisticUpdateStrategy::OVERRIDE;
UserStatItem.Value = 100.0f;

FAccelByteModelsUpdateUserStatItemWithStatCode UserStatItem2{};
UserStatItem.StatCode = " Your 2nd stat code "; 
UserStatItem.UpdateStrategy = EAccelByteStatisticUpdateStrategy::INCREMENT;
UserStatItem.Value = 50.0f;

TArray<FAccelByteModelsUpdateUserStatItemWithStatCode> BulkUpdateUserStatItems = { UserStatItem1, UserStatItem2 };

ApiClient->Statistic.BulkUpdateUserStatItemsValue(AdditionalKey
    , BulkUpdateUserStatItems
    , THandler<TArray<FAccelByteModelsUpdateUserStatItemsResponse>>::CreateLambda([](TArray<FAccelByteModelsUpdateUserStatItemsResponse> Result)
     {
      // Do something if BulkUpdateUserStatItemsValue is successful
     })
    , FErrorHandler::CreateLambda([](int32 ErrorCode, FString ErrorMessage)
     {
      // Do something if BulkUpdateUserStatItemsValue has an error
     }));

Statistic statistic = AccelByteSDK.GetClientRegistry().GetApi().GetStatistic();

string additionalKey = " Your additional key";

StatItemUpdate userStatItem1 = new StatItemUpdate
{
    statCode = " Your 1st stat code ",
    updateStrategy = StatisticUpdateStrategy.OVERRIDE,
    value = 100
};

StatItemUpdate userStatItem2 = new StatItemUpdate
{
    statCode = " Your 2nd stat code ",
    updateStrategy = StatisticUpdateStrategy.INCREMENT,
    value = 50
};

StatItemUpdate[] bulkUpdateUserStatItems = { userStatItem1, userStatItem2 };

statistic.UpdateUserStatItems(additionalKey, bulkUpdateUserStatItems, result =>
{
    if (result.IsError)
    {
        // Do something if UpdateUserStatItems an error
        Debug.Log($"Error UpdateUserStatItems, Error Code: {result.Error.Code} Error Message: {result.Error.Message}");
        return;
    }
    
    // Do something if UpdateUserStatItems is successful
});

string additionalKey = "Your additional key";
string userId = "<user-id>";

var response = sdk.Social.UserStatistic.BulkUpdateUserStatItemOp
    .SetAdditionalKey(additionalKey)
    .SetBody(new List<BulkStatItemUpdate>()
    {
        new BulkStatItemUpdate()
        {
            StatCode = "Your first stat code",
            UpdateStrategy = BulkStatItemUpdateUpdateStrategy.OVERRIDE,
            Value = 100
        },
        new BulkStatItemUpdate()
        {
            StatCode = "Your second stat code",
            UpdateStrategy = BulkStatItemUpdateUpdateStrategy.OVERRIDE,
            Value =50
        }
    })
    .Execute(sdk.Namespace, userId);
if (response != null)
{
    //do something if success
}

userStatisticService := &social.UserStatisticService{
    Client:          factory.NewSocialClient(&repository.ConfigRepositoryImpl{}),
    TokenRepository: &repository.TokenRepositoryImpl{},
}
namespace := "mygame"
userId := "myuserid"
statCode1 := "statcode1"
value1 := float64(100)
statCode2 := "statcode2"
value2 := float64(100)
updateStrategy := socialclientmodels.BulkStatItemUpdateUpdateStrategyOVERRIDE
item1 := socialclientmodels.BulkStatItemUpdate {
    StatCode: &statCode1,
    UpdateStrategy: &updateStrategy,
    Value: &value1,
}
item2 := socialclientmodels.BulkStatItemUpdate {
    StatCode: &statCode2,
    UpdateStrategy: &updateStrategy,
    Value: &value2,
}
body := []*socialclientmodels.BulkStatItemUpdate{
    &item1,
    &item2,
}
additionalKey, _ := cmd.Flags().GetString("additionalKey")
input := &user_statistic.BulkUpdateUserStatItemParams{
    Body:          body,
    Namespace:     namespace,
    UserID:        userId,
    AdditionalKey: &additionalKey,
}
result, err := userStatisticService.BulkUpdateUserStatItemShort(input)

UserStatistic userStatisticWrapper = new UserStatistic(sdk);

String additionalKey = "Your additional key";
String userId = "<user-id>";
List<BulkStatOperationResult> response;
try {
    List<BulkStatItemUpdate> reqBody = Arrays.asList(
      BulkStatItemUpdate.builder().statCode("Your first stat code")
          .updateStrategy(StatItemUpdate.UpdateStrategy.OVERRIDE.toString())
          .value(100f)
          .build(),
      BulkStatItemUpdate.builder().statCode("Your second stat code")
              .updateStrategy(StatItemUpdate.UpdateStrategy.OVERRIDE.toString())
              .value(50f)
              .build()
      );
    response = userStatisticWrapper.bulkUpdateUserStatItem(BulkUpdateUserStatItem.builder()
      .namespace("<namespace>")
      .userId(userId)
      .additionalKey(additionalKey)
      .body(reqBody)
      .build());
} catch (Exception e) {
    // Do something when failed
    return;
}

if (response == null) {
    // Null response from server
} else {
    // Do something if success
}

import accelbyte_py_sdk.api.social as social_service
import accelbyte_py_sdk.api.social.models as social_models

result, error = social_service.bulk_update_user_stat_item_2(
    body=[
        social_models.BulkStatItemUpdate()
            .with_stat_code("YourStatCode1")
            .with_update_strategy("OVERRIDE")
            .with_value(100.0),
        social_models.BulkStatItemUpdate()
            .with_stat_code("YourStatCode2")
            .with_update_strategy("INCREMENT")
            .with_value(50.0),
    ],
    user_id="********************************",
    additional_key="YourAdditionalKey",
    namespace=namespace,  # optional, gets the value from the global instance if unspecified
    sdk=sdk,  # optional, gets the global instance  if unspecified
)
if error:
    exit(error)

ユーザー統計データの取得

ユーザー統計データは簡単に取得でき、ユーザープロファイルの一部として、またはゲーム UI 内の任意の場所に表示できます。すべてのユーザー統計データを一覧表示するほか、Stat Code を指定して特定の統計データを表示したり、管理者ポータルで事前に設定したタグで絞り込んで表示したりすることもできます。

SDK 機能を使用するには、以下のスニペットを参照してください。

現在のユーザーと他のユーザーの統計データを取得

FApiClientPtr ApiClient = AccelByteOnlineSubsystemPtr->GetApiClient();

FString UserId = "Player User Id";
TArray<FString> StatCodes = { "Stat Code 1", "Stat Code 2" };
TArray<FString> Tags = { "Tag 1", "Tag 2", "Tag 3" };
int32 Offset = 0;
int32 Limit = 20;

ApiClient->Statistic.GetUserStatItems(UserId 
    , StatCodes
    , Tags
    , THandler<FAccelByteModelsUserStatItemPagingSlicedResult>::CreateLambda([](FAccelByteModelsUserStatItemPagingSlicedResult Result)
     {
      // Do something if GetUserStatItems is successful
     })
    , FErrorHandler::CreateLambda([](int32 ErrorCode, FString ErrorMessage)
     {
      // Do something if GetUserStatItems has an error
     })
    , Offset
    , Limit);

Statistic statistic = AccelByteSDK.GetClientRegistry().GetApi().GetStatistic();

string[] statCodes = { "Stat Code 1", "Stat Code 2" };
string[] tags = { "Tag 1", "Tag 2", "Tag 3" };

statistic.GetUserStatItems(statCodes, tags, result =>
{
    if (result.IsError)
    {
        // Do something if GetUserStatItemshas an error
        Debug.Log($"Error GetUserStatItems, Error Code: {result.Error.Code} Error Message: {result.Error.Message}");
        return;
    }
    
    // Do something if GetUserStatItemshas is successful
});

string[] statCodes = new[] { "Stat Code 1", "Stat Code 2" };
string[] tags = new[] { "Tag 1", "Tag 2", "Tag 3" };
string userId = "<user-id>";

var response = sdk.Social.UserStatistic.GetUserStatItemsOp
    .SetOffset(0)
    .SetLimit(100)
    .SetStatCodes(String.Join(",", statCodes))
    .SetTags(String.Join(",", tags))
    .Execute(sdk.Namespace, userId);
if (response != null)
{
    //do something if success
}

userStatisticService := &social.UserStatisticService{
    Client:          factory.NewSocialClient(&repository.ConfigRepositoryImpl{}),
    TokenRepository: &repository.TokenRepositoryImpl{},
}
namespace := "mygame"
userId := "myuserid"
statCodes := "statcode1,statcode2"
tags := "tag1,tag2,tag3"
input := &user_statistic.GetUserStatItemsParams{
    Namespace: namespace,
    UserID:    userId,
    StatCodes: &statCodes,
    Tags:      &tags,
}
result, err := userStatisticService.GetUserStatItemsShort(input)

UserStatistic userStatisticWrapper = new UserStatistic(sdk);

List <String> statCodes = List.of("Stat Code 1", "Stat Code 2");
List <String> tags = List.of("Tag 1", "Tag 2", "Tag 3");
String userId = "<user-id>";
UserStatItemPagingSlicedResult response;
try {
  response = userStatisticWrapper.getUserStatItems(GetUserStatItems.builder()
      .namespace("<namespace>")
      .userId(userId)
      .offset(0)
      .limit(100)
      .statCodes(String.join(",", statCodes))
      .tags(String.join(",", tags))
      .build());
} catch (Exception e) {
  // Do something when failed
  return;
}

if (response == null) {
    // Null response from server
} else {
  // Do something if success
}

import accelbyte_py_sdk.api.social as social_service

result, error = social_service.public_query_user_stat_items(
    limit=20,
    offset=0,
    stat_codes=["StatCode1", "StatCode2"],
    tags=["Tag1", "Tag2"],
    user_id="********************************",
    namespace=namespace,  # optional, gets the value from the global instance if unspecified
    sdk=sdk,  # optional, gets the global instance  if unspecified
)
if error:
    exit(error)

グローバル統計データの取得

ユーザー統計データと同様に、グローバル統計データもゲーム UI 内の任意の場所に簡単に表示できます。保有しているすべてのグローバル統計データを表示するほか、Stat Code を指定して特定の統計データを選択することもできます。

SDK 機能を使用するには、以下のスニペットを参照してください。

Stat Code を使用してグローバル統計データを取得

FApiClientPtr ApiClient = AccelByteOnlineSubsystemPtr->GetApiClient();

FString StatCode = "Your Global Statistic Code";

ApiClient->Statistic.GetGlobalStatItemsByStatCode(StatCode
    , THandler<FAccelByteModelsGlobalStatItemValueResponse>::CreateLambda([](FAccelByteModelsGlobalStatItemValueResponse Result)
     {
      // Do something if GetGlobalStatItemsByStatCode is successful
     })
    , FErrorHandler::CreateLambda([](int32 ErrorCode, FString ErrorMessage)
     {
      // Do something if GetGlobalStatItemsByStatCode has an error
     }));

Statistic statistic = AccelByteSDK.GetClientRegistry().GetApi().GetStatistic();

string statCode = "Your Global Statistic Code";

statistic.GetGlobalStatItemsByStatCode(statCode, result =>
{
    if (result.IsError)
    {
        // Do something if GetGlobalStatItemsByStatCode has an error
        Debug.Log($"Error GetGlobalStatItemsByStatCode, Error Code: {result.Error.Code} Error Message: {result.Error.Message}");
        return;
    }
    
    // Do something if GetGlobalStatItemsByStatCode is successful
});

string statCode = "GlobalStatCode";

var response = sdk.Social.GlobalStatistic.GetGlobalStatItemByStatCodeOp
    .Execute(sdk.Namespace, statCode);
if (response != null)
{
    //do something if success
}

globalStatisticService := &social.GlobalStatisticService{
    Client:          factory.NewSocialClient(&repository.ConfigRepositoryImpl{}),
    TokenRepository: &repository.TokenRepositoryImpl{},
}
namespace := "mygame"
statCode := "mystatcode"
input := &global_statistic.GetGlobalStatItemByStatCodeParams{
    Namespace: namespace,
    StatCode:  statCode,
}
result, err := globalStatisticService.GetGlobalStatItemByStatCodeShort(input)

GlobalStatistic globalStatisticWrapper = new GlobalStatistic(sdk);

String statCode = "GlobalStatCode";
GlobalStatItemInfo response;
try {
response = globalStatisticWrapper.getGlobalStatItemByStatCode(GetGlobalStatItemByStatCode.builder()
    .namespace("<namespace>")
    .statCode(statCode)
    .build());
} catch (Exception e) {
    // Do something when failed
    return;
}

if (response == null) {
    // Null response from server
} else {
    // Do something if success
}

import accelbyte_py_sdk.api.social as social_service

result, error = social_service.get_global_stat_item_by_stat_code_1(
    stat_code="YourGlobalStatisticCode",
    namespace=namespace,  # optional, gets the value from the global instance if unspecified
    sdk=sdk,  # optional, gets the global instance  if unspecified
)
if error:
    exit(error)

概要​

目標​

前提条件​

ユーザーおよびグローバル統計設定の作成​

Game SDK または Extend SDK を使用した統計データの使用​

統計データの更新​

単一ユーザー統計データの更新​

1人のユーザーの複数の統計データを更新​

ユーザー統計データの取得​

現在のユーザーと他のユーザーの統計データを取得​

グローバル統計データの取得​

Stat Code を使用してグローバル統計データを取得​

概要

目標