Как группировать и сортировать товары в каталоге

Вы можете объединять товары в группы. Группа может включать в себя товары одного или разных видов:

• виртуальные предметы;
• виртуальную валюту;
• пакеты виртуальной валюты;
• бандлы;
• игровые ключи.

Основные возможности:

• Добавление одного товара в несколько групп.
• Изменение порядка расположения групп.

Настройте группы:

1. Создайте и отредактируйте группы в Личном кабинете.
2. Добавьте предметы и получите информацию о группах:
   • через Личный кабинет
   • методы API

Настройка через Личный кабинет

Создание группы

Чтобы создать группу виртуальных предметов:

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Все товары.
2. Нажмите Добавить и в раскрывающемся списке выберите Группа.

3. Задайте необходимые параметры:
   • External ID — уникальный ID группы;
   • Название группы.
4. Установите переключатель Показывать группу в магазине в положение Вкл.
5. Нажмите Создать группу.

Редактирование группы

Чтобы отредактировать группу:

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Все товары.
2. Нажмите Показать группу.
3. Нажмите ⋮ рядом с нужной группой и в выпадающем списке выберите Редактировать.

4. Сделайте необходимые изменения и нажмите Сохранить изменения.

Добавление товара в группу

Чтобы добавить виртуальный предмет в нужную группу, укажите ее:

• при создании нового предмета;
• редактировании существующего предмета в Личном кабинете:
  • в основных настройках предмета;

• • в раскрывающемся списке групп в списке виртуальных предметов.

Сортировка товаров

Чтобы отсортировать товары (на примере виртуальных предметов):

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Все предметы.
2. Нажмите Показать группу.
3. Перейдите в нужную вам группу.
4. Наведите курсор на номер виртуального предмета. Отобразится значок ☰. Перетащите виртуальный предмет в нужную позицию.

Сортировка групп

Чтобы отсортировать товары (на примере виртуальных предметов):

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Все предметы.
2. Нажмите Показать группу.
3. Наведите курсор на название группы. Отобразится значок ☰. Перетащите группу в нужную позицию.

Настройка через методы API

Добавление товара в группу

Чтобы добавить товар в существующую группу с помощью методов API, передайте в поле group массив, содержащий параметр external_id групп, в которые должен входить предмет:

• Игровые ключи — используйте методы API Создание игры, Обновление игры по артикулу, Обновление игры по ID.
• Виртуальные предметы — используйте методы API Создание виртуального предмета, Обновление виртуального предмета.
• Виртуальная валюта — используйте методы API Создание виртуальной валюты, Обновление виртуальной валюты.
• Пакеты виртуальной валюты — используйте методы API Создание пакета виртуальной валюты, Обновление пакета виртуальной валюты.
• Бандлы — используйте методы API Создание бандла, Обновление бандла.

Пример запроса:

 1{
 2  "sku": "sword",
 3  "name": {
 4    "en": "Sword"
 5  },
 6  "is_enabled": true,
 7  "is_free": false,
 8  "order": 1,
 9  "description": {
10    "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."
11  },
12  "prices": [
13    {
14      "amount": 100,
15      "currency": "USD",
16      "is_enabled": true,
17      "is_default": true
18    }
19  ],
20  "vc_prices": [],
21  "is_show_in_store": true,
22  "groups": [
23    "chests",
24    "bonus"
25  ]
26}

Получение списка групп

Чтобы получить список всех групп, используйте метод Получение списка групп товаров. Чтобы получить список предметов определенной группы, передайте в метод Получение списка товаров по указанной группе параметр external_id.

Фильтрация товаров

Чтобы отфильтровать товары нужной группы:

1. Получите список товаров с помощью следующих методов API:
   • Получение списка игр
   • Получение списка виртуальных валют
   • Получение списка пакетов виртуальной валюты
   • Получение списка бандлов
2. Используя фильтрацию, найдите товары с external_id нужной группы, указанным в параметре groups.