關於目錄和產品

本頁說明建立目錄資訊和填入目錄資料的最佳做法。

總覽

目錄是產品物件的集合。

匯入商家適用的 Vertex AI Search 的目錄資料，會直接影響產生的模型品質，進而影響搜尋和建議結果的品質。一般來說，提供的目錄資訊越準確且具體，模型品質就越高。

請務必維持目錄最新狀態。你可以視需要上傳目錄變更，如果目錄變更頻率高，建議每天上傳。你可以上傳 (修補) 現有產品項目，系統只會更新變更的欄位。上傳目錄資訊不會產生費用。詳情請參閱「保持目錄最新狀態」一文。

目錄分支版本

如果您使用搜尋功能，可以先透過目錄分支測試離線上傳的新資料，再將資料發布到網站上。

最多可使用三個分支，分別為 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 產品的完整專屬資源名稱。所有 Product 方法都必須提供這項資訊，但 import 除外。匯入時，系統會自動產生名稱，不需要手動提供。
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 標示會決定目錄階層。

目錄和商品目錄結構

產品指定類型

產品指定類型有三種：

  1. 主要或父項會顯示在推薦或搜尋結果中，做為類似項目的邏輯容器或群組。主要項目可以是個別項目 (SKU 層級) 和類似項目群組 (SKU 群組)。

  2. 子類或子項是 SKU 群組主要產品的特定個別版本。舉例來說，如果主要產品是「V 領襯衫」，子類可能是「棕色 V 領襯衫，XL 號」和「白色 V 領襯衫，S 號」。

  3. 集合項目是主要產品或子類產品的組合，例如含有項鍊、耳環和戒指的珠寶套組。產品和子類具有階層式結構，而產品系列則會將相關的主要產品分組。消費者無法直接購買，使用範圍不廣，且僅適用於搜尋。

產品範例

舉例來說，根據這些產品指定類型，雜貨項目最好歸類為主要產品，每個項目都包含單一 SKU 產品，例如"bananas, fresh"。

另一方面，T 恤則適合採用階層式結構，因為主要項目會有一組對應的變體。每個子類都代表個別的 SKU (每種尺寸)，每個主要項目則代表一組 SKU，其中每個 SKU 都是同一款 T 恤的不同尺寸。透過這種依 SKU 結構分類的方式，搜尋結果和建議面板就能顯示一系列 T 恤款式。購物者可深入瞭解特定主要項目 (樣式)，然後選取要購買的子類別 (尺寸)。

集合會將顧客可能購買的相關產品歸為一組，為了在重新排序模型中準確呈現這些項目，商家適用的 Vertex AI Search 採用邏輯，將購買交易歸功於這些項目。舉例來說，購物者點選床單組中的產品，然後將該系列的主要產品加入購物車或購買。系統會將該筆交易計入收藏，並根據這些資料準確呈現收藏的熱門程度和價值。

此外，還有僅限變體的目錄類型，但這類目錄已淘汰。這個目錄類型只能與建議搭配使用。如果是只有變體的目錄，匯入時 ingestionProductType 會設為 variant。系統會根據為每個子類指定的產品 ID，推斷每個子類的主要產品。

設定產品目錄

規劃產品目錄時，您需要決定目錄中是否只包含主要產品、主要產品和子類，或是兩者的組合。請從產品的 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 或其他儲存空間，請執行大量資料匯入作業。

如需上傳目錄的詳細資訊，請參閱「匯入目錄資訊」。

產品庫存

商品目錄包含：

  • 價格，包括目前價格和原價

  • 供應情形，例如有現貨、缺貨中、缺貨待補和已預購

  • 可兌換數量

  • 出貨資訊，例如到店取貨、送貨到店和次日到貨

庫存分為兩個層級：產品層級和店面層級。

產品層級的商品目錄

如果零售商只在線上銷售，則庫存是在產品層級指定。 目錄中的每項產品都已設定價格、供應情形和其他商品目錄資料。

如要進一步瞭解產品層級的庫存，包括如何維護庫存資料，請參閱「更新商家適用的 Vertex AI Search 庫存」。

店面商品目錄

如果零售商有實體店面和網路商店，必須分別提供每間商店的商品目錄資訊。他們會使用店面商品目錄執行這項操作。

你可以使用兩個產品欄位儲存店面商品目錄資料。這兩個欄位都是地點 (地點 ID) 清單，並附上相關聯的商品目錄資訊：

你可以使用其中一個或兩個欄位，提供商店層級的資訊。

如要進一步瞭解店面商品目錄資料，請參閱「更新 Vertex AI Search for Commerce 的店面商品目錄資料」。

主要子類商品目錄結構

主要子類商品目錄資料結構包含主要、子類和店面商品目錄產品：

  • 主要產品：系統會儲存主要產品資料，但不含價格。

  • 子類產品 (在全國範圍內價格最低)：舉例來說，主要子類 (顏色、尺寸) 在全國範圍內應有最低價格。子類價格資料會彙整至主要產品資料，而主要價格則用於排名。系統會忽略特定地點的價格。

  • 店面商品目錄 (區域或商店專屬價格)：在放送時使用店面商品目錄中的價格資訊重新排序

  • 主要產品屬性：主要產品只能包含所有相關聯子類共有的屬性。

目錄資料品質指標

在「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 層級，可以忽略這項指標。 這項指標僅供參考，不會影響搜尋品質。

產品結構定義

從 BigQuery 匯入目錄時，請使用下列 Vertex AI Search for commerce 產品結構定義建立格式正確的 BigQuery 資料表，並載入目錄資料。然後匯入目錄。