資訊方塊導覽

本頁面將介紹 Vertex AI Search for commerce 的動態磚導覽功能。

為什麼要使用動態磚？

動態磚是屬性值配對的視覺化呈現方式，與動態 Facet 呈現的資訊相同，但只會顯示特定查詢最常使用的屬性，不會顯示購物者不一定能直覺理解的動態 Facet 系列。目標是提高篩選器使用率，進而增加每位使用者的收益。使用圖塊導覽功能，可讓強式 HEAD 查詢的篩選器使用方式更貼近實際情況，進而提高收益預測 (透過迴歸) 的準確度。

動態磚導覽功能是「引導式搜尋」套件的一部分，可協助顧客更快縮小使用者查詢範圍，並提供與使用者更相關的結果。動態構面會佔用空間，因此我們設計了圖塊導覽功能，讓使用者更快找到可能更符合需求的內容。此外，有了圖塊導覽功能，購物者就不必在左側或右側導覽窗格中，瀏覽所有分類系列，才能找到確切的產品，然後還必須再次點選提交按鈕，確認縮小範圍後的搜尋結果。

動態 facet 可與圖塊導覽功能互補

上傳產品目錄後，即可在「Search for commerce」控制台中取得動態層面。這些篩選器會變更顯示的篩選器順序，藉此縮小查詢範圍，讓正確的篩選器顯示在最上方，並在每次搜尋時傳回更相關的結果。

動態層面會為篩選器系列排序，例如時裝零售商的查詢「洋裝」會顯示「款式」和「袖子」，雜貨零售商的查詢「牛奶」則會顯示「容量」、「種類」或「容器」。這些動態分類群組的排列方式通常不一定符合使用者直覺。此外，動態分類選取功能的飛出窗格會佔用產品網站的大量空間，而且不一定適合行動裝置。

因此，我們需要減少商品網站上的房地產，並提高每次搜尋轉換的使用者收益。

動態磚的運作方式

圖塊導覽功能可讓使用者更快縮小搜尋範圍，進而提高搜尋參與度和每次搜尋收益。圖塊可獨立於構面系列，在產品網站上以水平方式顯示。動態磚功能會控制搜尋篩選器，將最有可能吸引使用者點選的篩選器個別放在頁面頂端，並將搜尋結果從動態商情項目系列中分離出來，立即提供視覺化資訊。這樣一來，使用者就能以更易於存取的方式，瀏覽動態構面內容。

購物者歷程

如果零售商網站已啟用圖塊導覽功能，購物者在網站上搜尋時，最多會看到 20 個圖塊，顯示最有可能吸引他們點選的個別篩選值。這些動態磚會依使用可能性排序，與產品屬性系列無關。每個資訊方塊都可以包含一張圖片，代表套用篩選器後的典型產品。如果顧客點選動態磚，系統會視為已套用對應的構面值。產品清單會隨即更新，顯示符合查詢和篩選條件的結果，並顯示已套用的商情項目。此外，顯示的動態磚也會重新整理，以反映新的預期參與率，但已套用的篩選條件除外。

零售商歷程

零售商會將查詢傳送至 Vertex AI Search for commerce，並收到標準查詢回覆，其中包含依產品屬性系列排序的圖塊值清單，以及產生圖塊圖片的方式。零售商接著會算繪附有或不附有圖片的動態磚。如果潛在顧客點選圖塊或切面值，零售商會將對應至圖塊或切面的篩選條件新增至篩選條件欄位，並向 Google 傳送新的查詢。零售商網站也會傳送第二個查詢的事件給 Google，並新增篩選條件。無論是「使用者點按篩選條件」還是「使用者點按圖塊」，Vertex AI Search for commerce 回應、傳送至 Google 的查詢，以及傳送至 Google 的事件都相同。

圖塊中顯示的篩選器

根據零售商在 Search for Commerce 控制台或 Vertex AI Search for Commerce API 中設定的偏好設定，篩選條件可能符合平鋪顯示資格，包括內容、產品數量，以及與量化查詢相關的篩選條件。

根據內容

• 先前的搜尋不得套用篩選器。
• 只有與目錄屬性中標示為可動態篩選的屬性值相符的圖塊。
• 搜尋結果 (Vertex AI Search for Commerce 回覆) 必須至少包含一項產品。
• 系統篩選器 (例如「instock = yes」或「available for sale = yes」) 對應的動態磚不會顯示。
• 系統會依據參與度可能性排序動態磚。

依據產品數量

• 如果可排序的圖塊少於 20 個，該怎麼辦？
  • 如果介於 >= 2 和 < 20 之間，請盡可能傳回最多圖塊。
  • 如果可用的圖塊少於 2 個，請勿傳回任何圖塊。
• 如果可排序的圖塊超過 20 個，請根據參與度可能性傳回前 20 個。

根據量化查詢

• 圖塊支援「類別」和「數值」兩種屬性，例如「顏色 = 紅色」和「重量 = 1 磅到 2 磅」。
• 數字圖塊的分類：
  • 系統會採用使用特定屬性控制項設定的分類。舉例來說，如果手動將構面歸類為 0-1 磅、1-3 磅和 3-6 磅，這些類別就會顯示在動態磚中。詳情請參閱「動態層面和資訊方塊控制項」。
  • 如果自動將構面分組，圖塊應使用相同的組別。

Retail API 中的圖塊導覽？

動態磚功能沒有新的 API。不過，現有的 Vertex AI 主要 (查詢) API 已新增欄位。

要求 tileNavigationSpec

查詢

{
  "tile_navigation_requested": boolean,
  "applied_tiles": repeated
}

欄位 (要求)
tile_navigation_requested	這個布林值欄位會指定顧客是否要要求圖塊導覽。
applied_tiles	這個重複欄位會指定已點選的圖塊。

首先，請設定 tileNavigationSpec 欄位。呼叫包含屬性名稱和值的物件 productAttributeValue，例如 name=color 和 value=red。其他欄位則維持不變。

Response 磚 NavigationResult

接著，API 會在 tileNavigationResult 欄位中傳回最多 20 個圖塊，並依使用可能性排序。回應會根據圖塊的屬性值和相應的代表性圖片顯示圖塊：

回應

...
  "tileNavigationResult": {
    "tiles": [
      {
        "productAttributeValue": {
          "name": "sizes",
          "value": "large"
        },
        "representativeProductId": "xxxx"
      },
      {
        "productAttributeValue": {
          "name": "attributes.weight",
          "value": "light"
        },
        "representativeProductId": "xxxx"
      },
      {
        "productAttributeValue": {
          "name": "colors",
          "value": "black"
        },
        "representativeProductId": "xxxx"
      }
    ]
  }
  ...

欄位 (回應)
tiles	這個重複欄位會驅動向使用者顯示的用戶端動態磚。這個欄位包含圖塊清單，每個圖塊都是包含 productAttributeValue 和 representativeProductId 的物件。

現有 API 不需變更，新版用戶端程式庫會在正式發布時推出，並發布在公開程式庫說明文件中。

零售商應如何處理圖塊搜尋結果

• 顯示圖塊：按照提供的順序顯示傳回的圖塊，回應中的第一個圖塊會是顯示的第一個圖塊。ProductAttributeValue 是包含屬性值的鍵/值組合，可讓您瞭解要顯示哪些動態磚。在後續的搜尋要求中，ProductAttributeValue 應在 appliedTiles 欄位中設定，也應在 filter 欄位中設定 (例如 filter = "attributes.weight:ANY(\"large\")")。回應會顯示篩選後的產品，以及一組新的顯示方塊。

• 顯示圖片：如要取得這些圖片，請參照回應中的 representativeProductId 欄位，其中會提供符合所套用篩選器的典型產品 ID。零售商會在後端查詢這個代表性產品 ID，然後選取要在動態磚中顯示的合適圖片。請務必使用代表性產品 ID，而非主要產品 ID，確保圖片能準確反映已篩選的屬性 (例如，顯示 color = "red" 篩選器對應的紅色子類)。

在控制台中設定動態磚行為

搜尋畫面顯示的動態磚是由目錄屬性直接決定，而目錄屬性則是從零售商上傳至產品目錄的資訊中擷取。候選動態篩選屬性值是產品目錄中所有「動態篩選屬性」的屬性值。

啟用動態 facet 和圖塊處理

產品屬性會控管層面，這些屬性來自目錄和使用者事件。設定動態 facet 和圖塊處理，讓使用者查詢與產品屬性相符的結果。

注意： 如要在專案中啟用分塊功能，每週必須持續發出至少 7,000 次 API 要求。也就是說，專案必須已在正式環境中。

如要控管哪些屬性符合動態 facet 和圖塊的資格，請按照下列步驟操作：

1. 前往 Search for Commerce 控制台的「Controls」頁面。 前往「Controls」(控制項) 頁面

2. 按一下「屬性控制項」分頁標籤 > 設定圖塊控制項。

3. 選用：如要修改屬性控制項，請按一下「屬性」旁的「修改控制項」，然後將各屬性的控制項設為「True」或「False」。

第三和第四欄 (「可建立索引」和「動態 facet 處理」) 是控制圖塊的關鍵。如要讓圖塊正常運作，每個屬性列的這兩個資料欄都必須標示為「True」。可建立索引：啟用這項功能後，Vertex AI Search for Commerce 就能使用屬性篩選。啟用動態 facet 處理後，Vertex AI Search for commerce 就能根據過去的使用者行為 (例如點選和查看 facet) 自動將屬性做為動態 facet。

如要瞭解如何在 API 中執行這項操作，請參閱「API 中的圖塊控制項」一節。

個別動態磚控制項

Facet 控制項可讓您管理 facet 的行為，而不必變更目錄，並影響整個網站的搜尋行為。

移除 facet 控制項會從特定查詢的動態 facet 結果中移除整個 facet。此外，系統也不會再以圖塊形式傳回這個 facet 的成員圖塊。

目錄層級中以「動態 facet 和圖塊處理」標記的下列 facet 值也會影響圖塊：

• 忽略 facet 值：禁止顯示圖塊，並移除搜尋結果中的動態 facet。
• 替換 facet 值：零售商可以在圖塊和動態 facet 中，針對特定查詢變更 facet 值 (例如，針對 color 屬性，將 navy blue 變更為 blue)。
• 設定數值間隔：零售商可指定值區大小，在動態資料類型和圖塊中，輸出特定動態範圍的搜尋回應。

facet 控制項類型控制項的下拉式選單中，最後三種動態 facet 控制項類型不會影響圖塊：

• 強制傳回 facet
• 重新排定動態 facet 排名
• 合併 facet

如要進一步瞭解如何控制每個控制項的特定 facet 值和圖塊行為，請參閱「Facet 控制項」。

API 中的圖塊控制項

本節說明如何控管 Vertex AI Search for commerce API 中的圖塊行為。

屬性控制項

如要使用搜尋和建議功能，請在 REST 資源「Resource: projects.locations.catalogs.attributesConfig」下，找到目錄層級的 API。這個 API 提供在目錄和產品層級新增、移除及取代屬性的方法。欄位 catalogAttributes 可以對應至可建立索引、可搜尋和 dynamicFacetable 的欄位。如果 facet符合圖塊處理資格，則 dynamicFacetable 適用於圖塊行為。

AttributesConfig

目錄層級屬性設定。

與資訊方塊相關的欄位
catalogAttributes	map 在目錄層級啟用屬性設定，方法是將屬性名稱對應至可呼叫的物件 CatalogAttribute，其中包含屬性是否可搜尋、是否為動態分類標籤等資訊。

CatalogAttribute

attributesConfig 資源提供 CatalogAttribute，這是目錄層級的物件。這個物件的兩個欄位會產生控制項，可控制哪些屬性顯示為圖塊。也就是說，產品目錄中所有「可切換屬性」的屬性，都可以成為圖塊候選項目：

與動態磚相關的欄位
DynamicFacetableOption	enum 全域控制欄位，必須指定為啟用或停用。這會開啟或關閉動態層面，進而驅動動態磚。這項設定位於 Google Cloud 控制台的「屬性控制項」下方。
facetConfig	物件，其中包含個別側面的值選項。這個欄位是分面控制項。

facet 控制項

FacetConfig

這個物件包含 Facet 選項，可讓個別 Facet 值動態顯示，因此可能可以平鋪。這是目錄層級 CatalogAttribute 設定中的欄位。

物件包含現有欄位，現在這些欄位也會影響動態磚：

JSON 示例

  "facetIntervals": [
    {
      object (Interval)
    }
  ],
  "ignoredFacetValues": [
    {
      object (IgnoredFacetValues)
    }
  ]

與動態磚相關的欄位
ignoredFacetValues	FacetConfig 中的這個訊息欄位包含要忽略的側邊值，適用於指定時間範圍內的目前屬性名稱，且只會影響側邊，不會影響目錄中的產品說明。
facetIntervals	零售商可藉此為數值輸入指定值區大小。這項做法也適用於圖塊。如果零售商為動態層面設定特定數字間隔，圖塊也應使用相同的數字間隔。
removeFacetValue	移除特定 facet 鍵的 facet 值。這些值會對應至屬性值。

瞭解如何在管理中心建立這些個別控制項。