Проверка категорий товара
Категории товаров описывают, что представляет собой товар, обычно в виде иерархии от широкого корневого уровня к конкретному уровню листа — например, ["Footwear", "Athletic", "Running Shoes"]. Точные категории поддерживают чистоту каталога и подпитывают такие последующие процессы, как классификация и торговое соответствие, где неправильно категоризированный товар может привести к неправильному результату.
Каталоги накапливают ошибки в категориях с течением времени — из-за ручного ввода, подачи поставщиков или миграции между системами. Zonos Category Validation проверяет, правильно ли категории, назначенные товару, описывают этот товар, и когда они не совпадают, предлагает лучшие категории, выбранные из категорий, которые использует ваша организация.
Как это работает
Zonos Category Validation использует искусственный интеллект для оценки того, правильно ли предоставленная вами иерархия категорий описывает товар на основе названия товара и любых дополнительных деталей, которые вы предоставляете, такие как brand, material и description.
Для каждого товара он возвращает verdict либо CORRECT, либо WRONG наряду с оценкой уверенности. Когда вердикт — WRONG, он возвращает ранжированный список предложенных категорий, чтобы вы могли исправить назначение. Предложения черпаются из дерева категорий вашей организации — набора путей категорий, которые использует ваша организация — и любые представленные вами категории автоматически добавляются в это дерево, поэтому хорошо поддерживаемое дерево дает лучшие предложения с течением времени.
Это батник-конечная точка — вы можете проверить множество товаров в одном запросе, и результаты возвращаются в том же порядке, что и входные данные.
Вердикт и уверенность
Каждый результат включает verdict:
CORRECT— товар правдоподобно принадлежит к назначенным категориям.WRONG— товар не принадлежит к назначенным категориям.
Каждый результат также включает confidenceScore между 0.0 и 1.0, указывающий уровень уверенности модели в возвращаемом вердикте. Оценка отражает уверенность в самом вердикте, поэтому уверенный результат WRONG имеет высокий confidenceScore так же, как уверенный результат CORRECT. Когда вердикт — WRONG, список suggestedCategories содержит альтернативные иерархии категорий, каждая с значением confidence и отсортированные от наиболее к наименее вероятным. Когда вердикт — CORRECT, suggestedCategories пусто.
Мы рекомендуем использовать оценку уверенности для определения того, какие результаты принять автоматически, а какие направить на ручное рассмотрение.
Проверка категорий
Чтобы проверить категории, используйте мутацию categoriesValidate. Каждый товар требует name и иерархию categories для проверки. Вы можете дополнительно включить brand, material, description, amount, currencyCode, globalTradeItemNumber и imageUrl для повышения точности. Отправляйте несколько товаров в одном запросе для массовой проверки.
mutation CategoriesValidate($input: [CategoryValidateInput!]!) { categoriesValidate(input: $input) { id name categories verdict confidenceScore suggestedCategories { category confidence } }}В примере выше категории первого товара подтверждаются как CORRECT с высокой уверенностью и без предложений. Второй товар уверенно отмечен как WRONG, а список suggestedCategories предлагает более подходящие категории, ранжированные по уверенности.
Управление деревом категорий
Дерево категорий вашей организации — это набор путей категорий, которые Zonos знает, что использует ваша организация. Проверка категорий использует suggestedCategories из этого дерева, поэтому поддержание его точности и полноты напрямую улучшает качество предложений. Категории, которые вы отправляете categoriesValidate, автоматически добавляются в дерево, но вы также можете управлять им напрямую.
Каждая категория — это иерархия, хранящаяся как массив path, от широкого корня к конкретному листу — например, ["Footwear", "Athletic", "Running Shoes"].
Список ваших категорий
Используйте запрос categories для получения дерева категорий вашей организации. Результаты разбиты на страницы.
query Categories { categories(first: 50) { totalCount edges { node { id path } } }}Добавление категорий
Используйте мутацию categoriesCreate для добавления одного или нескольких путей категорий в ваше дерево. Это полезно для инициализации дерева перед проверкой, чтобы предложения могли использовать вашу полную таксономию.
mutation CategoriesCreate($input: [CategoryCreateInput!]!) { categoriesCreate(input: $input) { id path }}Обновление или удаление категорий
Используйте мутацию categoryUpdate для исправления path категории по её id, или мутацию categoryDelete для удаления категории, которая больше не применяется. Удаление устаревших или неправильных категорий сохраняет релевантность предложений.
mutation CategoryUpdate($input: CategoryUpdateInput!) { categoryUpdate(input: $input) { id path }}Чтобы удалить категорию, передайте её id мутации categoryDelete. Она возвращает SUCCESS или FAILURE.
mutation CategoryDelete($id: ID!) { categoryDelete(id: $id)}
Проверка категорий
Проверьте, соответствуют ли назначенные категории товара, и получите более подходящие предложения категорий, если они не совпадают.