本頁說明建立目錄資訊和填入目錄資料的最佳做法。
總覽
目錄是產品物件的集合。
匯入 AI Commerce Search 的目錄資料會直接影響產生的模型品質，進而影響搜尋和建議結果的品質。一般來說，提供的目錄資訊越準確且具體，模型品質就越高。
請務必隨時更新目錄。你可以視需要上傳目錄變更，如果目錄變更頻率高，建議每天上傳。你可以上傳 (修補) 現有產品項目，系統只會更新變更的欄位。上傳目錄資訊不會產生費用，詳情請參閱「保持目錄為最新狀態」一文。
目錄分支版本
可搜尋的目錄分支版本
如果您使用搜尋功能，可以先透過目錄分支測試離線上傳的新資料，再將資料發布到網站上。
最多可使用三個分支，分別為 0、1 和 2。您的上線網站會指向 default_branch，以取得目錄資料。使用 setDefaultBranch 或 Gemini Enterprise for Customer Experience 控制台的 AI Commerce Search 中的「資料」分頁，指定哪個分支是你的即時 default_branch (預設為分支 0)。網站會使用 default_branch 指向的分支版本提供的目錄資料。
舉例來說，假設 default_branch 設為分店 ID 0，因此網站會使用你上傳至該分店的目錄資料。你可以將新的產品目錄資料上傳至分支 1 並預覽。確認目錄已正確上傳後，即可切換至分支 1 做為正式版 default_branch。
切換分支後，目錄快取最多可能需要 30 分鐘才會更新。
如果您使用建議，請只使用預設分支，因為分支切換期間更新會延遲。如果分支版本之間的資料差異很大，更新延遲可能會對預測結果造成負面影響。
必要產品資訊
以下是必填欄位，在目錄中建立產品項目時，必須提供這些欄位的值。這些值也應與內部產品資料庫中使用的值相符，並準確反映所代表的產品，因為這些值會納入模型訓練。
在某些情況下，其他欄位也必須填寫。如需所有產品欄位的完整清單，請參閱Product參考頁面。
你提供的所有產品資訊，都可用於提升推薦內容和搜尋結果的品質。請務必盡可能提供多個欄位。
| 欄位 | 附註 |
|---|---|
name
|
產品的完整專屬資源名稱。除了 import 以外的所有 Product 方法都必須提供這項資訊。匯入時，系統會自動產生名稱，不需要手動提供。
|
id
|
產品資料庫使用的產品 ID。ID 欄位在整個目錄中不得重複。記錄使用者事件時會使用相同的值，predict 和 search 方法也會傳回這個值。
|
title
|
產品資料庫中的產品名稱。採用 UTF-8 編碼的字串。 最多 1250 個半形字元。 |
categories
|
產品類別。每項產品都必須指派至少一個類別。
如果產品屬於多個類別，請為每個類別重複填寫這個欄位。
這個值必須是 UTF-8 編碼的非空白字串，長度上限為 5,000 個字元。請務必指定完整類別路徑，例如：
["Sports & Fitness > Athletic Clothing > Shoes"]。
|
目錄類別
本節說明目錄結構，以及如何指定目錄用於分類和篩選。
目錄結構
目錄中的 categories 欄位應包含各產品最精細的類別路徑。不必提供上層類別，也不應提供。
以下舉例說明如何規劃目錄結構：
- 正確：
categories: ["Flowers, Cards, Occasion > Seasonal Items > Christmas"] - 錯誤：
categories: ["Flowers, Cards, Occasion", "Flowers, Cards, Occasion > Seasonal Items", "Flowers, Cards, Occasion > Seasonal Items > Christmas"]
父項類別
特定產品的父類別不應包含在 categories 欄位中。瀏覽篩選條件應使用其他自訂屬性處理。
類別命名
請謹慎選擇類別名稱，避免導入錯誤的關鍵字，並提升成效。使用更具體且準確的字詞，可提高關聯性並減少問題。
- 建議：冷凍食品 > 冷凍水果
- 不建議使用：冷凍水果與蔬菜 > 冷凍水果
專案專屬的目錄層級結構
為每種語言建立單一目錄。如果你在多個國家/地區營運，可以使用相同目錄在不同國家/地區提供搜尋結果。
提供價格，這些價格是根據各國家/地區的店面商品目錄資料決定，且幣別相同。如果各國家/地區的價格不同，請為每個國家/地區建立店面商品目錄資料。並在該處指定價格。
如要改善搜尋結果，請以 SearchRequest.entity 和 UserEvent.entity 形式提供每個國家/地區的名稱。僅將國家/地區實體用於排名。
產品結構
在 AI Commerce Search 中管理產品目錄時，瞭解主要產品和子類產品的屬性處理方式，對於有效搜尋和推薦至關重要。產品 SKU 指定項目會決定目錄階層。
產品指定類型
產品指定類型有三種：
主要或父項會顯示在推薦或搜尋結果中，做為類似項目的邏輯容器或群組。主要項目可以是個別項目 (SKU 層級) 和類似項目群組 (SKU 群組)。
子類或子項是 SKU 群組主要產品的特定個別版本。舉例來說，如果主要產品是「V 領襯衫」，子類可能是「棕色 V 領襯衫，XL 號」和「白色 V 領襯衫，S 號」。
系列商品是主要產品或子類產品的組合，例如含有項鍊、耳環和戒指的珠寶套組。產品和子類具有類似的階層式結構，而產品系列則會將相關的主要產品分組。消費者無法直接購買，且使用範圍不廣，只能在搜尋廣告中使用。
產品分類階層
使用這三種產品層級類型，主要有三種產品分類階層：
- 主要變體：主要變體幾乎一律只是 (常見) 資訊的預留位置，變體則是實際可購買的 SKU。舉例來說，T 恤最好以階層方式建構，做為主要產品及其對應的子類組合。每個子類代表個別的 SKU (適用於各尺寸)，每個主要項目則代表一組 SKU，其中每個 SKU 都是同一款 T 恤的不同尺寸。透過 SKU 結構進行這項分類，搜尋結果和建議面板就能顯示一系列 T 恤款式。讓購物者下鑽特定主要項目 (樣式)，選取要購買的子類 (尺寸)。
- 僅限主要產品：根據這些產品指定類型，雜貨項目最好歸類為主要產品，每個項目都包含單一 SKU 產品，例如
"bananas, fresh"。 - 集合：集合會將顧客可能購買的相關產品歸為一組。為在重新排序模型中準確呈現這些商品，AI Commerce Search 採用邏輯，將購買交易歸功於這些商品。舉例來說，購物者點選床單組中的產品，然後將該系列的主要產品加入購物車或購買。系統會將該筆交易計入收藏，並準確呈現收藏的熱門程度和價值。
有子類的產品
如果產品有子類，請將其結構化為主要子類，因為這樣做有許多優點，包括：
- 搜尋頁面會向使用者顯示各種結果。否則，如果將子類視為主要產品，搜尋結果網頁就會填入相同產品。
- 產品的排名機制更豐富，因為如果特定子類獲得更多參與度，主要產品和子類就會獲得較高的排名。這有助於重新排名及提升收益。
- 目錄維護的便利性。如果一組產品的屬性有變更，但只有尺寸不同，則可以使用主要子類結構完成變更，例如在主要層級變更屬性，而非變更多個主要屬性。
- API 功能和搜尋回應欄位 (包括變體匯總鍵和可擷取的欄位)，僅適用於變體。
- 搜尋回應會包含主要變體的最低詳細資料，以及變體的更多詳細資料。因此，您一律必須使用額外詳細資料擴增或豐富搜尋回應，如果標示為可擷取，AI Commerce Search 就能傳回這些資料。
設定產品目錄
規劃產品目錄時，您需要決定目錄中是否只包含主要產品、主要產品和子類，或是兩者的組合。請從產品的 SKU 結構著手。產品可以是主要項目，這類項目可能會有子類。
請根據產品 SKU 的指定方式，考慮設定產品目錄的選項：
- 希望 SKU 以個別搜尋結果或推薦內容的形式顯示：SKU=primary
- 你的 SKU 應屬於類似 SKU 的群組：SKU=子類，SKU 群組=主要
- 兩種組合的混合：SKU=主要、SKU=子類、SKU 群組=主要
如果產品詳細資料頁面顯示選項、尺寸或顏色選取器，這些選項通常會以子類的形式上傳至產品目錄。請考慮是否要讓相同產品的不同類型 (例如尺寸和顏色等屬性不同) 顯示為單一或個別搜尋結果。舉例來說，假設你有一本書，並想決定是否要讓精裝本和軟皮本的 SKU 出現在不同的搜尋結果中 (SKU = 主要)，還是出現在同一個搜尋結果中 (SKU = 子類，SKU 群組 = 主要)。
設定產品目錄時，請注意推薦內容和搜尋結果只會傳回主要項目。
最少的主要產品
如果判斷目錄應同時包含主要產品和子類 (即 SKU 群組和 SKU)，但目前只有 SKU，則必須為 SKU 群組建立主要產品。這些原色有時稱為虛擬原色或假原色。
這些主要項目只需要包含最少資訊：id、title 和 categories。
如未指定 type，產品類型預設為主要。如果是匯入，則不必指定 name。詳情請參閱前一節「必要產品資訊」。
匯入目錄
如果目錄位於 Cloud Storage、BigQuery 或其他儲存空間，請進行大量資料匯入。
如需上傳目錄的詳細資訊，請參閱「匯入目錄資訊」。
產品網址正確性
product.uri 欄位是直接連結至產品詳細資料頁面的標準網址。這應是可公開檢索的 URI，且不應位於任何登入或授權牆後方。這是因為後端會檢索 URI 網頁，盡可能擷取資訊，用於計算關聯性和熱門程度分數。後端也會判斷 URI 在網路上與哪些內容互動，包括反向連結。所有產品 URI 的頂層網域名稱都相同。
如果多個橫幅網站列出相同產品，建議使用多實體功能。請與帳戶團隊聯絡。
AI 商業搜尋會使用產品網址來豐富產品說明。如果產品目錄中的網址與實際網站不同，請確認這兩個網址指向相同產品，且資訊幾乎完全相同。
產品網址可透過下列方式強化目錄：
- 豐富產品資料：AI Commerce Search 會檢索產品的 URI，也就是網路上每個產品確切位置 (網址) 背後的專屬資源 ID，藉此擷取補充資訊。這個程序有助於從連結的網頁衍生其他詳細資料和信號。透過 URI 檢索深入瞭解產品，有助於提升目錄資料品質。
- 提升搜尋品質和關聯性：系統會使用從已檢索 URI 收集的網路信號，提升搜尋品質。後端會運用檢索到的資訊 (包括 URI 在網路上與使用者互動的方式，例如使用者點選反向連結的時間)，在搜尋結果中評估相關性和熱門程度。
- 提供模型訓練的基礎：除了產品 ID、名稱、類別階層和價格之外，網址也是模型訓練的主要輸入欄位之一。
如要充分發揮產品網址的效益，請遵循下列最佳做法：
- 連結的網頁必須可公開存取並正確載入，且不得位於登入或驗證牆後方。
- 每個 URI 都應是專屬的，且一律指向正確的產品網頁。內容應如實反映目錄中的產品資訊。所有產品 URI 的頂層網域名稱都必須相同。
產品庫存
商品目錄包含：
價格，包括目前價格和原價
供應情形，例如有現貨、缺貨中、缺貨待補和預購
可兌換數量
出貨資訊，例如到店取貨、送貨到店和次日到貨
庫存分為產品層級和店面層級。
產品層級的商品目錄
如果零售商只在線上銷售，則庫存是在產品層級指定。 目錄中的每項產品都設有價格、供應情形和其他商品目錄資料。
如要進一步瞭解產品層級的商品目錄，包括如何維護商品目錄資料，請參閱「更新 AI Commerce Search 的商品目錄」。
店面商品目錄資料
如果零售商同時經營實體店面和網路商店，必須分別提供每間商店的商品目錄資訊。他們會使用本地庫存來完成這項操作。
有兩個產品欄位可用於儲存店面商品目錄資料。這兩個欄位都是地點 (地點 ID) 清單，並附上相關聯的商品目錄資訊：
Product.fulfillmentInfo. 各門市的取貨和運送方式
Product.localInventories. 各門市的價格資訊、產品屬性，以及取貨和運送方式
你可以使用其中一個或兩個欄位，提供商店層級的資訊。
如要進一步瞭解店面商品目錄資料，請參閱「更新 AI Commerce Search 的店面商品目錄資料」。
主要子類商品目錄結構
主要子類商品目錄資料結構包含主要、子類和店面商品目錄資料產品：
主要產品：系統會儲存主要產品資料，但不含價格。
子類產品 (全國最低價)：舉例來說，主要子類 (顏色、尺寸) 的價格應為全國最低價。子類價格資料會彙整至主要產品資料，而主要價格則用於排名。系統會忽略特定地點的價格。
店面商品目錄資料 (區域或商店專屬價格)：在放送時使用店面商品目錄資料中的價格資訊重新排序
主要產品屬性：主要產品只能包含所有相關聯子類共有的屬性。
產品供應情形正確性
商品庫存狀態變更時，庫存更新系統會設定供應情形欄位。追蹤所有處於 IN_STOCK 和 OUT_OF_STOCK 狀態的產品。
如果大部分產品都是 OUT_OF_STOCK，搜尋結果會顯示許多缺貨產品，加上篩選條件後，召回數量就會減少。如果產品缺貨中，但目錄狀態為 IN_STOCK，使用者會看到產品有現貨，但可能在購買或加入購物車時遇到問題。這對客戶體驗的影響，比模型訓練更大。使用 patchProduct API 或匯入 API (附有 readMask)，盡可能讓 Product.availability 欄位保持最新狀態。
產品結構定義
從 BigQuery 匯入目錄時，請使用下列 AI Commerce Search 產品結構定義建立格式正確的 BigQuery 資料表，並載入目錄資料。然後匯入目錄。
使用內建欄位，而非自訂屬性
如要提交不屬於產品資訊架構的其他產品屬性，請使用Product.attributes (自訂屬性)。
與自訂屬性相比，內建產品欄位 (例如名稱、說明和品牌) 對可搜尋性和可索引性的影響較大。
換句話說，後端對內建欄位的瞭解程度比自訂屬性更深入。後端會考量內建欄位資訊，進行相關性最佳化。因此，請使用內建欄位。也就是說，請盡可能將產品資訊對應至內建欄位，只有在必要時才使用顧客屬性。
舉例來說，在 Product.brands 欄位中設定品牌，對搜尋和回想的影響遠大於在自訂屬性中設定相同資訊。對於 sleeve length 等原生不支援的屬性，建議使用自訂屬性。
使用品牌欄位
產品資訊中的品牌欄位預設可供搜尋、建立索引和篩選，是排名和關聯性的重要信號。有相當比例的搜尋查詢採用 brand query 或 query brand 形式，而品牌可說是使用最頻繁的層面之一。
如果產品的品牌欄位正確無誤，點擊和購買轉換率就會受到很大影響。因此，請務必在品牌欄位中填入正確資訊，並盡可能不要留空。更糟糕的是，在品牌名稱中填入隨機的填補字元，例如 "NA"、"Not available" 或 "Miscellaneous"。這會將產品與品牌欄位中提及的文字緊密連結，可能導致對產品的理解有誤，以及回想效果不佳。
如果特定產品絕對與任何品牌無關，最好將欄位留空。但請注意，這些空白品牌產品在目錄產品中應只占一小部分。
使用目標對象欄位
產品資訊的目標對象欄位有兩個子欄位，有 Audience.gender 和 Audience.ageGroup。請務必在這些欄位中填入適當資料，協助模型瞭解產品的目標對象。
啟用個人化功能時，這項資訊會發揮很大的作用。gender 和 ageGroup 有助於更妥善地區隔產品，並協助模型為合適的使用者回想正確的產品。
當您有「女用襯衫」或「男用襪子」等查詢時，Audience 資料也很有幫助。填入目標對象資訊後，模型就能更瞭解產品，並針對特定性別的查詢提升召回率。
找出名稱重複的產品
Product.title 可能是最重要的欄位，因為大多數搜尋查詢都會與設定為 Product.title 的內容有大量重疊。這可能是使用者在「詳細資料」頁面檢視畫面中看到的第一個資訊，因此建議您保持產品標題的獨特性，並提供與產品最相關的文字資訊。
如果兩個產品 (主要產品) 的名稱相同，會影響搜尋功能和傳回結果的相關性。如果兩個主要產品有顯著差異，請使用不同的名稱。如果產品相同，但只有顏色、尺寸等少數方面不同，請將產品結構設為主要和子類類型。
語言設定
AI Commerce Search 支援多種語言。但請注意，每個專案只能有一個目錄。每個目錄只能有一種語言。
因此，目錄和搜尋查詢必須使用相同語言。系統不會翻譯查詢或目錄資訊。舉例來說，如果目錄使用西班牙文，搜尋查詢也必須使用西班牙文。
因此，請務必在產品資訊中標示正確的語言代碼，否則系統會預設為英文 (en-US)。這對搜尋控制項 (例如 spellCorrectionSpec) 來說非常重要，如果未設定語言，就會導致非預期的行為。這對瞭解查詢意圖也極為重要。
如需混合語言設定的相關資訊，請參閱「支援的語言」。
價格資訊設定
Product.priceInfo 欄位必須盡可能準確且完整。這項價格資訊可用於推導折扣相關信號，並用於收益最佳化。這對瀏覽查詢尤其重要。
如果是主要子類產品結構，請填入至少一個子類的價格。
如果產品沒有產品層級的價格，所有價格都在店面商品目錄資料中，表示搜尋一律與店面商品目錄資料相關，請在產品層級價格資訊中填寫所有廣告空間層級價格的中位數價格資訊。
目錄資料品質指標
在 Gemini Enterprise for Customer Experience 控制台的 AI Commerce Search 中，資料品質頁面會評估你是否需要更新目錄資料，以提升搜尋結果品質，並解鎖搜尋成效層級。
下表說明 AI Commerce Search 用來評估產品資料的品質指標。如要進一步瞭解如何在 Gemini Enterprise for Customer Experience 控制台的 AI Commerce Search 中查看資料品質指標和搜尋成效等級，請參閱「解鎖搜尋成效等級」。
| 目錄品質指標 | 品質規則 | 附註 |
|---|---|---|
| URI 已存在且可存取 | 產品有有效的 Product.uri。URI 必須可存取，且與你的網域相符。 |
Google 搜尋會使用透過這個 URI 檢索的網路信號，提升搜尋品質。 |
| 符合時間規定 | Product.availableTime 早於目前時間，且 Product.expireTime 晚於目前時間。 |
只有符合時間規定的產品才能搜尋。 |
| 有可供搜尋的屬性 | 產品至少有一項 attribute 設為可供搜尋。 |
標示為可供搜尋的自訂屬性可透過文字查詢搜尋。 |
| 有說明 | 產品的 Product.description 不得為空。 |
詳盡的說明有助於提升搜尋品質。 |
| 標題至少包含兩個字 | Product.title 至少包含兩個字。 |
詳盡的標題有助於提升搜尋品質。 |
| 具備含有圖片的子類 | variant 產品至少有一個 Product.image。如果所有產品都處於 primary 級別，可以忽略這項指標。 |
這項指標僅供參考，不會影響搜尋品質。 |
| 具備含有價格資訊的子類 | variant 產品有 Product.priceInfo 集合。如果所有產品都處於 primary 層級，可以忽略這項指標。 |
這項指標僅供參考，不會影響搜尋品質。 |