如何控制 Shoply 可以使用哪些产品 metafield

您的 AI Shopping Assistant 旨在通过读取您的产品信息、回答问题并提供推荐来帮助客户。

但是，并非所有产品数据都适合展示给客户。某些产品 metafield 可能包含内部信息（例如利润率）、供应商详情，或其他应保持私密的属性。在这些情况下，您可能希望 Shoply 在回答客户问题时不要使用这些 metafield。

Shoply 使用 AI 自动判断哪些 metafield 可用于回答客户问题。不过，为了让您拥有完全的控制权，Shoply 允许您将特定产品 metafield 或整个 metafield namespace 设置为黑名单（排除）。

本指南将说明这为什么有用以及如何进行配置。

在哪里可以找到高级设置？

前往应用管理控制台中的“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 在回答客户问题时使用特定的产品 metafield。

如果您想隐藏整个商品而不是单独的字段，请将整个产品排除在索引之外。

`blacklist_product_fields`

一个您希望排除的精确 metafield 键名（字段名称）列表。字段名称必须与 Shopify 中显示的 metafield 键完全一致。

metafield 键示例：

start_date
product_type
backstock_number
upc
shipping_lead_time
brand

注意：如果您不想展示产品的 vendor，您需要将 “brand” 添加到黑名单中，因为出于历史原因，Shoply 使用 brand metafield 来存储 vendor 信息。

`blacklist_display_filters`

一个仅用于从筛选/分面 UI 中隐藏的精确 metafield 键名列表。与 blacklist_product_fields 不同，这些字段仍可供 AI 使用来回答客户问题——它们只是不会在搜索界面中显示为可选筛选器。

有关会显示哪些属性的背景信息，请参阅Shoply 如何生成产品筛选器。

当某个 metafield 包含 AI 应该了解的有价值产品信息，但不适合作为面向客户的筛选器时，这会很有用。

示例：

warehouse_region — 对 AI 来说是有帮助的上下文信息，但对客户来说不是有用的筛选器
care_instructions — 适合 AI 回答使用，但不是一个有意义的筛选类别

`blacklist_namespaces`

一个您希望 AI 忽略的完整的 namespace 列表。

示例：

RenterInfo

如果某个 metafield 属于已列入黑名单的 namespace，该 namespace 中的所有字段都会被自动排除。

当整个 namespace 都是内部或敏感信息时，这非常有用。

黑名单使用建议

建议加入黑名单的内容：

供应商代码
仓库 / 库存详情
内部履约备注
被其他应用使用的 metafield
任何不应对客户可见的字段

避免将以下字段加入黑名单：

产品标题
描述
材质
尺寸、规格或参数
成分
保养说明
变体名称/选项

（这些有助于 AI 给出更好的回答。）

从标签丰富产品数据

`split_tag_to_metafield_by`

Shopify 标签是为产品打标签的便捷方式，但它们以扁平的字符串列表形式存储，无法作为结构化筛选器使用。此设置允许您将 key:value 形式的标签转换为 Shoply 可索引并可用于筛选的正式 metafield。

工作原理：

将 split_tag_to_metafield_by 设置为您的标签中使用的分隔符字符。Shoply 会按该字符拆分每个标签，将左侧视为 metafield 键，将右侧视为值，并据此进行索引。

例如，如果您的产品带有如下标签：

plaintext


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

将分隔符设置为 ":" 后，将生成以下 metafield：

键	值
`material`	`aluminum`
`color`	`matte-black`
`compatible-with`	`iPhone 15`

这些已索引的 metafield 随后可在 Shoply AI Search 中用作分面筛选器——就像原生 Shopify metafield 一样。

不包含该分隔符的标签将被此设置忽略，并保留为普通标签。

配置示例：

json


{
  "split_tag_to_metafield_by": ":"
}

适用场景：

您的商店已经使用 key:value 标签来表示属性（例如来自批量导入或第三方应用）
您希望在不创建正式 Shopify metafield 定义的情况下添加可筛选属性
您需要一种快速方式，在无需重新为目录打标签的前提下，将结构化产品数据提供给 Shoply

控制产品显示

使用这些设置可控制在聊天或搜索界面中显示产品时展示哪些信息。

如果您想对保留的字段进行视觉上的调整，可以使用 CSS 自定义 product-card 样式。

`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
}

您可以删除不需要的项目，或添加您自己的 metafield 键名和 namespace。根据您的偏好，将 hide_* 选项设置为 true 或 false。