提升成效

商家適用的 Vertex AI Search 提供一項功能，可讓您指定應在搜尋結果中優先顯示的記錄。您可以套用提升規則，優先顯示或降低顯示搜尋結果的優先順序，藉此控制結果排名。

您可以根據定義的條件，宣傳 (增強) 或降級 (埋藏) 特定項目，藉此控制搜尋結果的排名。與從結果集中移除項目的篩選不同，加成功能會調整已符合傳回資格項目的位置。

提升和篩選器覆寫

注意： 篩選規則的優先順序一律高於加成規則。如要進一步瞭解如何篩選及排序搜尋結果，請參閱「篩選及排序結果」一文。

以下是常見的篩選器類型，優先度高於加成規則：

1. 使用者指定。例如價格或品牌。這類廣告會以方塊或切面形式向使用者顯示。

• 主題性 (關聯性)：這些篩選器僅適用於搜尋查詢 (不適用於瀏覽)。系統會從搜尋結果中排除關聯性較低的產品。舉例來說，搜尋「冰箱」不會傳回微波爐或冰箱把手等配件。篩選器會辨識出冰箱搜尋結果不應提高微波爐的曝光度。

強化規則

只有在有基本關聯性分數時，才能套用提升規則，例如依關聯性排序的搜尋結果，或已預先排序的瀏覽結果。加成是套用至搜尋和瀏覽結果的乘數函式。加成語法和邏輯可細分為：

• 適用情況。加成無法覆寫供應情形規則。如果商品已遭篩除 (例如缺貨)，即使加強放送，也不會顯示。

• 運算子。在加成條件中，您可以對數值欄位使用大於和少於等運算，這些運算在標準嚴格篩選中無法使用。

提高或降低排名值

一個產品可受多個升級或埋沒規則限制，這些規則是在 Search API 的 boostSpec 類別中設定。增幅值是介於 -1.0 和 1.0 之間的浮點數。

• 正值 (0.0 至 1.0)：提高項目排名，讓項目在結果中顯示在較高的位置。值為 1.0 時，項目排名升幅最大。

• 負值 (-1.0 至 0.0)：降低 (埋藏) 項目，將其移至結果的較下方位置。值為 -1.0 時，降級幅度最大。

單一產品有多項升級或隱藏規則

多項升級或埋沒規則可能會影響產品，最終分數則會由升級值總和或最大值決定。如果同一項產品套用多項提升規則，請務必檢查是否有其他產品的分數將該產品擠出最高排名。系統已將最大模式設為預設值，因此較不可能發生這個問題。

假設某項產品獲得 2、3 和 0.5 的升幅，另一項產品獲得 0.5 的升幅。雖然產品只獲得 0.5 的提升分數，但如果重複提升，排名就會高於其他產品。請仔細檢查增強規格，確認規格並未重疊，或重疊是您預期的結果。

解決衝突

如果多項提升規則適用於同一項產品，您可以定義這些規則的互動方式。

• 最高升幅規則 (預設)：Vertex AI Search 電子商務套件會檢查最高值，並忽略其他規則。

• 加成效果總和 (替代設定)：如果同時有降級和升級，Vertex AI Search for commerce 會加總所有適用加成和埋藏規則的值。這會產生累積效果。因此，最終結果不是降低升幅，就是產生淨埋沒效果。

設定增幅

如要設定含有升級或埋沒規則的資料集，請根據產品屬性 (例如品牌或價格) 定義條件，並指派介於 -1.0 (埋沒) 和 1.0 (升級) 之間的升級值，調整相符項目的排名分數。下列產品可設定升級或隱藏控制項：

• 搜尋：主題篩選器，以及使用者套用的任何其他篩選器，例如網站上的分類。進一步瞭解如何設定搜尋結果排序提升。

• 瀏覽：由於沒有文字查詢，系統只會套用使用者套用的篩選條件。系統也會套用篩選條件，確認產品 (例如西裝) 屬於正確的產品類別 (而非毛衣)。進一步瞭解如何設定最佳化建議的加成。

範例資料集

查看範例產品資料集

id	title	品牌	類別	price_info.price
"nest_mini_2nd_gen"	「Nest Mini (第 2 代)」	["Google", "Nest"]	["Nest > 音箱和螢幕"]	49.00
「nest_audio」	「Nest Audio」	["Google", "Nest"]	["Nest > 音箱和螢幕"]	99.99
「nest_hub_max」	「Nest Hub Max」	["Google", "Nest"]	["Nest > 音箱和螢幕"]	229.00
「nest_hub」	「Nest Hub」	["Google", "Nest"]	["Nest > 音箱和螢幕"]	88.99
「google_home_max」	「Google Home Max」	["Google", "Nest"]	["Nest > 音箱和螢幕"]	299.00
「google_home_mini」	「Google Home Mini」	["Google", "Nest"]	["Nest > 音箱和螢幕"]	49.00
「google_pixel_5」	「Google Pixel 5」	["Google", "Pixel"]	["Pixel > 手機"]	699.00
"google_pixel_4a_with_5g"	「Google Pixel 4a 5G 版」	["Google", "Pixel"]	["Pixel > 手機"]	499.00
「google_pixel_4a」	「Google Pixel 4a 手機」	["Google", "Pixel"]	["Pixel > 手機"]	349.00
「google_pixel_stand」	「Google Pixel Stand」	["Google", "Pixel"]	["Pixel > featured accessories"]	79.00
「google_pixel_buds」	「Google Pixel Buds」	["Google", "Pixel"]	["Pixel > featured accessories"]	179.00
"google_pixel_5_case"	「Google Pixel 5 保護殼」	["Google", "Pixel"]	["Pixel > featured accessories"]	40.00
"google_pixel_4a_5g_case"	「Google Pixel 4a (5G) 保護殼」	["Google", "Pixel"]	["Pixel > featured accessories"]	40.00
"google_pixel_4a_case"	「Google Pixel 4a 保護殼」	["Google", "Pixel"]	["Pixel > featured accessories"]	40.00

設定選項

在 Vertex AI Search for commerce 中，加成會套用為搜尋演算法產生的基本關聯分數乘數。您可以直接在搜尋要求中，使用提升規格設定提升規則，或將供應控制項附加至供應設定。在回覆中，符合這些條件的項目會獲得經過修改的關聯分數，因此會出現在結果清單中較高或較低的位置，但不會完全移除。如要設定搜尋提升或埋沒控制項，請按照下列步驟操作：

Cloud 控制台

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

2. 在「放送控制項」分頁下方，按一下控制項右側的「編輯」圖示 。

3. 在「編輯控制項」飛出式視窗中，按一下「控制項名稱」欄位下方的欄位，即可修改控制項名稱。

4. 選用：如要搜尋，請在「觸發條件」部分中，選取會觸發這項控制項的使用者行為類型。「瀏覽類別」和「搜尋」部分會變暗。

5. 選用步驟：編輯「比對搜尋字詞」。

   注意： 如果您指定類別或查詢字詞條件，加上時間範圍條件，則只有在同時符合這兩項條件時，系統才會套用控管設定。

6. 選用：按一下「新增時間範圍」選項，新增一或多個可套用這項控管措施的時間範圍。

   注意： 如果除了這類條件外，您還指定了時間範圍條件，則只有在同時符合這兩項條件時，系統才會套用控制項。

7. 按一下「繼續」，前往「動作」部分。

8. 在「升級/埋沒產品」欄位中新增產品屬性的篩選條件。

   使用「篩選和排序結果」一文所述的篩選運算式語法。舉例來說，如要指定「product1」和「product2」的紅色和藍色版本：(id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

9. 如要設定升級強度，請使用「升級/埋沒值」滑桿。正值會提升結果，負值則會隱藏結果。按一下「Continue」(繼續)。

10. 在「供應設定」部分，選取要套用控制項的供應設定。

11. 提交控制項設定。

您現在可以在專案的「放送控制選項」下方，找到新增的「提高或降低排名」控制規則，並列為新的「控制類型」。瞭解如何透過「建立控制選項」建立新的升級和隱藏控制選項。

JSON

這項範例說明如何依價格提高排名。

假設您想優先顯示較便宜的產品 (低於 $95 美元)，並降低昂貴產品的優先順序 (高於 $95 美元)，可以套用加成規格。

{
  "condition_boost_specs": [
    {
      "condition": "price: IN(*, 95.0e)",
      "boost": 0.5
    },
    {
      "condition": "price: IN(95.0e, *)",
      "boost": -0.5
    }
  ]
}

在本例中，價格低於 $95 美元的產品會獲得促銷活動 (0.5)，價格高於 $95 美元的產品則會遭到降級 (-0.5)。

在結果中，"nest_mini_2nd_gen"、"google_home_mini" 和 "nest_hub" 可能是前三個，而 "nest_audio"、"nest_hub_max" 和 "google_home_max" 可能是最後三個。不過，與依價格排序不同 (如「篩選及排序結果」一節所述)，系統不會預先決定特定順序。

搜尋量增幅

如要搜尋，請在 SearchRequest 中直接加入提升規格 (boostSpec) 和 condition_boost_specs，動態套用相符項目的排名分數。

條件和觸發條件

搜尋提升功能可設為有條件啟用。您可以根據下列條件觸發加成規則：

• 查詢字詞：只有在使用者搜尋特定字詞時才套用加成 (例如，查詢包含「外套」時，加成冬季大衣)。

• 時間範圍：只在特定促銷期間套用加成。

• 全域：將加成套用至特定設定放送的所有查詢。

搜尋要求和回應範例

在先前顯示的範例資料集中，如果搜尋「Google speaker」，則會依任意順序取得「nest_mini_2nd_gen」、「nest_audio」、「nest_hub_max」、「nest_hub」、「google_home_max」和「google_home_mini」。

查看搜尋要求和回應範例

Java

import com.google.cloud.retail.v2.SearchRequest;
import com.google.cloud.retail.v2.SearchRequest.BoostSpec;
import com.google.cloud.retail.v2.SearchRequest.BoostSpec.ConditionBoostSpec;
import com.google.cloud.retail.v2.SearchResponse;
import com.google.cloud.retail.v2.SearchServiceClient;

public static void searchProductsWithBoostSpec(String query, int pageSize,
    String condition, float boostStrength) throws IOException, InterruptedException {
  BoostSpec boostSpec = BoostSpec.newBuilder()
      .addConditionBoostSpecs(ConditionBoostSpec.newBuilder()
          .setCondition(condition)
          .setBoost(boostStrength)
          .build())
      .build();

  SearchRequest searchRequest = SearchRequest.newBuilder()
      .setPlacement(DEFAULT_SEARCH_PLACEMENT_NAME)
      .setBranch(DEFAULT_BRANCH_NAME)
      .setVisitorId(VISITOR_ID)
      .setQuery(query)
      .setPageSize(pageSize)
      .setBoostSpec(boostSpec)
      .build();

  try (SearchServiceClient searchClient = SearchServiceClient.create()) {
    SearchResponse response = searchClient.search(searchRequest).getPage().getResponse();
    System.out.println("Search response: " + searchResponse);
  }
}

推薦次數增加

建議的放送量提升功能是透過放送控制項管理。與搜尋不同，最佳化建議提升功能不支援以查詢為準的條件 (因為沒有使用者查詢)。而是套用至所連結供應設定產生的所有預測。因此，您通常會將升級或隱藏放送控制項附加至放送設定，藉此設定建議，而不是在要求中傳遞升級規格。

建議的支援欄位

定義要在建議中提升哪些產品時，請使用篩選運算式。標準建議篩選功能僅限文字欄位，提升功能則支援其他數值欄位。

欄位類型	支援的欄位	說明
文字	productId、brands、categories、genders、ageGroups、colorFamilies、colors、sizes、title、materials、patterns、conditions、attributes.key、tags	標準欄位可供篩選和提升。請注意，tags 是與產品相關的自訂標籤。
數值	price、discount、rating、ratingCount	僅適用於提高/降低排名。你可以根據價格、折扣或使用者評分，透過這些欄位提升產品曝光度。

詳情請參閱「篩選器建議」中的「提升/隱藏支援的欄位」一節。

提高高評分產品的曝光度

舉例來說，您希望高評分電影在「你可能也會喜歡」推薦面板中顯示在較高的位置，在本應用情境中，請建立放送控制項，以提高評分次數超過 100 次的項目。設定控制項時，請注意下列事項：

• 控制項類型：提高或降低排名

• 產品選擇：建議

• 動作：

  • 篩選器運算式：ratingCount > 100

  • 提升價值：0.5

這項控制項可確保推薦清單優先顯示熱門且評價良好的項目，同時維持使用者的個人化相關性。

偵錯及疑難排解

所有產品都符合無限次加成資格，但使用者套用的篩選條件會從搜尋回應中排除產品。如要排解搜尋和瀏覽結果中未顯示加強曝光產品的問題，請檢查：

• 多項提升規則 (包括埋葬降級)：檢查提升模式設定 (總和或最大值)，並決定最終分數。
• 關聯性：產品必須與查詢相關，並通過關聯性篩選器。如果搜尋查詢是「Nike 鞋」，而產品名稱是「Air Jordans」，雖然字詞不相符，但兩者語意關係密切，因此相關性分數很高。如果搜尋查詢是 Nike，則「黃色外套」等產品名稱的關聯性分數偏低。同樣地，如果產品名稱是與任何字詞都無關的神秘型號，任何查詢的關聯性分數都會很低。
• 篩選器：篩選規則會覆寫任何加成規則，並防止加成產品出現在結果中。篩選器一律會套用至貼文。如果產品套用了使用者篩選器，或是產品類別篩選器用於瀏覽，則加成功能完全無法運作。

教學課程：增強功能

本教學課程會介紹幾個產品增強功能示例。

---

如要直接在 Cloud Shell 編輯器中按照逐步指南操作，請按一下「Guide me」(逐步引導)：

逐步引導

---