インゲームストア / アイテム属性
  ドキュメントに戻る

インゲームストア

アイテム属性

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

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

主な特徴:

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

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

アイテムタイプアイテム属性名アイテム属性値
ゲームキーゲームのタイプ新規、アーリーアクセス、近日公開、スペシャル
ゲームキージャンルアクション、アドベンチャー、カジュアル、シミュレータ、ストラテジー、RPG
仮想アイテム品質エピック、レジェンダリー、コモン
仮想アイテムクラスウォリアー、パラディン、ハンター、シャーマン、ドルイド
仮想通貨イベント新しい年
仮想通貨クエストクエスト1の完了、クエスト2の完了

どのように動作するか

  1. アイテムの属性とその値を作成し、アイテムとリンクさせます:
  1. アイテムカタログを要求するには、メソッドグループの仮想アイテム & 通貨またはゲームキーの「カタログ」サブセクションのメソッドを使用します。属性データが以下の場所で返されます:
  • 属性の配列内。パブリッシャーアカウントまたはAPIメソッドによって、アイテム属性のExternal IDと属性値のExternal IDを指定して属性が作成された場合。
  • custom_attributesの配列内。属性と値がJSON経由で追加された場合。これを行うには、カタログ取得リクエストに値custom_attributesを持つadditional_fieldsパラメータを含める必要があります。
  1. ユーザーが購入を行います。属性と値がJSON経由で追加された場合、アイテムの属性に関するデータは、custom_attributes配列内の注文支払い成功注文のキャンセルウェブフックで渡されます。

統合フロー

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

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

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

JSONからアイテムの属性とその値を追加する場合、500文字の制限があります。属性と値の数に制限はありません。

パブリッシャーアカウントまたはAPIメソッドで属性とその値を作成する場合、以下の制限が適用されます:

  • 1つのアイテム属性に20以上の値を指定することはできません
  • 各アイテムに設定できる属性は最大20です
  • 1つのアイテムは、1つの属性に複数の値を持つことができますが、最大6つです

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

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

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

各アイテム属性値には次のパラメータがあります:
  • 親アイテム属性のExternal ID
  • 値のExternal ID — パスパラメータのexternal_idパラメータで渡される値の一意なID。システム内の値IDを指定するか、新しいIDを作成してください。
  • 名前(プロジェクトで構成された言語ごとに指定される)。

以下の方法でアイテムの属性とその値を作成できます:

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

  1. パブリッシャーアカウントであなたのプロジェクトを開きます。
  2. ストア > カタログ管理」に移動します。
  1. アイテム属性」セクションで「構成」をクリックします。
  2. アイテム属性を作成する」をクリックします。
  3. アイテム属性のExternal IDと名前を指定します。
  4. 保存して続行」をクリックします。
  5. 作成されたアイテムの属性に必要な値をすべて指定します。すべての値に対して、External IDを指定します。さらに値を追加するには、「+をクリックします。
  6. 保存して続行」をクリックします。
お知らせ

プロジェクトのアイテム属性数に制限はありません。

ただし、1つの属性につき20個の値という制限があります。

属性と値を作成した後、APIまたはパブリッシャーアカウント経由でアイテムに追加することができます。

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

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

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

属性値を作成して管理するメソッド:
注意

アイテム属性を削除すると、その値とアイテムとの接続が失われます。

値を削除すると、そのアイテムとの接続が失われます。

削除されたアイテムの属性、値、または関連データを復元することはできません。

属性と値を作成した後、APIまたはパブリッシャーアカウント経由でアイテムに追加することができます。

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

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

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

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

1つのアイテムに20以上の属性を設定することはできません。

1つのアイテムに対して、同じ属性の値を6つ以上指定することはできません。

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

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

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

Copy
Full screen
Small screen
  "attributes": [
    {
      "external_id": "craft-materials",
      "name": {
        "en": "Craft materials"
      },
      "values": [
        {
          "external_id": "steel",
          "value": {
            "en-US": "5"
          }
        },
        {
          "external_id": "leather",
          "value": {
            "en-US": "1"
          }
        }
      ]
    }
  ],
お知らせ
仮想アイテム & 通貨またはゲームキーメソッドグループの「カタログ」サブセクションのメソッドを使用してアイテムカタログを要求する場合、応答には、対応する属性とその値のリストも属性の配列に含まれます。
お知らせ

1つのアイテムに20以上の属性を設定することはできません。

1つのアイテムに対して、同じ属性の値を6つ以上指定することはできません。

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

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

操作するには:

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

JSON形式で属性を追加する場合、数や値に制限はありません。

JSONの最大長には500文字という制限があります。

この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
このページを評価する
このページを評価する
改善できることはありますか?

答えたくない

ご意見ありがとうございました!
最終更新日: 2023年10月10日

誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。

問題を報告する
当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
フォローアップ用のメールをご提供してください
ご意見ありがとうございました!