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:
- Go to Store > Virtual Items and click the ••• icon. Click Edit group in the pop-up menu.
- Specify a new group ID and change the group name and location. You can also toggle the group display in Store.
- Save changs.
- Won’t return in the response to the
Get items groups list API call. - Won’t appear in the properties of items that belong to this group when calling the APIs for getting the list of items.
- Can be used for creating a catalog structure in Publisher Account.
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 , andUpdate game by ID API calls. - Virtual items: Use the
Create virtual item andUpdate virtual item API calls. - Virtual currency: Use the
Create virtual currency andUpdate virtual currency API calls. - Packages of virtual currency: Use the
Create virtual currency package andUpdate virtual currency package API calls. - Bundles: Use the
Create bundle andUpdate bundle API calls. - Physical goods: Use the
Create a new physical item andUpdate physical item API calls.
Example of the request:
- http
{
"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 external_id
parameter to the
Filter items
To filter items of the required group:
- 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.
- Game keys:
- Using the filtering, find the items with the
external_id
parameter of the required group specified in thegroups
parameter.
Was this article helpful?
Rate this page
Don’t want to answer
Thank you for your feedback!
Found a typo or other text error? Select the text and press Ctrl+Enter.