インゲームストア / カタログのアイテムをグループ分けして並べ替える方法
  ドキュメントに戻る

インゲームストア

カタログのアイテムをグループ分けして並べ替える方法

グループ単位でアイテムを追加し、多階層のカタログを作成することができます。グループには、同一のもの、異なるタイプのものを含めることができます:

  • 仮想アイテム
  • 仮想通貨
  • 仮想通貨のパッケージ
  • バンドル
  • ゲームキー
グループ内でアイテムを特定の順序で並べて、売上を増やしたり、人気のあるアイテムをユーザーに表示したりできます。グループ別にアイテムをリクエストすると、アドミンページで並べ替えられた順序でアイテムが取得されます。

お知らせ
アドミンページのアイテム カタログ内のアイテムを並べ替えることができません。

主な機能:

  • 同じ項目を複数グループに分けて追加します。
  • 大きなものに小さなグループを追加して、マルチレベルのカタログを作成します。
  • グループの順番を変更します。
  • アイテムの順序を変更します。

以下のいずれかの方法でグループをセットアップします:

アドミンページ経由のセットアップ

グループを作成する

仮想アイテムのグループを作成するには:

  1. アドミンページでプロジェクトを開きます。
  2. サイドメニューの「ストア」をクリックします。
  3. 仮想アイテムペインで、以下をクリックします:
    • 接続 - 仮想アイテムがない場合。
    • 構成 - 以前に仮想アイテムを接続したことがある場合。
  4. +をクリックしてドロップダウンリストでグループを作成するを選択します。

  1. 以下のパラメータを指定します:
    • External ID — ユニークなグループコードです。
    • グループ名
  2. ストアにグループを表示するトグルをオンに設定します。
  3. グループを作成するをクリックします。

グループを編集する

グループを編集するには:

  1. アドミンページでプロジェクトを開きます。
  2. サイドメニューのストアをクリックします。
  3. 仮想アイテムペインで、•••をクリックし、ドロップダウンリストで グループを編集するを選択します。

  1. 必要な変更を行います。
  1. 変更を保存するをクリックします。
お知らせ
ストアでグループを非表示にしている(ストアでグループを表示するトグルをオフに設定している)場合、そのようなグループは:
  • アイテムグループリストを取得するAPIを呼び出したときの応答で返されません。
  • アイテムのリストを取得するためのクライアントメソッドを呼び出したときに、このグループに含まれるアイテムのプロパティに表示されません。

グループにアイテムを追加する

仮想アイテムを必須のグループに追加するには、新規アイテムの作成時や既存アイテムの編集時にグループを指定します。
お知らせ
特定のグループを持たないアイテムは、グループリストの最後にあるUngroupedグループに自動的に追加されます。このグループのアイテムには以下の制限があります:

アイテムの並べ替え

アイテムを並べ替えるには(仮想アイテムの例で):
  1. アドミンページでプロジェクトを開きます。
  2. サイドメニューのストアをクリックします。
  3. 仮想アイテムペインで、以下をクリックします:
    • 接続 – 仮想アイテムがない場合。
    • 構成 — 以前は仮想アイテムに接続された場合。
  4. グループに移動します。
  5. 仮想アイテム番号にカーソルを合わせます。アイコンが表示されます。 仮想アイテムを新しい位置にドラッグします。

APIコール経由のセットアップ

グループにアイテムを追加する

APIコールで既存のグループにアイテムを追加するには、アイテムが属するべきグループのexternal_idパラメータを含む配列をgroupフィールドに渡します:

リクエストの例:

Copy
Full screen
Small screen

{
   "sku": "sword",
   "name": {
      "en": "Sword",
   },
   "is_enabled": true,
   "is_free": false,
   "order": 1,
   "description": {
      "en": "A sword is a bladed melee weapon intended for cutting or thrusting that is longer than a knife or dagger, consisting of a long blade attached to a hilt.",
   },
   "prices": [
      {
         "amount": 100,
         "currency": "USD",
         "Is_enabled": true,
         "is_default": true
      }
   ],
   "vc_prices": [ ],
   "is_show_in_store": true,
   "groups": [
   "chests", "bonus"
],
}

グループのリストを取得する

注意
全てのグループのリストと指定したグループのアイテムのリストを、仮想アイテムのみのAPIコールで取得することができます。他のグループのアイテムを操作する際にはフィルタリングを使用します。
全部のグループのリストを取得するには、アイテムグループリストを取得するAPIコールを使用します。指定したグループのアイテムのリストを取得するには、指定したグループによりアイテムリストを取得する APIコールにexternal_idパラメーターを渡します。

項目を絞り込む

必須なグループのアイテム絞り込むには:
  1. 以下のAPIコールでアイテムのリストを取得します:
  2. フィルタリングを使用して、groupsパラメータで指定した必須グループのexternal_idパラメータを持つアイテムを探します。
この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
最終更新日: 2024年10月3日

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

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