控制 Shoply 可以使用哪些商品元字段

你的 AI 购物助手会读取商品信息、回答问题并提供推荐，从而帮助顾客。

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

Shoply 会使用 AI 自动判断回答顾客问题时可以使用哪些元字段。不过，为了让你拥有完全的控制权，Shoply 允许你将特定商品元字段或整个元字段命名空间设置为黑名单（排除）。

本指南将说明这一功能的用途和配置方法。

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

前往应用管理后台的“设置”部分，然后向下滚动到“高级设置”。你可以在这里提供一个 JSON 对象来配置各种设置。

黑名单设置

使用以下设置，阻止 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 仍可使用这些字段回答顾客问题，只是搜索界面不会将它们显示为可选筛选条件。

如果某个元字段包含 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`

这些已索引的元字段之后可以像原生 Shopify 元字段一样，在 Shoply AI Search 中用作分面筛选条件。

不包含分隔符的标签会被此设置忽略，并继续作为普通标签保留。

配置示例：

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。