カタログの概要

この概要では、Game Manager の [Economy] セクションにある [Catalog V2] タブについて説明します。PlayFab Economy V2 のカタログ機能について説明し、さまざまなアイテム タイプのすべてのフィールド プロパティを取り上げます。

​

カタログとは?

カタログは、プレイヤーが購入できるアイテムや、プレイヤーに付与できるアイテムを定義するために使用されます。多くのゲームでは、シールド、レベル アンロック、パワー アップなどのアイテムをプレイヤーに提供しています。これらのアイテムはカタログで指定され、多くの場合、仮想通貨または実際のお金で販売されます。PlayFab のカタログは、ゲームの仮想アイテムを簡単に管理する方法を提供し、ゲームで利用可能なすべてのアイテムを保持できます。

​

アイテム フィールド リファレンス

このセクションでは、Game Manager の [Economy] 領域の [Catalog V2] セクションの各フィールドについて説明します。 タイトルを最初に作成した時点では、カタログは空です。アイテムを作成するまで、[Catalog] セクションにはアイテムは表示されません。 [Catalog v2] セクションには、次のタブがあります: これらはそれぞれ、カタログ内で使用できるアイテム タイプです。

​

Catalog V2 アイテム フィールド

[Catalog V2]、[Items] タブを選択し、[NEW ITEM] を選択すると、次のページが表示されます: [New Item] ページには、次のフィールドが含まれています。明記 しない限り、これらのフィールドはオプションです:

• プロパティ
  • Creator Entity Type: エンティティ作成者の種類を示す、システムが作成した フィールド。
  • Creator Entity ID: エンティティ作成者の一意の ID。Game Manager では、この ID はタイトルの値に設定されます。
  • Friendly ID: コードでの参照を容易にするために使用できるフィールド。Friendly ID はすべてのアイテムに対してオプションで、カタログ内で一意である必要があります。
  • Title: 通常プレイヤーに表示されるアイテムの一般名前の 必須 フィールド。ロケール キーを使用することで、Title の簡単なローカリゼーションがサポートされます。詳細については、Economy V2 ローカリゼーション を参照してください。
  • Default Stack ID: アイテムは、それぞれ独自の量を持ち、StackId で区別されるスタックとしてインベントリに保存できます。定義されていない場合、インベントリ アクションは StackId として default を使用します。詳細については、Economy Stacks を参照してください。
  • Keywords: 基本的な検索フィルタリングにキーワードを使用できます。これは、JSON 形式のローカライズされたキーワードの辞書です。例については、Economy V2 ローカリゼーション を参照してください。
  • Description: JSON 形式のローカライズされたアイテム説明の辞書。
  • Content Type: このドロップダウンを使用して、アイテムの Content Type を選択できます。Content Type は Catalog Settings (Title Settings > Economy) で定義されます。
  • Display Properties: カスタム アイテム プロパティに使用できる JSON blob。
  • Display Version: Display Properties のバージョン管理に使用できるフィールド。
  • Tags: このフィールドには、検索用にカタログ アイテムを整理するために使用できるタグが含まれます。タグはカンマ区切りのテキスト文字列として入力できます。これらの文字列は Catalog Settings (Title Settings > Economy) で事前定義されます。
  • Available Tags Catalog Config で既に定義されているアイテム タグを選択するための便利なドロップダウン。
  • オプション
    • Hidden: このセクションに一覧表示されるアイテムには現在、単一のオプションがあります。このオプション、Hidden は、アイテムが検索で公開されないようにします。
  • Start Date: アイテムを検索で利用可能にする 必須 日付フィールド。
  • End Date: アイテムを検索で利用不可にする時期を指定する日付フィールド。
• 価格
  • Add New Price: このセクションを使用して、アイテムの 1 つ以上の購入価格を指定できます。
• ファイル
  • Upload: このアイテムに関連付けることができるコンテンツを公開カタログに保存するためにアップロードできます。
• 画像
  • Upload: ゲーム内カタログのアイテム表示用に、サムネイルやスクリーンショットなど、さまざまな画像をアップロードできます。
• プラットフォーム
  • Manage: このアイテムがどのプラットフォーム向けかを指定できます。プラットフォーム リストは Catalog Settings (Title Settings > Economy) で定義されます。

​

アイテムをドラフトまたは公開状態に保存する

Economy V2 カタログは ドラフト アイテム状態をサポートしています。[Save as Draft] を選択すると、アイテム メタデータは直接呼び出しで利用できますが、公開検索には公開されません。アイテムを公開する準備ができたら、公開済み 状態に設定します。詳細については、アイテムのステータス ページを参照してください。

​

アイテム作成の例

アイテム を作成するには:

1. Game Manager を開き、左側のサイド バーで [Economy] を選択します。
2. [Catalogs V2] タブを選択します。
3. [NEW ITEM] ボタンを選択します。
   1. 必須アイテム フィールドを入力します:
      • Title (JSON 例: {“NEUTRAL”:“My New Amazing Item”})。
      • Start Date (今日の日付を選択)。
4. [SAVE AND PUBLISH] ボタンを選択すると、Items ページに戻ります。
5. さらにアイテムを追加するには、[NEW ITEM] を選択し、手順 3 〜 5 を繰り返します。

​

Catalog V2 通貨フィールド

[Catalog V2] を選択し、[Currency] タブを開き、[NEW CURRENCY] を選択すると、[New Currency] ページが開きます。 通貨は、Catalog V2 アイテム フィールド と同じフィールドをすべて含みます。

​

Catalog V2 UGC フィールド

[Catalog V2] を選択し、[UGC] タブを開き、[NEW ITEM] を選択すると、[New User Generated Content] ページが開きます。 User Generated Content は、Catalog V2 アイテム フィールド のすべてのフィールドに 加えて、次のフィールドを含みます:

• モデレーション ステート
  • Moderation State: アイテムを Approved、Awaiting Moderation、または Rejected としてマークする簡単な方法。Moderation State は公開されたアイテムでのみ変更できます。

​

Catalog V2 バンドル フィールド

[Catalog V2] を選択し、[Bundles] タブを開き、[NEW BUNDLE] を選択すると、[New Bundle] ページが開きます。 このページには、Catalog V2 アイテム フィールド のすべてのフィールドに 加えて、次のフィールドが含まれています:

• アイテム
  • Add: バンドルを使用すると、複数のアイテムを 1 つのアイテムにグループ化できます。よく一緒に購入されるアイテムや、期間限定でのみ利用可能なアイテムのバンドルを作成できます。詳細については、Economy V2 バンドル のドキュメントを参照してください。
• マーケットプレイス マッピング
  • Marketplace、Marketplace ID: ゲーム内アイテムを、引き換えシナリオ用に 1 つ以上のマーケットプレイス アイテムにリンクできます。詳細については、Economy V2 アプリ内購入 のドキュメントを参照してください。

​

Catalog V2 ストア フィールド

[Catalog V2] を選択し、[Stores] タブを開き、[NEW STORE] を選択すると、[New Store] ページが開きます。 ストアには、Catalog V2 アイテム フィールド と同じフィールドに 加えて、次のフィールドが含まれています:

• アイテム
  • Add: ストアには、カタログ内の他の任意のアイテム タイプを含めることができます。すべてのカタログ コンテンツはベース コストを維持するか、このストアからここに一覧表示された価格で購入できます。詳細については、Economy V2 ストア のドキュメントを参照してください。

新しいカタログが、プレイヤーに魅力的でやりがいのある体験を作成するための強力で柔軟なツールであることを実感していただけると幸いです。詳細については、Economy V2 クイックスタート を参照してください。

​

関連項目

• PlayFab Economy V2 アイテム
• PlayFab Economy V2 通貨
• PlayFab Economy V2 UGC
• PlayFab Economy V2 バンドル
• PlayFab Economy V2 ストア
• PlayFab Economy V2 サブスクリプション