How to group items in catalog

You can add items in groups to create a multilevel catalog. The group can include both the same and different types of items: virtual items, virtual currency, packages of virtual currency, bundles, physical goods, and game keys.

Main features:

• Add the same item in several groups.
• Add smaller groups to bigger ones to create a multilevel catalog.
• Change the order of the groups.

Set up groups in one of the following ways:

• via Publisher Account (only for virtual items)
• via API calls

Set up via Publisher Account

Create group

Follow the virtual items configuration instruction to create a group for virtual items via Publisher Account.

Edit group

To edit a group:

1. Go to Store > Virtual Items and click the ••• icon. Click Edit group in the pop-up menu.

2. Specify a new group ID and change the group name and location. You can also toggle the group display in Store.

3. Save changs.

Add item to group

To add a virtual item to a required group, specify the group when creating a new item or editing the existing item.

Set up via API calls

Contact your Account Manager to create a new group or change the existing group via API calls.

Add item to group

To add an item to the existing group via API calls, pass the external_id parameter to API calls for creating or updating the items:

• Game keys: Use the Create game, Update game by SKU, and Update game by ID API calls.
• Virtual items: Use the Create virtual item and Update virtual item API calls.
• Virtual currency: Use the Create virtual currency and Update virtual currency API calls.
• Packages of virtual currency: Use the Create virtual currency package and Update virtual currency package API calls.
• Bundles: Use the Create bundle and Update bundle API calls.
• Physical goods: Use the Create a new physical item and Update physical item API calls.

Example of the request:

{
   "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": [
      {
         "external_id": "string"
      }
   ]
}

Get list of groups

To get the list of all groups, use the Get items group list API call. To get the list of items of the specified group, pass the external_id parameter to the Get items list by specified group API call.

Filter items

To filter items of the required group:

1. Get the list of items via the following API calls:
   • Game keys: Get games list API call.
   • Virtual currency: Get virtual currency list API call.
   • Packages of virtual currency: Get virtual currency package list API call.
   • Bundles: Get list of bundles API call.
   • Physical goods: Get physical items list API call.
2. Using the filtering, find the items with the external_id parameter of the required group specified in the groups parameter.