如何控制 Shoply 可使用哪些產品 Metafield

您的 AI Shopping Assistant 旨在透過讀取產品資訊、回答問題及提供推薦，協助顧客選購。

不過，並非所有產品資料都適合向顧客展示。某些產品 metafield 可能包含內部資訊（例如利潤率）、供應商資料，或其他應保持私隱的屬性。在這些情況下，您可能會希望 Shoply 在回答顧客問題時不要使用這些 metafield。

Shoply 會使用 AI 自動判斷哪些 metafield 可用於回答顧客問題。不過，為了讓您擁有完整控制權，Shoply 亦容許您將特定產品 metafield 或整個 metafield namespace 設定為黑名單（排除）。

本指南會說明這樣做的原因，以及如何進行設定。

在哪裡找到 Advanced Settings？

前往應用程式管理控制台中的「Settings」部分，然後向下捲動至「Advanced Settings」部分。在此部分中，您可以提供一個 JSON object 來設定各種選項。

如需了解更廣泛的資料政策，請參閱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 key（欄位名稱）清單。欄位名稱必須與 Shopify 中顯示的 metafield key 完全一致。

metafield key 範例：

start_date
product_type
backstock_number
upc
shipping_lead_time
brand

注意：如果您不想顯示產品的 vendor，您需要將「brand」加入黑名單，因為 Shoply 基於歷史原因使用 brand metafield 來儲存 vendor 資訊。

`blacklist_display_filters`

只會從篩選／facet UI 中隱藏的精確 metafield key 清單。與 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 tags 是標記產品的方便方式，但它們是以扁平字串清單形式儲存，無法作為結構化篩選條件使用。此設定可讓您將 key:value 形式的 tags 轉換為適當的 metafield，供 Shoply 建立索引並用於篩選。

運作方式：

將 split_tag_to_metafield_by 設定為您在 tags 中使用的分隔字元。Shoply 會按該字元拆分每個 tag，把左邊視為 metafield key，右邊視為 value，並據此建立索引。

例如，如果您的產品帶有以下 tags：

plaintext


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

將分隔符設為 ":" 會產生以下 metafield：

Key	Value
`material`	`aluminum`
`color`	`matte-black`
`compatible-with`	`iPhone 15`

這些已建立索引的 metafield 之後可在 Shoply AI Search 中用作 facet filters——就像原生 Shopify metafield 一樣。

不包含該分隔字元的 tags 會被此設定忽略，並保留為一般 tags。

設定範例：

json


{
  "split_tag_to_metafield_by": ":"
}

適用情況：

您的商店已經使用 key:value tags 來表示屬性（例如來自批量匯入或第三方應用程式）
您希望在不建立正式 Shopify metafield 定義的情況下，加入可篩選的屬性
您需要一個快速方式，無需重新標記整個產品目錄，即可向 Shoply 提供結構化產品資料

控制產品顯示

使用這些設定來控制當產品顯示於聊天或搜尋介面時，會展示哪些資訊。

如果您想對保留的欄位作視覺上的調整，您可以使用 CSS 自訂 product-card 樣式。

`hide_discount`

當設為 true 時，折扣百分比（例如「-40%」）將不會在產品顯示中出現。如果您不希望向顧客強調折扣，這會非常有用。

`hide_price`

當設為 true 時，所有價格資訊都會被隱藏，包括原價及折扣後價格。如果您希望顧客前往產品頁面查看價格，或您的定價策略需要在聊天／搜尋介面中隱藏價格，便可使用此設定。

`hide_review`

當設為 true 時，產品顯示中將不會展示評論評分。如果您不希望評論分數在聊天／搜尋介面中影響顧客決策，這會非常有用。

有效 JSON object 範例

以下是一個完全有效的範例：

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 key 和 namespace。請根據您的偏好，將 hide_* 選項設為 true 或 false。