Атрибуты товара

Атрибуты — это характеристики товара, с помощью которых можно предоставить дополнительную информацию о нем пользователю.

Атрибутом может быть цвет и размер предмета, уровень пользователя, на котором предмет становится ему доступен, событие в игре.

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

• фильтрация товаров в магазине;
• определение вариантов товара (например, красный шлем, синий шлем) и отображение их на карточке товара;
• назначение дополнительных характеристик для товара.

Примеры атрибутов товара и их значений:

Как это работает

1. Вы создаете атрибуты товара и их значения и привязываете их к товару:

• через Личный кабинет или через методы API с указанием External ID атрибутов товара и External ID значений;
• через Личный кабинет c указанием атрибутов и их значений в формате JSON.

2. Вы используете методы подраздела Catalog из группы методов Virtual Items & Currency или Game Keys для запроса каталога товаров. Данные по атрибутам возвращаются:

• В массиве attributes, если атрибуты созданы через Личный кабинет или API с указанием External ID атрибутов товара и External ID значений.
• В массиве custom_attributes, если атрибуты и значения добавлены через JSON. Для этого в запросе на получение каталога необходимо передать параметр additional_fields со значением custom_attributes.

3. Пользователь совершает покупку. Если атрибуты и значения добавлены через JSON, данные об атрибутах товара передаются в вебхуках Успешная оплата заказа и Отмена заказа в массиве custom_attributes.

Сценарий интеграции

Вы можете создать атрибуты товара и их значения на своей стороне и добавить их к товару в формате JSON в Личном кабинете.

Также вы можете создать атрибуты и их значения на стороне Xsolla и добавить их к товарам. Для этого:

1. Создайте атрибуты и их значения.
2. Настройте связь между атрибутами и товарами.

Создание и настройка атрибутов товара и их значений

Каждый атрибут товара имеет следующие параметры:

• External ID — уникальный ID атрибута, который передается в параметре external_id в теле запроса. Укажите ID атрибута в вашей системе или создайте новый.
• Название (указывается для каждого языка, настроенного в проекте).

• Список значений.

• External ID родительского атрибута товара.
• External ID значения — уникальный ID значения, который передается в параметре external_id в параметрах пути. Укажите ID значения в вашей системе или создайте новый.

• Название (указывается для каждого языка, настроенного в проекте).

• в Личном кабинете;
• через методы API.

Создание атрибутов и их значений в Личном кабинете

1. Откройте проект в Личном кабинете.
2. Перейдите в раздел Store > Управление каталогом.

3. В разделе Атрибуты товара нажмите Настроить.
4. Нажмите Создать атрибут товара.
5. Укажите External ID и название атрибута товара.
6. Нажмите Сохранить и продолжить.
7. Задайте необходимые значения для созданного атрибута товара. Для каждого значения укажите External ID. Чтобы добавить еще одно значение, нажмите +.
8. Нажмите Сохранить и продолжить.

Создание атрибутов и их значений через методы API

Для создания и управления атрибутами товара и их значениями используйте методы подраздела Admin из группы методов Item attributes.

Методы для создания атрибутов и управления ими:

• Create attribute
• Update attribute
• Get specified attribute
• Delete attribute

• Get the list of attributes for administration

• Create attribute value
• Delete all values of attribute
• Update attribute value
• Delete attribute value

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

Добавьте созданные атрибуты и значения к товарам:

• через Личный кабинет;
• методы API.

Добавление существующих атрибутов через Личный кабинет

1. Откройте проект в Личном кабинете.
2. В боковом меню нажмите Store.
3. Перейдите в раздел с нужным типом товаров:
   • Виртуальные предметы;
   • Виртуальная валюта;
   • Игровые ключи;
   • Бандлы.
4. Создайте новый товар или отредактируйте существующий.
5. В разделе Атрибуты товара установите переключатель Выбрать существующие атрибуты или создать новые в положение Вкл.
6. В появившемся поле Атрибут товара выберите ID, соответствующий нужному атрибуту товара.
7. В появившемся поле Значение выберите ID, соответствующий нужному значению атрибута товара.

Добавление существующих атрибутов через методы API

В метод Create virtual item или Update virtual item передайте массив объектов с External ID атрибутов товара и External ID их значений, которые требуется привязать.

Пример массива с атрибутами и их значениями:

  "attributes": [
    {
      "external_id": "craft-materials",
      "name": {
        "en": "Craft materials"
      },
      "values": [
        {
          "external_id": "steel",
          "value": {
            "en-US": "5"
          }
        },
        {
          "external_id": "leather",
          "value": {
            "en-US": "1"
          }
        }
      ]
    }
  ],

Добавление атрибутов из JSON через Личный кабинет

Вы можете добавить атрибуты и их значения в формате JSON при создании или редактировании всех типов товаров, таких как:

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

Для этого:

1. Откройте проект в Личном кабинете.
2. В боковом меню нажмите Store.
3. Перейдите в раздел с нужным типом товаров:
   • Виртуальные предметы;
   • Виртуальная валюта;
   • Игровые ключи;
   • Бандлы.
4. Создайте новый товар или отредактируйте существующий.
5. В блоке Атрибуты товара установите переключатель Добавить атрибуты из JSON в положение Вкл.

6. В отобразившуюся текстовую область добавьте перечень атрибутов и их значений в формате JSON.