Управление тем, какие метаполя товаров может использовать Shoply

Ваш ИИ-помощник по покупкам помогает клиентам: читает информацию о товарах, отвечает на вопросы и даёт рекомендации.

Однако не все данные о товарах предназначены для клиентов. Некоторые метаполя товаров могут содержать внутреннюю информацию (например, маржинальность), сведения о поставщиках или другие атрибуты, которые должны оставаться конфиденциальными. В таких случаях вы можете запретить Shoply использовать эти метаполя при ответах на вопросы клиентов.

Shoply использует ИИ, чтобы автоматически определять, какие метаполя можно использовать при ответах на вопросы клиентов. Но для полного контроля Shoply позволяет добавить в чёрный список (исключить) отдельные метаполя товаров или целые пространства имён метаполей.

В этом руководстве объясняется, зачем это нужно и как настроить такую конфигурацию.

Где найти расширенные настройки?

Откройте раздел “Settings” в панели администратора приложения, затем прокрутите страницу до раздела “Advanced Settings”. В этом разделе можно указать объект JSON для настройки различных параметров.

Настройки чёрного списка

Используйте эти настройки, чтобы запретить Shoply использовать определённые метаполя товаров при ответах на вопросы клиентов.

`blacklist_product_fields`

Список точных ключей метаполей (названий полей), которые нужно исключить. Название поля должно в точности совпадать с ключом метаполя в Shopify.

Примеры ключей метаполей:

start_date
product_type
backstock_number
upc
shipping_lead_time
brand

Примечание: если вы не хотите показывать поставщика товара, добавьте “brand” в чёрный список, поскольку по историческим причинам Shoply использует метаполе brand для хранения информации о поставщике.

`blacklist_display_filters`

Список точных ключей метаполей, которые нужно скрыть только в интерфейсе фильтров/фасетов. В отличие от blacklist_product_fields, эти поля по-прежнему доступны ИИ для ответов на вопросы клиентов — они просто не отображаются как выбираемые фильтры в интерфейсе поиска.

Это полезно, когда метаполе содержит ценную информацию о товаре, которую ИИ должен знать, но не подходит для фильтра, предназначенного для клиентов.

Примеры:

warehouse_region — полезный контекст для ИИ, но неинформативный фильтр для клиентов
care_instructions — помогает ИИ отвечать, но не является осмысленной категорией фильтра

`blacklist_namespaces`

Список целых пространств имён , которые ИИ должен игнорировать.

Пример:

RenterInfo

Если метаполе относится к пространству имён из чёрного списка, все поля этого пространства имён автоматически исключаются.

Это полезно, когда всё пространство имён содержит внутреннюю или конфиденциальную информацию.

Советы по настройке чёрного списка

Не рекомендуется добавлять в чёрный список такие поля, как:

Название товара
Описание
Материал
Размер, габариты или характеристики
Состав
Инструкции по уходу
Названия и параметры вариантов

(Эти данные помогают ИИ давать более полезные ответы.)

Обогащение данных о товарах с помощью тегов

`split_tag_to_metafield_by`

Теги Shopify — удобный способ помечать товары, но они хранятся как плоский список строк и не могут использоваться как структурированные фильтры. Этот параметр позволяет преобразовать теги в формате key:value в полноценные метаполя, которые Shoply может индексировать и использовать для фильтрации.

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

Укажите для split_tag_to_metafield_by символ-разделитель, используемый в тегах. Shoply разделит каждый тег по этому символу, будет считать левую часть ключом метаполя, правую — его значением и соответствующим образом проиндексирует их.

Например, если у ваших товаров есть такие теги:

plaintext


material:aluminum
color:matte-black
compatible-with:iPhone 15

Если задать разделитель ":", будут созданы метаполя:

Ключ	Значение
`material`	`aluminum`
`color`	`matte-black`
`compatible-with`	`iPhone 15`

Затем эти проиндексированные метаполя можно использовать как фасетные фильтры в поиске Shoply AI — так же, как стандартные метаполя Shopify.

Теги, не содержащие разделитель, игнорируются этим параметром и остаются обычными тегами.

Пример конфигурации:

json


{
  "split_tag_to_metafield_by": ":"
}

Когда это использовать:

В вашем магазине уже используются теги key:value для атрибутов (например, после массового импорта или из стороннего приложения)
Вы хотите добавить атрибуты, доступные для фильтрации, не создавая формальные определения метаполей Shopify
Вам нужен быстрый способ передать структурированные данные о товарах в Shoply, не переназначая теги каталога

Управление отображением товаров

Используйте эти настройки, чтобы управлять информацией, которая показывается при отображении товаров в чате или интерфейсе поиска.

`hide_discount`

Если установить значение true, проценты скидки (например, “-40%”) будут скрыты в карточках товаров. Это полезно, если вы не хотите акцентировать внимание клиентов на скидках.

`hide_price`

Если установить значение true, вся информация о ценах будет скрыта, включая исходные цены и цены со скидкой. Используйте этот параметр, если хотите, чтобы клиенты переходили на страницу товара для просмотра цены, или если ваша ценовая стратегия предполагает скрытие цен в интерфейсе чата/поиска.

`hide_review`

Если установить значение true, оценки отзывов не будут показываться в карточках товаров. Это полезно, если вы не хотите, чтобы оценки отзывов влияли на решения клиентов в интерфейсе чата/поиска.

Пример допустимого объекта JSON

Ниже приведён полностью допустимый пример:

json


{
  "blacklist_product_fields": [
    "profit_margin",
    "inventory_level"
  ],
  "blacklist_display_filters": [
    "product_type",
    "category_name",
    "warehouse_region",
    "care_instructions"
  ],
  "blacklist_namespaces": [
    "SupplierInfo"
  ],
  "split_tag_to_metafield_by": ":",
  "hide_discount": true,
  "hide_price": false,
  "hide_review": false
}

Вы можете удалить ненужные элементы или добавить собственные ключи метаполей и пространства имён. Установите параметры hide_* в значение true или false в соответствии со своими предпочтениями.

Управление тем, какие метаполя товаров может использовать Shoply

Где найти расширенные настройки?

Настройки чёрного списка

blacklist_product_fields

blacklist_display_filters

blacklist_namespaces