シーズンパスを設定する

Last updated on October 15, 2026

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

概要

AccelByte Gaming Services (AGS) が提供するシーズンパスサービスを使用すると、ゲーム内にシーズン進行システムを実装できます。プレイヤーは経験値を獲得してティアをレベルアップし、各ティアで報酬をアンロックしながらシーズンを進めていきます。シーズンパスは収益源を追加するだけでなく、報酬のアンロックを目指して進行する達成感を提供することで、プレイヤーのエンゲージメントを高めます。このガイドでは、シーズンパスの設定方法について説明します。

シーズンパスは、AGS Admin Portal または AGS CLI で設定できます。

Season Pass Light Fantastic

前提条件

AGS Admin Portalへのアクセス
AccelByte シーズンパス API ドキュメントへのアクセス
必要な情報を設定するためのAccelByte ECommerce APIへのアクセス

AGS CLI の手順を実行するには、AGS CLI をインストールし、これらの機能へのアクセス権を持つアカウントでサインインしておく必要があります。詳細はインストールとサインインを参照してください。例では Bash シェルを使用しています。

シーズンパスアイテムを設定する

シーズンパスを作成する前に、ストアでパスアイテム、ティアアイテム、報酬アイテムを定義する必要があります。パスアイテムとティアアイテムを使用すると、シーズンパスを収益化できます。プレミアムパスアイテムを購入したプレイヤーは、ユニークなゲーム内アイテムなどの限定報酬を含むプレミアムシーズンパスを獲得でき、より深くゲームに没入できるようになります。一方、ティアアイテムを購入したプレイヤーは、手動でティアをクリアしなくてもシーズンをより速く進められます。報酬アイテムは、プレイヤーがティアをクリアした際に獲得できるゲーム内アイテムまたはコインです。

ストアアイテムを設定するには、ストアでアイテムを作成するを参照してください。ドラフトストアでアイテムを作成した後、ストアの公開をスキップできます。ストアの公開は、シーズンを公開する直前に行うことができます。

パスアイテムを作成する

パスアイテムを作成するには、次の手順に従います:

Admin Portal
AGS CLI

ストア内のアイテムを作成ページに移動します。
アイテムタイプシーズンを選択し、アイテムの下でPASSを選択します。
ストア設定セクションに入力します。セクションに入力するには、ストアでアイテムを作成するを参照してください。
作成をクリックしてパスアイテムを作成します。

ドラフトストアの ID を確認します。出力では、published が false に設定されているストアの storeId がそれにあたります。そのストアの defaultLanguage と defaultRegion もメモしておきます。
```
ags platform stores list --namespace <YourNamespace> --format json
```

アイテムのカテゴリの categoryPath を確認します。

ags platform categories list --namespace <YourNamespace> --store-id <StoreId> --format json

アイテムの設定を記述した JSON ファイルを作成します。ファイル名は任意です。この例では pass-item.json を使用します。
```
{
  "itemType": "SEASON",
  "seasonType": "PASS",
  "name": "<ItemName>",
  "categoryPath": "<CategoryPath>",
  "entitlementType": "DURABLE",
  "localizations": {
    "<DefaultLanguage>": { "title": "<ItemName>" }
  },
  "regionData": {
    "<DefaultRegion>": [
      { "currencyNamespace": "<CurrencyNamespace>", "currencyCode": "<CurrencyCode>", "price": 500 }
    ]
  }
}
```
- localizations: <DefaultLanguage> をストアの defaultLanguage に置き換えます。
- regionData: <DefaultRegion> をストアの defaultRegion に置き換えます。ネームスペース内の通貨を確認するには、ags platform currencies list --namespace <CurrencyNamespace> --format json を実行します。
- price: 整数で指定します。末尾の桁は通貨の decimals (小数点以下の桁数) 分の小数部を表します。たとえば、小数点以下 2 桁の通貨では、500 は 5.00 を表します。
さらにフィールドを設定するには、ファイルに追加します。すべてのフィールドを確認するには、ags platform items create --skeleton を実行します。
アイテムを作成します。@ の後に JSON ファイルのパスを指定します。
```
ags platform items create --namespace <YourNamespace> --store-id <StoreId> --json @pass-item.json
```
コマンドは新しいアイテムを出力します。その itemId がパスアイテム ID です。

ティアアイテムを作成する

ティアアイテムを作成するには、次の手順に従います:

Admin Portal
AGS CLI

ストア内のアイテムを作成ページに移動します。
アイテムタイプシーズンを選択し、アイテムの下でTIERを選択します。
ストア設定セクションに入力します。セクションに入力するには、ストアでアイテムを作成するを参照してください。
作成をクリックしてティアアイテムを作成します。

パスアイテムを作成するの AGS CLI の手順に従いますが、seasonType を TIER に設定します。

シーズンパスを作成する

Admin Portal
AGS CLI

Admin Portalでシーズンを作成するには、次の手順に従います:

ゲームのネームスペースで、エンゲージメント > シーズンパスに移動します。
シーズンパスタブで、ドラフトシーズンを作成ボタンをクリックします。
シーズンパスを作成フォームが表示されます。必須フィールドに入力します。
- シーズン名を追加します。
- デフォルト言語フィールドでローカライゼーションのデフォルト言語を選択します。シーズンを作成した後、ローカライゼーション用の追加言語を追加できます。
- シーズンパス期間フィールドで、このシーズンが開始および終了する日時を選択します。
- シーズンに関連するアイテムが配置されているドラフトストアを選択します。
- ティアアイテムフィールドでティアアイテムを選択します。
- デフォルト経験値フィールドで、各ティアをクリアするためのデフォルト経験値を入力します。
- プレイヤーに自動的に報酬を付与する場合は、報酬を自動的に獲得オプションを選択します。それ以外の場合、プレイヤーはゲーム内から手動で報酬を獲得する必要があります。
保存して次へをクリックします。
シーズン作成フォームに入力した後、パスタブに移動します。この時点から、次のオプションがあります:

a. パスタブで、シーズンにパスを追加します。そのためには、パスを設定するセクションの手順3〜5に従います。次に、次へをクリックして報酬タブに移動します。 b. 報酬タブで、シーズンに報酬を追加します。そのためには、報酬を設定するセクションの手順3〜5に従います。次に、次へをクリックしてティアタブに移動します。 c. ティアタブで、シーズンにティアを追加します。そのためには、ティアを設定するセクションの手順3〜5に従います。次の手順に進みます。

備考
これらのオプションは今すぐスキップして、シーズンを保存した後に設定することもできます。ティアタブに到達するまでスキップを選択し続けます。次の手順に進みます。
ティアタブで、作成をクリックしてシーズンをドラフトシーズンとして作成および保存します。作成したパス、報酬、ティアがある場合は、ドラフトシーズンにも追加されます。作成したシーズンのプレビューページが表示されます。

備考
プレビューで名前、期間、パス、報酬、ティアを直接調整できます。
次のステップとして、次のことができます:
- ドラフトシーズンを表示して設定します。
- ドラフトシーズンを公開して開始します。

ドラフトストアの ID を確認します。出力では、published が false に設定されているストアの storeId がそれにあたります。
```
ags platform stores list --namespace <YourNamespace> --format json
```
ティアアイテムの ID を確認します。出力では、seasonType が TIER に設定されているアイテムの itemId がそれにあたります。
```
ags platform items list --namespace <YourNamespace> --store-id <StoreId> --item-type SEASON --format json
```
シーズンの設定を記述した JSON ファイルを作成します。ファイル名は任意です。この例では season.json を使用します。
```
{
  "name": "<SeasonName>",
  "defaultLanguage": "en",
  "localizations": {
    "en": { "title": "<SeasonTitle>", "description": "<SeasonDescription>" }
  },
  "start": "<StartDateTime>",
  "end": "<EndDateTime>",
  "draftStoreId": "<StoreId>",
  "tierItemId": "<TierItemId>",
  "defaultRequiredExp": 100,
  "autoClaim": false
}
```
- defaultLanguage: デフォルト言語です。localizations には、この言語のエントリを含め、その言語でのシーズンのタイトルと説明を指定する必要があります。
- start と end: シーズンパス期間です。2027-01-01T00:00:00Z のような ISO 8601 形式の日時で指定します。
- defaultRequiredExp: 各ティアをクリアするためのデフォルト経験値です。
- autoClaim: 報酬を自動的に獲得オプションと同様に、プレイヤーに報酬を自動的に付与するには true を指定します。
シーズンを作成します。@ の後に JSON ファイルのパスを指定します。
```
ags season-pass seasons create --namespace <YourNamespace> --json @season.json
```
コマンドは新しいドラフトシーズンを出力します。その id がシーズン ID です。
シーズンにパス、報酬、ティアを追加します。シーズンパスを設定するの AGS CLI の手順を参照してください。

警告

ags workflow run season-pass --namespace <YourNamespace> は、1 つのコマンドで完全なサンプルシーズンパスを作成します。ドラフトストア内のシーズンアイテム、無料パスとプレミアムパスを持つシーズン、報酬、3 つのティアが作成されます。その後、ドラフトストア内の保留中の変更をすべて公開し、シーズンを即座に公開します。公開済みシーズンがないテスト用ネームスペースでのみ使用してください。

公開済みおよびドラフトシーズンを表示する

公開済みおよびドラフトシーズンを表示するには、次の手順に従います:

Admin Portal
AGS CLI

ゲームのネームスペースで、エンゲージメント > シーズンパスに移動します。
シーズンパスページで、公開済みシーズンタブで公開済みシーズンを、ドラフトシーズンタブでドラフトシーズンを表示できます。

シーズンを一覧表示します。公開済みシーズンを表示するには、--status を PUBLISHED に設定します。ドラフトシーズンの場合は DRAFT を使用します。

ags season-pass seasons list --namespace <YourNamespace> --status <Status>