グローバル実績を設定する

Last updated on October 14, 2026

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

概要

AccelByte Gaming Services (AGS) には、グローバル実績(コミュニティ実績をロック解除するためのプレイヤー全体の統計)を作成できるサービスが含まれています。これは段階型実績に似ており、貢献した値は AccelByte Statistics に保存され、目標値に到達すると、貢献したプレイヤーのみが実績をロック解除できます。

このガイドでは、AGS 管理ポータルまたは AGS CLI でグローバル実績を設定する方法を学習します。

目標

• 実績設定の概要を理解する。
• グローバル実績でグローバル統計を利用する方法を理解する。

前提条件

• AGS 管理ポータルへのアクセス。
• AccelByte Achievement API ドキュメントへのアクセス。
• 必要な情報を設定するための AccelByte Statistics API へのアクセス。

• AGS CLI の手順に従うには、AGS CLI をインストールし、これらの機能にアクセスできるアカウントでサインインしている必要があります。インストールとサインインを参照してください。例では Bash シェルを使用します。

グローバル実績を設定する

グローバル実績は段階型実績に似ているため、グローバル統計設定が既にセットアップされていることを確認してください。グローバル統計設定をセットアップするには、ゲーム全体のグローバル統計を追跡するガイドに従ってください。

グローバル統計設定が完了したら、それを使用してグローバル実績を作成できます。以下の手順に従って、AGS 管理ポータルまたは AGS CLI で実績設定をセットアップできます。

Admin Portal

1. 管理ポータルのサイドバーで、Online > Achievements > Configuration に移動します。

2. Achievements ページで、Add Achievement ボタンをクリックします。

3. Add New Achievements フォームで、必要な情報を入力します。

• Code フィールドに、許可された形式の値(例: hero-collector)を入力します。また、後で実績を識別しやすくするために、実績の Name を入力します。作成した実績に関する追加情報を記載するため、Description も入力してください。

• グローバル実績の場合は、Set as Global を有効にする必要があります。また、貢献した値を AccelByte Statistics サービスに保存する段階型実績に似ているため、Incremental が有効になっていることを確認してください。

• この実績に関連付けるグローバル統計の Goal Value と Statcode も入力してください。

備考

Goal Value は、統計設定で定義された Max. Value を超えてはなりません。

• Locked Icon の画像も追加する必要があります。これは、この実績をまだ獲得していないプレイヤーに表示されます。
• 実績がロック解除されたときに表示される Unlocked Icon を追加します。
• Tags や Custom Attributes など、実績の追加情報を保存できるオプションのフィールドもあります。

4. Add をクリックします。新しい実績が実績リストに追加されます。

AGS CLI

1. 実績の設定を記述した JSON ファイルを作成します。ファイル名は任意です。この例では achievement.json を使用します。

   {
     "achievementCode": "<AchievementCode>",
     "defaultLanguage": "en",
     "name": { "en": "<AchievementName>" },
     "description": { "en": "<AchievementDescription>" },
     "hidden": false,
     "incremental": true,
     "global": true,
     "statCode": "<GlobalStatCode>",
     "goalValue": 100,
     "lockedIcons": [{ "slug": "<LockedIconName>", "url": "<LockedIconUrl>" }],
     "unlockedIcons": [{ "slug": "<UnlockedIconName>", "url": "<UnlockedIconUrl>" }]
   }

   • achievementCode、name、description: それぞれ Code、Name、Description に対応します。name と description には言語ごとにテキストを 1 つずつ指定します。defaultLanguage には、それらの言語のいずれかを指定する必要があります。
   • global と incremental: グローバル実績では、両方を true に設定します。グローバル実績は段階型である必要があります。
   • statCode と goalValue: グローバル統計の Statcode と Goal Value に対応します。目標値は 1 以上である必要があります。
   • lockedIcons と unlockedIcons: Locked Icon と Unlocked Icon に対応します。管理ポータルでは画像が自動的にアップロードされます。AGS CLI では、url に既にホストされている画像のアドレスを、slug にアイコンの名前を指定します。

   その他のフィールドを設定するには、ファイルに追加します。すべてのフィールドを確認するには、ags achievement achievements create --skeleton を実行します。次のフィールドは、管理ポータルのオプション設定に対応します。

   管理ポータルの設定	リクエストボディのフィールド
   Tags	tags
   Custom Attributes	customAttributes

2. 実績を作成します。@ の後に JSON ファイルへのパスを指定します。

   ags achievement achievements create --namespace <YourNamespace> --json @achievement.json

   コマンドを実行すると、作成された実績が出力されます。

次のステップ

グローバル実績を設定したら、ゲームへの統合を開始できます。次の記事を参照してください。

• AGS SDK を使用してプレイヤーの実績を表示する
• AGS SDK を使用してプレイヤーの実績をロック解除する
• 管理ポータルからプレイヤーの実績を管理する
• 実績をグループ化およびフィルタリングする

実績サービスは、段階型実績と隠し実績の設定もサポートしています。