Атрибуты

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

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

  • назначение дополнительных характеристик для товара;
  • привязка товаров к событиям или условиям.

Примеры атрибутов

Вид товараНазвание атрибутаЗначения атрибута
Игровые ключиТип игрыНовая, Ранний доступ, Скоро, Особенное
ЖанрЭкшн, Приключения, Казуальная, Симулятор, Стратегия, RPG
Виртуальные предметыКачествоЭпик, Легендарный, Обычный
КлассВоин, Паладин, Охотник, Шаман, Друид
Виртуальная валютаСобытиеНовый год
КвестЗавершение квеста 1, Завершение квеста 2

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

  1. Настройте атрибуты.
  2. Настройте значения атрибутов.
  3. Настройте атрибуты для товара.

Настройка атрибутов

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

  • External ID — уникальный идентификатор атрибута;
  • название (указывается для каждого языка, настроенного в проекте);
  • список значений.

Создать и настроить атрибуты можно следующими способами:

  1. Через Личный кабинет.
  2. Через методы API.

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

  1. Перейдите в раздел Магазин > Управление каталогом.

  1. В разделе Атрибуты нажмите Настроить.

  1. Нажмите Создать атрибут.

  1. Укажите External ID и название значения.

  1. Нажмите Сохранить и продолжить.

  1. Задайте необходимые значения для созданного атрибута. Для каждого значения укажите External ID. Чтобы добавить еще одно значение, нажмите +.

  1. Нажмите Завершить.

Note
Количество атрибутов в проекте не ограничено.

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

Для настройки атрибутов через методы API используйте методы подраздела Admin из группы методов Attributes:

Notice
При удалении атрибута удаляются значения атрибута и связи с товарами. После выполнения операции восстановление этих данных невозможно.

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

Каждое значение атрибута имеет следующие параметры:

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

Создать и настроить значения атрибутов можно двумя способами:

  1. Через Личный кабинет.
  2. Через методы API.

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

  1. Перейдите в раздел Магазин > Управление каталогом.

  1. В разделе Атрибуты нажмите Настроить.

  1. В списке атрибутов выберите нужный атрибут.

  1. Перейдите на вкладку Значения и нажмите Создать значение.

  1. Укажите External ID и название значения.

  1. Нажмите Сохранить изменения.

Note
Для одного атрибута по умолчанию может быть задано не более 20 значений. Для изменения этого ограничения обратитесь к аккаунт-менеджеру проекта.

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

Для настройки атрибутов через методы API используйте методы подраздела Admin из группы методов Attributes:

Notice
При удалении значения атрибута удаляются его связи с товарами. После выполнения операции восстановление этих данных невозможно.

Настройка атрибутов для товара

Привязать атрибуты к товарам можно двумя способами:

  1. Через Личный кабинет.
  2. Через методы API.

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

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

  1. Перейдите в раздел Магазин.
  2. Перейдите в раздел с нужным типом товаров:
    • Виртуальные предметы.
    • Виртуальная валюта.
    • Игровые ключи.
    • Бандлы.

  1. Создайте новый товар или отредактируйте существующий.
  2. На этапе заполнения общей информации о товаре выберите созданный ранее атрибут в разделе Атрибут.

Note
По умолчанию для каждого товара может быть настроено не более 20 атрибутов. Для изменения этого ограничения обратитесь к аккаунт-менеджеру проекта.

  1. В появившемся поле Значение выберите идентификатор, соответствующий нужному значению атрибута.

Note
Одному товару может соответствовать несколько значений одного атрибута, но не более 6. Для изменения этого ограничения обратитесь к аккаунт-менеджеру проекта.

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

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

Copy
Full screen
Small screen
"attributes": [
   {
     "external_id": "craft-materials",

     "values": [
       {
         "external_id": "steel",

       },
       {
         "external_id": "leather",

   },
   ...
]

Note
При получении товара с помощью методов API в ответе также возвращается список соответствующих ему атрибутов и их значений.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Оценить страницу
Оценить страницу
Что может сделать страницу еще лучше?

В другой раз

Спасибо за обратную связь!
Последнее обновление: 25 июня 2021

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!