提升成效

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

強化規則

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

提高或降低排名

一個產品可受多個升級或隱藏規則限制，這些規則是在搜尋服務 API 的 boostspec 類別中設定。

• 正數表示加成規則或促銷活動。
• 負數表示埋葬規則，也就是降級而非升級。

設定選項

• 加成效果總和：如果同時有降級和升級，商家適用的 Vertex AI Search 會加總這些值。最終的總和會是降低的升幅或淨埋沒效果。
• 最高升幅規則 (預設)：Vertex AI Search for Commerce 會檢查最高值，並忽略其他規則。

為一項產品設定多項升級或隱藏規則

多項升級或隱藏規則可能會影響產品，最終分數則會由升級值總和或最大值決定。

如果多個提升規則套用至同一產品，請務必檢查是否有其他產品的分數將該產品擠出最高排名。系統預設為「最高」模式，因此較不容易發生這個問題。

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

覆寫篩選器

有兩種篩選器會優先於升級規則：

1. 使用者指定：例如價格或品牌，會以圖塊或切面形式顯示在網站上。

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

搜尋和瀏覽功能提供的篩選器

• 搜尋：主題篩選器，以及使用者套用的任何其他篩選器，例如網站上的分類。
• 瀏覽：由於沒有文字查詢，系統只會套用使用者套用的篩選條件。系統也會套用篩選條件，確認產品 (例如西裝) 屬於正確的產品類別 (而非毛衣)。

偵錯和疑難排解

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

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

教學課程：增強功能

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

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

逐步引導

設定增強功能

本頁會使用下列資料集做為範例。只會顯示說明所需的欄位。

範例資料集

搜尋要求和回應範例

舉例來說，如果搜尋「Google speaker」，系統會傳回「nest_mini_2nd_gen」、「nest_audio」、「nest_hub_max」、「nest_hub」、「google_home_max」和「google_home_mini」，且順序不一定。

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);
  }
}

升幅規格範例

假設你想優先顯示價格較低的產品 (低於 95 美元)，並降低價格較高產品 (高於 95 美元) 的優先順序。您可以套用下列提升規格：

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

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