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

Порядок групп и товаров внутри них влияет на то, как каталог выглядит в вашем магазине — на сайте или в приложении. Правильно настроенный порядок помогает эффективнее работать с продажами: вы можете показывать пользователям популярные товары и группы в первую очередь.

При запросе списка групп товаров группы возвращаются в том порядке, в котором они отсортированы. Аналогично при запросе по группе товары возвращаются в порядке их сортировки. Товары без указанной группы автоматически попадают в группу Без группы — их нельзя сортировать и они не возвращаются при запросе товаров по группе.

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

• Добавление одного товара в несколько групп.
• Сортировка групп.
• Сортировка товаров в группе.

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

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

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

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

Чтобы создать группу:

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

3. Нажмите Создать группу.

4. Укажите необходимые параметры:
   • Внешний ID — уникальный ID группы.
   • Название группы.

5. Добавьте товары в группу (опционально). Если в вашем каталоге еще нет товаров, вы можете сохранить текущие настройки и вернуться к этому шагу позже.
6. В раскрывающемся списке выберите статус Группа включена, чтобы показывать группу в магазине.
7. Нажмите Создать.

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

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

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

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

Удаление группы

Вы можете удалять только группы, в которых нет товаров.

Чтобы удалить группу:

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Все товары.
2. В поле Фильтр выберите группу. Отобразятся все товары, которые в нее входят.

3. В столбце Группы снимите для каждого товара флажок группы, которая будет удалена.
4. Нажмите Изменить группы и порядок.
5. Нажмите значок ⋮ в строке нужной группы и в раскрывающемся списке выберите Удалить.

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

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

• при создании или редактировании товара в его основных настройках (на примере виртуальных предметов);

• в списке товаров каталога в столбце Группы для строки с товаром.

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

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

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

6. Нажмите Сохранить.

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

Чтобы отсортировать группы:

Настройка через методы 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.