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

Ваш AI Shopping Assistant создан, чтобы помогать покупателям: считывать информацию о товарах, отвечать на вопросы и давать рекомендации.

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

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

В этом руководстве объясняется, почему это полезно и как это настроить.

Где найти Advanced Settings?

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

Для более широкой политики данных ознакомьтесь с тем, какую информацию может использовать Shoply.

Settings → Advanced Settings is the editor used for the configuration below. The screenshot shows the demo store’s existing configuration; use the keys explained in this guide. Click the screenshot to view it at full size.

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

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

Чтобы скрыть товар целиком, а не отдельные поля, исключите товары целиком из индексации.

`blacklist_product_fields`

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

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

start_date
product_type
backstock_number
upc
shipping_lead_time
brand

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

`blacklist_display_filters`

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

Чтобы понять, какие атрибуты отображаются, см. как Shoply генерирует фильтры товаров.

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

Пример:

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

`blacklist_namespaces`

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

Пример:

RenterInfo

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

Это полезно, когда всё пространство имён является внутренним или чувствительным.

Советы по использованию чёрного списка

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

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

(Они помогают AI давать более качественные ответы.)

Обогащение данных о товарах из тегов

`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 Search — так же, как и нативные метаполя Shopify.

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

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

json


{
  "split_tag_to_metafield_by": ":"
}

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

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

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

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

Для визуальных изменений полей, которые вы оставляете, вы можете настроить стилизацию карточек товаров с помощью CSS.

`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

Где найти Advanced Settings?

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

blacklist_product_fields

blacklist_display_filters

blacklist_namespaces