アイテム属性

属性は、アイテムに関する追加情報を提供できるアイテムの特性です。

属性には、アイテムの色とサイズ、アイテムが使用可能になるユーザーレベル、またはゲーム内のイベントが含まれます。

主な特徴：

• ストア内のアイテムを絞り込む
• アイテムのバリエーション（例：赤いヘルメット、青いヘルメット）を定義し、アイテムカードに表示する
• アイテムに追加の特性を割り当てる

アイテムの属性とその値の例：

どのように動作するか

1. アイテムの属性とその値を作成し、アイテムとリンクさせます：

• パブリッシャーアカウントまたはAPIを通じて、アイテム属性のExternal IDと属性値のExternal IDを指定します。
• パブリッシャーアカウントを通じて、JSON形式で属性とその値を指定します。

2. アイテムカタログを要求するには、メソッドグループの仮想アイテム & 通貨またはゲームキーの「カタログ」サブセクションのメソッドを使用します。属性データが以下の場所で返されます：

• 属性の配列内。パブリッシャーアカウントまたはAPIメソッドによって、アイテム属性のExternal IDと属性値のExternal IDを指定して属性が作成された場合。
• custom_attributesの配列内。属性と値がJSON経由で追加された場合。これを行うには、カタログ取得リクエストに値custom_attributesを持つadditional_fieldsパラメータを含める必要があります。

3. ユーザーが購入を行います。属性と値がJSON経由で追加された場合、アイテムの属性に関するデータは、custom_attributes配列内の注文支払い成功と注文のキャンセルウェブフックで渡されます。

統合フロー

アイテムの属性とその値をユーザー側で作成し、パブリッシャーアカウントのJSON形式でアイテムに追加することができます。

エクソーラ側で属性とその値を作成し、アイテムに追加することもできます。操作するには：

1. 属性とその値を作成します。
2. 属性とアイテム間の接続を設定します。

アイテムの属性とその値の作成と設定

各アイテム属性には次のパラメータがあります：

• External ID — リクエスト本文のexternal_idパラメータで渡される一意の属性IDです。システム上の属性IDを指定するか、新しい属性IDを作成してください。
• 名前（プロジェクトで構成された言語ごとに指定される）。

• 値のリスト。

• 親アイテム属性のExternal ID。
• 値のExternal ID — パスパラメータのexternal_idパラメータで渡される値の一意なID。システム内の値IDを指定するか、新しいIDを作成してください。

• 名前（プロジェクトで構成された言語ごとに指定される）。

• パブリッシャーアカウント経由
• APIメソッド経由

パブリッシャーアカウントでの属性とその値の作成

1. パブリッシャーアカウントであなたのプロジェクトを開きます。
2. 「ストア > カタログ管理」に移動します。

3. 「アイテム属性」セクションで「構成」をクリックします。
4. 「アイテム属性を作成する」をクリックします。
5. アイテム属性のExternal IDと名前を指定します。
6. 「保存して続行」をクリックします。
7. 作成されたアイテムの属性に必要な値をすべて指定します。すべての値に対して、External IDを指定します。さらに値を追加するには、「+をクリックします。
8. 「保存して続行」をクリックします。

APIメソッドを使用した属性とその値の作成

アイテム属性とその値を作成および管理するには、メソッドのアイテム属性グループの「管理」サブセクションにあるメソッドを使用します。

属性を作成して管理するメソッド：

• 属性を作成する
• 属性を更新する
• 指定された属性を取得する
• 属性を削除する

• 管理用の属性リストを取得する

• 属性値を作成する
• 属性値をすべて削除する
• 属性値を更新する
• 属性値を削除する

アイテムに属性を追加する

作成した属性と値をアイテムに追加します：

• パブリッシャーアカウント経由
• APIメソッド

パブリッシャーアカウント経由で既存の属性を追加する

1. パブリッシャーアカウントであなたのプロジェクトを開きます。
2. サイドメニューで、「ストア」をクリックします。
3. 必要なアイテムタイプのセクションを開きます：
   • 仮想アイテム
   • 仮想通貨
   • ゲームキー
   • バンドル
4. 新しいアイテムを作成するか、既存のアイテムを編集します。
5. 「アイテム属性」セクションで、「既存の属性を選択するか、新しい属性を作成する」トグルを「オン」に切り替えます。
6. 表示された「アイテム属性」フィールドで、目的のアイテム属性に対応するIDを選択します。
7. 「値」フィールドで、アイテム属性値に対応するIDを選択します。

APIメソッドによる既存の属性を追加する

仮想アイテムを作成するメソッドまたは仮想アイテムを更新するメソッドで、接続する必要があるアイテム属性のExternal IDとその値のExternal IDを含むオブジェクトの配列を渡します。

属性とその値を含む配列の例：

  "attributes": [
    {
      "external_id": "craft-materials",
      "name": {
        "en": "Craft materials"
      },
      "values": [
        {
          "external_id": "steel",
          "value": {
            "en-US": "5"
          }
        },
        {
          "external_id": "leather",
          "value": {
            "en-US": "1"
          }
        }
      ]
    }
  ],

パブリッシャーアカウント経由でJSONから属性の追加

以下のようなあらゆるタイプのアイテムを作成または編集する際に、JSON形式で属性とその値を追加できます：

• 仮想通貨パッケージ
• 仮想アイテム（期間限定アイテムを含む）
• ゲームキー
• バンドル

操作するには：

1. パブリッシャーアカウントであなたのプロジェクトを開きます。
2. サイドメニューで、「ストア」をクリックします。
3. 必要なアイテムタイプのセクションを開きます：
   • 仮想アイテム
   • 仮想通貨
   • ゲームキー
   • バンドル
4. 新しいアイテムを作成するか、既存のアイテムを編集します。
5. 「アイテム属性」セクションで、「JSONを使用して属性を追加する」トグルを「オン」に切り替えます。

6. 表示されたテキスト域に、属性とその値のリストをJSON形式で追加します。