本頁說明建立目錄資訊和填入目錄資料的最佳做法。
總覽
目錄是產品物件的集合。
匯入 Vertex AI Search for commerce 的目錄資料會直接影響產生的模型品質，進而影響搜尋和建議結果的品質。一般來說，提供的目錄資訊越準確且具體，模型品質就越高。
請務必維持目錄最新狀態。你可以視需要上傳目錄變更，如果目錄變更頻率高，建議每天上傳。你可以上傳 (修補) 現有產品項目，系統只會更新變更的欄位。上傳目錄資訊不會產生費用。詳情請參閱「保持目錄最新狀態」一文。
目錄分支版本
可搜尋的目錄分支版本
如果您使用搜尋功能，可以先透過目錄分支測試離線上傳的新資料，再將資料發布到網站上。
最多可使用三個分支，分別為 0、1 和 2。您的即時網站會指向 default_branch，以取得目錄資料。使用 setDefaultBranch 或 Search for commerce console 中的「資料」分頁，指定哪個分支是你的正式版 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 形式提供每個國家/地區的名稱。僅將國家/地區實體用於排名。
產品結構
在商家適用的 Vertex AI Search 中管理產品目錄時，瞭解主要和子類產品的屬性處理方式，對於有效搜尋和推薦至關重要。產品 SKU 指定項目會決定目錄階層。
產品指定類型
產品指定類型有三種：
主要或父項會顯示在建議或搜尋結果中，做為類似項目的邏輯容器或群組。主要項目可以是個別項目 (SKU 層級) 和類似項目群組 (SKU 群組)。
子類或子項是 SKU 群組主要產品的特定個別版本。舉例來說，如果主要產品是「V 領襯衫」，子類可能是「棕色 V 領襯衫，XL 號」和「白色 V 領襯衫，S 號」。
集合項目是主要產品或子類產品的組合，例如含有項鍊、耳環和戒指的珠寶套組。產品和子類具有階層式結構，而產品系列則會將相關的主要產品分組。消費者無法直接購買，且使用範圍不廣，只能在搜尋廣告中使用。
產品分類階層
使用這三種產品層級類型，主要有三種產品分類階層：
- 主要變體：主要變體幾乎一律只是 (常見) 資訊的預留位置，變體則是實際可購買的 SKU。舉例來說，T 恤最好以階層方式建構，做為主要項目及其對應的變體組合。每個子類代表個別的 SKU (適用於各尺寸)，每個主要項目則代表一組 SKU，其中每個 SKU 都是同一款 T 恤的不同尺寸。透過 SKU 結構整理，搜尋結果和建議面板就能顯示一系列 T 恤款式。購物者可深入瞭解特定主要項目 (樣式)，然後選取要購買的子類別 (尺寸)。
- 僅限主要產品：根據這些產品指定類型，雜貨項目最好歸類為主要產品，每個主要產品都包含單一 SKU 產品，例如
"bananas, fresh"。 - 集合：集合會將顧客可能購買的相關產品歸類在一起。為了在重新排序模型中準確呈現這些商品，Vertex AI Search for commerce 採用邏輯，將購買交易歸功於這些商品。舉例來說，購物者點選床單組中的產品，然後將該系列的主要產品加入購物車或購買。系統會將該筆交易計入收藏，並準確呈現收藏的熱門程度和價值。
有子類的產品
如果產品有子類，請將其結構化為主要子類，因為這樣做有許多優點，包括：
- 搜尋頁面會向使用者顯示各種結果。否則，如果將子類視為主要產品，搜尋結果網頁就會填入相同產品。
- 產品的排名機制更豐富，因為如果特定子類獲得的參與度較高，主要產品和子類就會獲得較高的排名。這有助於重新排名和收益最佳化。
- 目錄維護的便利性。如果一組產品的屬性有變更，但只有尺寸不同，則可以使用主要子類結構完成變更，例如在主要層級變更屬性，而不是變更多個主要屬性。
- API 功能和搜尋回應欄位 (包括變體匯總鍵和可擷取的欄位)，僅適用於變體。
- 搜尋回應會包含主要變體的最低詳細資料，以及變體的更多詳細資料。因此，您一律必須使用額外詳細資料擴增或充實搜尋回覆，如果標示為可擷取，Vertex AI 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 的頂層網域名稱都相同。
如果多個橫幅網站列出相同產品，建議使用多實體功能。請與帳戶團隊聯絡。
Vertex AI Search for commerce 會使用產品網址來充實產品說明。如果產品目錄和實際網站使用的網址不同，請確認這兩個網址指向相同產品，且資訊幾乎完全相同。
產品網址可透過下列方式強化目錄：
- 豐富產品資料：Vertex AI Search for commerce 會檢索產品的 URI，也就是網路上各產品確切位置 (網址) 後方的專屬資源 ID，藉此擷取補充資訊。這個程序有助於從連結的網頁衍生其他詳細資料和信號。透過 URI 檢索深入瞭解產品，有助於提升目錄資料品質。
- 提升搜尋品質和關聯性：系統會使用從已檢索 URI 收集的網路信號，提升搜尋品質。後端會運用檢索到的資訊 (包括 URI 在網路上與使用者互動的方式，例如使用者點選反向連結的時間)，在搜尋結果中評估相關性和熱門程度。
- 提供模型訓練的基礎：除了產品 ID、名稱、類別階層和價格之外，網址也是模型訓練的主要輸入欄位之一。
如要充分發揮產品網址的效益，請遵循下列最佳做法：
- 連結的網頁必須可供公開存取並正確載入，且不得位於登入或驗證牆後方。
- 每個 URI 都應是專屬的，且一律指向正確的產品網頁。內容應如實反映目錄中的產品資訊。所有產品 URI 的頂層網域名稱都必須相同。
產品庫存
商品目錄包含：
價格，包括目前價格和原價
供應情形，例如有現貨、缺貨中、缺貨待補和預購
可兌換數量
出貨資訊，例如到店取貨、送貨到店和次日到貨
庫存分為兩個層級：產品層級和店面層級。
產品層級的商品目錄
如果零售商只在線上銷售，則庫存是在產品層級指定。 目錄中的每項產品都已設定價格、供應情形和其他商品目錄資料。
如要進一步瞭解產品層級的商品目錄，包括如何維護商品目錄資料，請參閱「更新 Vertex AI Search for commerce 的商品目錄」。
店面商品目錄
如果零售商同時經營實體店面和網路商店，必須分別提供每間商店的商品目錄資訊。他們會使用本地庫存來完成這項操作。
你可以使用兩個產品欄位儲存店面商品目錄資料。這兩個欄位都是地點 (地點 ID) 清單，並附上相關聯的商品目錄資訊：
Product.fulfillmentInfo. 各門市的取貨和運送方式
Product.localInventories. 各門市的價格資訊、產品屬性，以及取貨和運送方式
你可以使用其中一個或兩個欄位，提供商店層級的資訊。
如要進一步瞭解店面商品目錄資料，請參閱「更新 Vertex AI Search for Commerce 的店面商品目錄資料」。
主要子類商品目錄結構
主要子類商品目錄資料結構包含主要、子類和店面商品目錄產品：
主要產品：系統會儲存主要產品資料，但不含價格。
子類產品 (全國最低價)：舉例來說，主要子類 (顏色、尺寸) 的價格應為全國最低價。系統會將子類價格資料彙整至主要產品資料，並使用主要價格進行排序。系統會忽略特定地點的價格。
店面商品目錄 (區域或商店專屬價格)：在放送時使用店面商品目錄中的價格資訊重新排序
主要產品屬性：主要產品只能包含所有相關聯子類共有的屬性。
產品供應情形正確性
商品庫存狀態變更時，庫存更新系統會設定供應情形欄位。追蹤所有處於 IN_STOCK 和 OUT_OF_STOCK 狀態的產品。
如果大部分產品為 OUT_OF_STOCK，搜尋回應會顯示許多缺貨產品，新增篩選器後，召回次數就會減少。如果產品缺貨，但目錄狀態為 IN_STOCK，使用者會看到產品有現貨，但可能在購買或加入購物車時遇到問題。這對顧客體驗的影響比模型訓練更大。使用 patchProduct API 或匯入 API (附帶 readMask)，盡可能讓 Product.availability 欄位保持最新狀態。
產品結構定義
從 BigQuery 匯入目錄時，請使用下列 Vertex AI Search for commerce 產品結構定義建立格式正確的 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 的內容有大量重疊。這可能是使用者在「詳細資料」頁面檢視畫面中看到的第一個資訊，因此建議您保持產品標題的獨特性，並提供與產品最相關的文字資訊。
如果兩個產品 (主要產品) 的名稱相同，會影響搜尋功能和傳回結果的相關性。如果兩個主要產品有顯著差異，請使用不同的名稱。如果產品相同，但只有顏色、尺寸等少數方面不同，請將產品結構設為主要和子類類型。
語言設定
Vertex AI Search for commerce 支援多種語言。詳情請參閱本文。請注意，目錄和搜尋查詢必須使用相同語言。查詢或目錄資訊不會跨語言翻譯。舉例來說，如果目錄是西班牙文，搜尋查詢也必須是西班牙文。
因此，請務必在產品資訊中標示正確的語言代碼，否則系統會預設為英文 (en-US)。這對搜尋控制項 (例如 spellCorrectionSpec) 來說非常重要，如果未設定語言，可能會導致非預期的行為。這對瞭解查詢意圖也極為重要。
價格資訊設定
Product.priceInfo 欄位必須盡可能準確且完整。這項價格資訊可用於推導折扣相關信號，並用於收益最佳化。這對瀏覽查詢尤其重要。
如果是主要子類產品結構，請填入至少一個子類的價格。
如果產品沒有產品層級的價格，所有價格都在店面商品目錄中，表示搜尋一律與店面商品目錄相關，請在產品層級價格資訊中填寫所有庫存層級價格的中位數價格資訊。
目錄資料品質指標
在「Search for commerce」控制台的「資料品質」頁面中，你可以評估是否需要更新目錄資料，以提升搜尋結果品質並解鎖搜尋成效等級。
下表說明商家適用的 Vertex AI Search 用於評估產品資料的品質指標。如要瞭解如何在「搜尋」的商家控制台中查看資料品質指標和搜尋成效等級，請參閱「解鎖搜尋成效等級」。
| 目錄品質指標 | 品質規則 | 附註 |
|---|---|---|
| URI 已存在且可存取 | 產品具有有效的 Product.uri。URI 必須可存取，且與你的網域相符。 |
Google 搜尋會使用透過這個 URI 檢索的網路信號，提升搜尋品質。 |
| 符合時間規定 | Product.availableTime 早於目前時間，且 Product.expireTime 晚於目前時間。 |
只有符合時間規定的產品才能搜尋。 |
| 有可供搜尋的屬性 | 產品至少有一項attribute設為可供搜尋。 |
標示為可搜尋的自訂屬性可透過文字查詢搜尋。 |
| 有說明 | 產品的 Product.description 不得為空。 |
詳盡的說明有助於提升搜尋品質。 |
| 標題至少包含兩個字 | Product.title 至少包含兩個字。 |
詳盡的標題有助於提升搜尋品質。 |
| 具備含有圖片的子類 | variant 產品至少有一個 Product.image。如果所有產品都處於 primary 層級，可以忽略這項指標。 |
這項指標僅供參考，不會影響搜尋品質。 |
| 具備含有價格資訊的子類 | variant 產品有 Product.priceInfo 集合。如果所有產品都處於 primary 層級，可以忽略這項指標。 |
這項指標僅供參考，不會影響搜尋品質。 |