Внутриигровой магазин / Атрибуты товара
 На главную

Внутриигровой магазин

  • Руководство по интеграции

  • Возможности

  • Инструкции

  • Расширения

  • Справочники

  • Вебхуки

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    1. Укажите External ID и значение атрибута товара.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Примечание
    Одному товару может соответствовать несколько значений одного атрибута, но не более 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",
    
       },
       ...
    ]

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

    В другой раз

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

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

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