控制 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`

只在篩選器／Facet 介面中隱藏的確切中繼資料鍵清單。與 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`

這些已建立索引的中繼資料欄位，之後就能在 Shoply AI Search 中作為 Facet 篩選條件使用，就像 Shopify 原生中繼資料欄位一樣。

不包含分隔字元的標籤會被這項設定忽略，並保留為一般標籤。

設定範例：

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。