結果を向上させる

小売業向け Vertex AI Search には、検索で昇格させるレコードを指定できる機能があります。ブースト ルールを適用して、返された検索アイテムに優先順位を付けたり、優先順位を下げたりすることで、結果のランキングを制御できます。

ブースト ルール

ブースティング ルールは、関連性に基づく並べ替え検索や、事前並べ替えスコアのある閲覧結果など、ベースとなる関連性スコアがある場合にのみ適用できます。ブーストは、これらの検索結果とブラウジング結果に適用される乗数関数です。

注: フィルタリング ルールは常にブースト ルールよりも優先されます。検索結果のフィルタリングと並べ替えの詳細については、結果のフィルタリングと並べ替えをご覧ください。

ブーストまたは埋め込み

1 つの商品には、検索サービス API の boostspec クラスで設定された複数のブースト ルールまたは抑制ルールを適用できます。

• 正の数値は、ブースト ルール、プロモーションを示します。
• 負の数は、昇格ではなく降格である、埋め込みルールを示します。

構成オプション

• ブースト効果の合計: 降格と昇格がある場合、小売業向け Vertex AI Search はこれらの値を合計します。結果として得られる値は、ブーストの低下またはネット バリー効果のいずれかになります。
• 最大ブースト ルール（デフォルト）: Vertex AI Search for Retail は、最大値がどちらであるかをチェックし、他のルールは無視します。

1 つの商品に複数のブーストまたは抑制ルールが設定されている

複数のブースト ルールまたは抑制ルールが商品に適用され、ブースト値の合計または最大値が最終的なスコアになります。

同じ商品に複数のブースト ルールが適用されている場合は、他の商品のスコアによってその商品がトップの座から追い出されていないか常に確認してください。この問題が発生しないように、デフォルトで最大モードが設定されています。

1 つの商品に 2、3、0.5 のブーストが適用され、別の商品に 0.5 のブーストが 1 つ適用されているとします。ブースト スコアは 0.5 しか得られなかったものの、繰り返しブーストすると、他の商品よりも上位にランクインします。ブーストの仕様を慎重に確認し、重複していないか、意図したとおりに重複していることを確認します。

フィルタのオーバーライド

ブースト ルールよりも優先される 2 種類のフィルタ:

1. ユーザー指定: 価格やブランドなどです。ウェブサイトのタイルとファセットとしてエンドユーザーに表示されます。

2. トピック性（関連性）: これらのフィルタは、検索クエリ（ブラウジングではない）にのみ存在します。関連性の低い商品を検索結果から除外します。たとえば、「冷蔵庫」と検索しても、電子レンジや冷蔵庫の取っ手などのアクセサリーは返されません。冷蔵庫の検索で電子レンジをブーストしないことをフィルタが認識します。

検索とブラウジングで使用できるフィルタ

• 検索: トピック性フィルタと、ユーザーが適用した他のフィルタ（オンサイト ファセットなど）。
• 閲覧: テキスト クエリがないため、ユーザーが適用したフィルタのみが適用されます。また、フィルタが適用され、商品（スーツなど）が正しい商品カテゴリ（セーターなどではない）に属していることが確認されます。

デバッグとトラブルシューティング

すべての商品が無制限のブースト対象ですが、ユーザーが適用したフィルタによって、検索レスポンスから商品が除外されます。ブーストされた商品が検索結果やブラウジング結果に表示されない理由をトラブルシューティングするには、次の点を確認します。

• 複数のブースト ルール（埋め込みの降格を含む）: ブーストモードの設定（合計または最大）を確認し、最終的なスコアを決定します。
• 関連性: 商品はクエリに関連し、関連性フィルタを通過している必要があります。検索クエリがナイキの靴で、商品のタイトルが Air Jordans の場合、単語は一致していませんが、セマンティックな関係が近いため、関連性スコアが高くなります。「yellow jacket」などの商品タイトルは、Nike の検索クエリとの関連性スコアが低くなります。同様に、商品のタイトルが、どの単語とも関連性のない難解なモデル番号である場合、どのクエリに対しても関連性スコアは低くなります。
• フィルタ: フィルタリング ルールはブースト ルールをオーバーライドし、ブーストされた商品が検索結果に表示されないようにします。フィルタは常にブーストの上に適用されます。商品にユーザーが適用したフィルタがある場合や、商品カテゴリがブラウジング用にフィルタされている場合、ブーストはまったく機能しません。

ブーストのチュートリアル

このチュートリアルでは、商品ブーストの例を説明します。

---

このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。

ガイドを表示

---

ブーストを構成する

このページでは、次のデータセットを例として使用します。説明に必要なフィールドのみが含まれています。

データセットの例

プロダクト データセットの例

id	title	brands	categories	price_info.price
「nest_mini_2nd_gen」	「Nest Mini（第 2 世代）」	["Google", "Nest"]	["Nest > speakers and displays"]	49.00
「nest_audio」	「Nest Audio」	["Google", "Nest"]	["Nest > speakers and displays"]	99.99
「nest_hub_max」	「Nest Hub Max」	["Google", "Nest"]	["Nest > speakers and displays"]	229.00
「nest_hub」	「Nest Hub」	["Google", "Nest"]	["Nest > speakers and displays"]	88.99
「google_home_max」	「Google Home Max」	["Google", "Nest"]	["Nest > speakers and displays"]	299.00
「google_home_mini」	「Google Home Mini」	["Google", "Nest"]	["Nest > speakers and displays"]	49.00
「google_pixel_5」	「Google Pixel 5」	["Google", "Pixel"]	["Pixel > phones"]	699.00
「5G 版 google_pixel_4a」	「5G 版 Google Pixel 4a」	["Google", "Pixel"]	["Pixel > phones"]	499.00
「google_pixel_4a」	「Google Pixel 4a Phones」	["Google", "Pixel"]	["Pixel > phones"]	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

検索リクエストとレスポンスの例

たとえば「Google スピーカー」を検索する場合、「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);
  }
}

ブースト仕様の例

安い商品（95 ドル未満）に優先し、高価な商品（95 ドル超）の優先度を下げる場合、ブースト仕様を以下のように適用できます。

JSON

{
  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" が最初の 3 つになり、"nest_audio"、"nest_hub_max"、"google_home_max" は最後の 3 つになります。ただし、フィルタと並べ替えの結果で説明されているように、価格順とは異なり、特定の順序は事前に決まっていません。