如何控制 Shoply 可以使用哪些產品中繼欄位

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

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

Shoply 會使用 AI 自動判斷哪些中繼欄位可用於回答顧客問題。不過，為了讓您擁有完整控制權，Shoply 也允許您將特定產品中繼欄位或整個中繼欄位命名空間設為黑名單（排除）。

本指南將說明這樣做為什麼有幫助，以及如何進行設定。

在哪裡可以找到進階設定？

請前往應用程式管理控制台中的「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 自訂 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
}

您可以移除不需要的項目，或加入您自己的中繼欄位鍵值與命名空間。請依照您的偏好，將 hide_* 選項設為 true 或 false。