検索用のファセット

このページでは、ファセット機能の一部とその使用方法について説明します。

このセクションでは、ファセットに関連する用語の基本的な定義と説明を示します。

  • ファセット: ファセット検索を実行するファセットの仕様。結果をフィルタリングすることで、ユーザーが必要な情報を見つけやすくなります。たとえば、ユーザーが shoes を検索した場合、price、attributes.department、attributes.colors、attributes.size などのファセットが返される可能性があります。

  • システム属性: 事前定義されたシステム属性は、商品に関する詳細情報を提供する既存の商品フィールドです。これには、brand、availability、color、size などの事前定義された商品属性が含まれます。

  • カスタム属性: カスタム属性は、Product.attributes フィールドを使用して定義する追加の属性です。たとえば、style、color、department などがあります。

  • ファセットキー: これはファセットの名前です。たとえば、attributes.department や sizes などです。ファセットキーは属性名に対応しています。たとえば、（商品）システム属性名 sizes はファセットキー sizes に対応します。同様に、（商品）カスタム属性名 department はファセットキー attributes.department に対応します（カスタム属性の場合、ファセットキーを取得するために、接頭辞 attributes. がカスタム属性名に追加されます）。属性名、ファセットキー、ファセット名は同じ意味になります。

  • ファセット値: テキストキーの場合、これはファセットのテキスト値の 1 つです。たとえば、テキスト ファセットキー brands には Asics や Nike のようなテキスト値を含めることができます。数値キーの場合、ファセット値はインターバルです。たとえば、数値ファセット鍵の料金には [20, 30) という形式のインターバルがある可能性があります。

  • 属性またはファセットの型: テキストまたは数値のいずれかになります。

  • 固定されたファセット: これはオプション enableDynamicPosition=false を指定して FacetSpec を使用し、リクエストで渡すファセットです。ファセットは、レスポンスのすべての動的ファセットの前に、元の順序で表示する必要があります。

  • 動的ファセット: これらは Retail Search がランク付けするファセットです。これらは、オプション enableDynamicPosition=true を指定してリクエストで渡すか、Retail Search モデルに従ってフェッチされます。その後、最も関連性の高い同じトレーニング済みモデルによって上位にランキングします。

  • ファセット可能、動的ファセット、タイル構成可能: 動的ファセットに対して属性が有効になっている場合、Retail Search は、過去のユーザーの行動（ファセットのクリックや表示など）に基づいて、この属性を動的ファセットとして自動的に使用できます。属性の動的ファセットを有効にするには、その属性のインデックス登録も有効にする必要があります。

  • フィルタ: フィルタ構文は、フィルタ対象となる商品の 1 つ以上のフィールドから述語を生成するための式言語で構成されます。たとえば、ユーザーがファセットキー attributes.brands のファセット値 Asics を操作した場合、フィルタの一部は (attributes.brands:ANY(\"Asics",\"Nike\")) になります。フィルタ式では大文字と小文字が区別されます。フィルタの詳細については、こちらのユーザーガイドをご覧ください。

動的ファセットとタイルについて

サービス構成で動的ファセットが有効な場合、検索では、ファセットのクリックや表示などの過去のユーザーの行動に基づいて、この構成の検索結果の動的ファセットとして属性を自動的に使用できます。動的ファセットは、オプション enableDynamicPosition=true を指定してリクエストで渡すか、Retail Search モデルに従ってフェッチされます。その後、最も関連性の高い同じモデルによって上位にランキングします。

デフォルトでは、ほとんどのファセットキーはファセット化可能です。API の動的ファセット設定は、コマース向け検索コンソールのサイト全体の属性コントロールで、選択した特定のファセットキーに対して上書きできます。つまり、一部のファセットキーをファセット不可にするには、[Attribute controls] タブでこれらのキーごとに動的ファセットを無効にする必要があります。詳細については、サイト全体の属性コントロールを管理するをご覧ください。

動的ファセットとタイルは、正確な商品カタログデータに基づいてのみ作成できます。ただし、この機能がサイトで最適に機能するように、ファセット モデルはサイトのアクティビティから学習する必要があります。このために、検索イベント アップロードのクエリ、カテゴリ、フィルタのフィールドを正確に設定する必要があります。

サービス構成で動的ファセットとタイルが有効になっておらず、動的ファセットとタイルを有効にしたばかりの場合は、動的ファセットとタイルが機能するまで 3～4 日お待ちください。

ファセット コントロール

このセクションでは、さまざまな種類のファセット コントロールを作成する手順について説明します。これらのコントロールの多くは、タイルの動作も制御します。

特に明記されていない限り、Vertex AI Search for Commerce ではこれらのすべてのファセット コントロールで大文字と小文字が区別されます。

特定のファセット値とタイル動作を制御するには、コマース向け検索コンソールの [ファセット コントロール] タブに移動します。

[Controls] ページに移動

[コントロールの作成] をクリックして、検索から返されるファセットを変更します。[コントロールの作成] ペインが開きます。[コントロール タイプ] フィールドをクリックしてプルダウン メニューを開き、コントロールのタイプを選択します。それぞれにつき、ファセットを制御するためのオプションを含むダイアログが開きます。すべてのファセットのコントロール タイプには、少なくとも属性情報が必要ですが、フォームによって必要な情報は若干異なります。

代替テキスト

ファセット値とタイル値を無視するコントロールを作成する

特定のファセットキーとタイルキーの不要なファセット値とタイルの値を削除する場合は、ファセット値とタイル値を無視するコントロールを作成します。

このコントロールは、不要なファセット値とタイル値（NA や Not_applicable など）の消去に役立ちます。ただし、10 月であれば、Easter のような季節的な傾向を消去するためにも使用できます。

ファセット値とタイル値を無視するコントロールを作成するには:

  1. Search for commerce コンソールの [コントロール] ページに移動します。

    [Controls] ページに移動

  2. [ファセット コントロール] タブで、 [コントロールを作成] をクリックします。

    [コントロールを作成する] ペインが開きます。

  3. [ファセットとタイルの値を無視する] を選択します。

  4. 属性名を指定します。

    たとえば、システム属性の場合は brands です。 カスタム属性の場合、名前は attributes. で始まります（例: attributes.department、attributes.colors）。

  5. （省略可）[開始時間] と [終了時間] を指定します。

  6. 1 つ以上の属性値を [値を無視] として指定します。

    たとえば、NA、Not_applicable、Easter です。

  7. [送信] をクリックします。

ファセット値とタイル値を置換するコントロールを作成する

複数の類似ファセット値とタイル値を 1 つに統合する場合は、ファセット値とタイル値を置換するコントロールを作成します。

ファセット値とタイル値の置換は、ファセット値とタイル値の結合とも呼ばれます。

競合や無駄なマッピングを避けるため、属性値 facet_value_1 が別の属性値 facet_value_2 に置き換えられた場合、後者は別の属性値に置き換えることはできません。たとえば、ruby を dark red に置き換えた場合、後で dark red を red に置き換えることはできません。

各属性名について、[値を置き換える] フィールドに属性値を複数回指定することはできません。

ファセット値とタイル値を置換するコントロールを作成するには:

  1. Search for commerce コンソールの [コントロール] ページに移動します。

    [Controls] ページに移動

  2. [ファセット コントロール] タブで、 [コントロールを作成] をクリックします。

    [コントロールを作成する] ペインが開きます。

  3. [ファセット値とタイル値を置換する] を選択します。

  4. 属性名を指定します。

    この機能は、attributes で始まる接頭辞（attributes.department や attributes.colors など）で始まるカスタム属性でのみ機能します。

  5. 1 つ以上の属性値を [値を置換] として指定します（例: RED、Red、dark red、bright red、ruby、crimson）。

    属性値は [値を置換] フィールドに 1 回だけ指定できます。

  6. 単一の属性値を [代替語句] として指定します（例: red）。

  7. [送信] をクリックします。

置き換えられた値はすぐに消える可能性がありますが、代替語句の表示には最大 4 日かかる場合があります。

ファセット値を置き換えるコントロールが有効になったときに、レスポンスでファセットキー（この例では attributes.colors）が返されると、置換されたファセット値（dark red や crimson など）はファセット値として存在しなくなります。これらは代替語句（red など）に置き換えられます。

ファセットを結合するコントロールを作成する

製品が Retail Search のデータベースに取り込まれる前に、製品のカスタム属性の名前と値を正しく設定することをおすすめします。ただし、カスタム属性名を変更できない場合は、ファセットを結合するコントロールを作成できます。ファセットを別のファセットと統合（置換）する場合は、ファセットを結合するコントロールを作成します。たとえば、attributes.colors_jeans、attributes.colors_clothes、attributes.colors_hue などの色のカスタム ファセットキーが複数あり、attributes.colors という既存のカスタム ファセットキーに置き換えるとします。

結合されたキーは、次のようにする必要があります。

  • 永続的で、タイプが変更されないカスタム属性名。
  • 取り込まれた多くの商品の属性名。

結合されたキーを削除すると、動的ファセットモデルのトレーニングに使用されるエンゲージメント データが失われます。

各商品のインデックス登録中に、キーと結合されたキーの両方が属性名として含まれます。ただし、商品ごとに許可される属性の最大数を超えた場合は、キーと結合されたキーの両方が属性名として含まれます。属性の最大数が商品ごとに許可される割り当てを超えると、属性名になる結合されたキーが任意に切り捨てられます。

たとえば、特定の商品のカスタム属性名の最大数がすでに設定されており、そのカスタム属性名の 1 つが colors_jeans であるとします。ファセット統合コントロールを使用して attributes.colors_jeans を attributes.colors に結合するとします。この場合、属性名 colors には製品あたりのカスタムキーの最大数がすでに含まれているため、この特定の商品には追加されません。結合されたキーは商品の（カスタム）属性名から削除されませんが、動的ファセットキーとして返されません。同様に、同じキーを持つ複数のキーを結合し、結合されたキーの属性値の数が許可された属性値の制限を超えた場合、Retail Search によって属性値が任意に切り捨てられます。

ファセットを別のファセットに結合するコントロールを作成するには:

  1. Search for commerce コンソールの [コントロール] ページに移動します。

    [Controls] ページに移動

  2. [ファセット コントロール] タブで、 [コントロールを作成] をクリックします。

    [コントロールを作成する] ペインが開きます。

  3. [ファセットを統合] を選択します。

  4. 別のファセットに結合する有効なカスタム ファセットキーを指定します。

    この機能は、attributes で始まる接頭辞（attributes.colors_clothes や attributes.colors_jeans など）で始まるカスタム属性でのみ機能します。

  5. 有効なカスタム ファセットキーを結合キーとして指定します。

  6. [送信] をクリックします。

このコントロールが有効になるまで、通常、2 ～ 4 日かかります。

数値間隔を設定するコントロールを作成する

数値間隔を設定するコントロールを使用すると、計算された間隔を受け入れる代わりに、数値ファセットの間隔を決定できます。

たとえば、Retail Search はカスタムの数値ファセットキー attributes.monitor_size に対して、間隔 [10,15)、[15,20) [20,25)、[25,30)、[30,40)、[40,50)、[50,infinity] で計算する可能性があります。しかし、間隔 [0,14)、[14,17)、[17,21)、[21,24)、[24,27)、[27,32)、[32,infinity] が好ましい場合があります。

算出間隔と設定間隔について

すべての数値カスタム属性と数値システム属性 price、rating、ratingCount について、Retail Search では、すべての（数値）属性値の分布に基づいて、端数を丸めた境界があるいくつかの間隔が計算されます。リクエストで間隔を指定することもできます。最後のオプションとして、次の数値間隔を設定するコントロールを使用して、各数値ファセットキーに独自の間隔を設定できます。

使用する間隔を決定する優先順位は次のとおりです。

  1. まず、数値ファセットキーのリクエストで一部の間隔が指定された場合、これらの間隔は保持されます。

  2. 数値ファセットキーのリクエストで間隔が指定されず、数値ファセットキーが動的か、間隔なしでリクエストに渡された場合、数値間隔を設定するコントロールを使用して含めた間隔は、これらの間隔が空でなければその数値ファセットキーに追加されます。

  3. 上記以外の場合は、前述の端数を丸めた境界がある計算された間隔が追加されます。

コントロールを作成する

数値ファセットキーとタイルキーに、コマース向け Vertex AI Search が計算した数値ではなく、独自の間隔を指定する場合は、数値間隔を設定するコントロールを作成します。

間隔を追加するコントロールを作成するには:

  1. Search for commerce コンソールの [コントロール] ページに移動します。

    [Controls] ページに移動

  2. [ファセット コントロール] タブで、 [コントロールを作成] をクリックします。

    [コントロールを作成する] ペインが開きます。

  3. [数値ファセットとタイルのインターバルを設定する] を選択します。

  4. 数値属性の名前を指定します。

    たとえば、システム属性の場合は price です。 カスタム属性の場合、名前は attributes. で始まります（例: attributes.number_of_pieces）。

  5. [最小値] または [最大値] の少なくとも 1 つを指定します。両方を指定する場合、最小値は最大値より大きな値にできません。各境界は、[Inclusive] または [Exclusive] に設定できます。

  6. インターバルを追加するには、[+ インターバルを追加] をクリックします。インターバルの最大数は 40 です。

  7. [送信] をクリックします。

ファセットとタイルを削除するコントロールを作成する

ファセットを削除するコントロールを使用すると、動的ファセットから特定のファセットキーとタイルキーを削除できます。ファセットキーとタイルキーは、特定のクエリ語句またはページカテゴリに基づいて削除されます。

このファセット コントロール タイプは、属性自体を制御します。このファセット コントロール タイプが適用されている場合、このファセットに関連付けられているファセットやタイルは、検索結果として返されません。

このコントロールは、一部のクエリ語句または参照に対するファセットキーとタイルキーを削除する場合に役立ちます。たとえば、このコントロールを使用して、クエリ shoes のファセットキー attributes.shoe_size を削除できます。

マーチャンダイジング コンソールまたは Google Cloud コンソールを使用して、ファセットまたはタイルを削除できます。

マーチャンダイジング コンソール

  1. 管理者から提供された URL をクリックします。サインインします。

    マーチャンダイジング コンソールの [コントロール] ページが表示されます。

  2. [Create control] をクリックします。

  3. エンドユーザーの目標と必要なタイミングを定義します。すべての質問に回答する必要があります。[次へ] をクリックします。

  4. コントロールを選択します。コントロールの名前を入力し、[検索] プロダクトを選択して、コントロールの種類 [ファセットを削除] を選択します。

  5. [ファセットを削除] コントロールを構成します。

    1. [トリガー] で、関連する検索クエリに条件（含む、範囲外など）を指定して、この制御をトリガーするカタログ属性を定義します。カタログ属性が構成されていない場合、このコントロールは常に適用されます。

    2. [期間] を入力して、[適用可能な期間] を定義します。指定した期間のいずれかが満たされると、指定した期間のいずれかでカタログ属性がクエリと照合されます。期間を追加を使用して期間を追加します。

    3. 前の [トリガー] セクションで指定したクエリ用語の動的ファセットに表示したくない属性については、[ファセットを削除するアクション] セクションで [無視する属性] を定義します。

    4. [class="material-icons">add_box属性を追加] をクリックして、属性を追加します。

  6. [送信] をクリックして、制御リクエストを承認者に送信します。送信されたリクエストのステータスは、マーチャンダイジング コンソールで確認できます。制御リクエストは、いつでも削除できます。

Cloud コンソール

  1. Search for commerce コンソールの [コントロール] ページに移動します。

    [Controls] ページに移動

  2. [ファセット コントロール] タブで、 [コントロールを作成] をクリックします。[コントロールの作成] ペインが開きます。

  3. [ファセットとタイルを削除する] を選択します。

  4. 各コントロールは検索またはブラウズのいずれか一方に適用されます。両方に適用することはできません。次のいずれかを行います。

    • 検索クエリについては、[検索] をクリックして、部分一致のクエリ語句か、完全一致のクエリ語句を指定します。詳細については、クエリ語句と条件をご覧ください。どちらの場合もクエリ語句は小文字で指定する必要があります。たとえば、部分的なクエリ キーワード shirts、polo、jackets、t-shirt、fall coats を指定できます。小文字のクエリがこれらのクエリ語句のいずれかである場合や、これらのクエリ語句のいずれかを単グラムとして含む場合、次に指定するファセットキーは動的ファセットとして表示されません。

    • ブラウジングの場合は、[カテゴリを表示] をクリックして、ページのカテゴリを指定します。カテゴリまたは部門のリスト（最大 10 個）を指定できます。フォーマットは、ユーザー イベントのページ カテゴリと同じである必要があります。たとえば、page_categories : Sales > 2023 Black Friday Deals になります。後者とイベント（ブラウズ用）に渡されたページカテゴリの 1 つの間に完全一致（大文字と小文字を区別）がある場合、次に指定されたファセットキーは動的ファセットとして表示されません。

  5. [無視する属性] で、有効なファセットキーを 1 つ以上指定します。

  6. [送信] をクリックします。

ファセットを強制的に返すコントロールを作成する

ファセットを強制的に返すコントロールは、特定のクエリや参照イベントに対する動的ファセットキーのリストの位置に影響を与えることがあります。

このコントロールは、一部のクエリ キーワードまたは参照に対する動的ファセットの中で、特定のファセットキーを強制的に表示する場合に役立ちます。たとえば、このコントロールを使用して、クエリ handbags に対してファセットキー brands を 10 以下の位置に表示できます。ファセット brands がこのクエリの動的ファセットに対してすでに上位 10 位に入っている場合は、あまり動きません。上位 10 位に入っていない場合や、動的ファセットのリスト内にない場合は、おおよそ 10 位の位置に移動します。

ファセットを強制的に返すコントロールは、マーチャンダイジング コンソールまたは Google Cloud コンソールで作成できます。

マーチャンダイジング コンソール

  1. 管理者から提供された URL をクリックします。サインインします。

    マーチャンダイジング コンソールの [コントロール] ページが表示されます。

  2. [Create control] をクリックします。

  3. エンドユーザーの目標と必要なタイミングを定義します。すべての質問に回答する必要があります。[次へ] をクリックします。

  4. コントロールを選択します。コントロールの名前を入力し、[検索] または [ブラウジング] プロダクトを選択して、コントロール タイプ [強制的にファセットを返す] を選択します。

  5. [ファセットを強制的に返す] コントロールを構成します。

    1. [トリガー] で、関連する検索クエリに条件（含む、範囲外など）を指定して、この制御をトリガーするカタログ属性を定義します。カタログ属性が構成されていない場合、このコントロールは常に適用されます。

    2. [期間] を入力して、[適用可能な期間] を定義します。指定した期間のいずれかが満たされると、指定した期間のいずれかでカタログ属性がクエリと照合されます。期間を追加を使用して期間を追加します。

    3. [Force return facets actions] セクションで [Attribute position adjustment] を定義します。ここでは、前のトリガー セクションで設定したクエリまたはページ カテゴリの動的ファセットまたはタイルに含める属性を選択できます。たとえば、位置を 5 に設定すると、ファセットはページの下から 5 番目以上の位置に表示されます。

    4. [調整を追加] をクリックして、このコントロールで管理する属性を追加します。

  6. [送信] をクリックして、制御リクエストを承認者に送信します。送信されたリクエストのステータスは、マーチャンダイジング コンソールで確認できます。制御リクエストは、いつでも削除できます。

Cloud コンソール

  1. Search for commerce コンソールの [コントロール] ページに移動します。

    [Controls] ページに移動

  2. [ファセット コントロール] タブで、 [コントロールを作成] をクリックします。

    [コントロールを作成する] ペインが開きます。

  3. [Force return facets] を選択します。

  4. 各コントロールは検索またはブラウズのいずれか一方に適用されます。両方に適用することはできません。次のいずれかを行います。

    • 検索クエリについては、[検索] をクリックして、部分一致のクエリ語句か、完全一致のクエリ語句を指定します。詳細については、クエリ語句と条件をご覧ください。どちらの場合もクエリ語句は小文字で指定する必要があります。たとえば、部分的なクエリ キーワード shirts、polo、jackets、t-shirt、fall coats を指定できます。小文字のクエリがこれらのクエリ キーワードのいずれかである場合や、クエリ キーワードのいずれかが単グラムとして含まれている場合は、次に指定するファセットキーが動的ファセットのそれぞれの位置の周辺か上に表示されます。

    • ブラウジングの場合は、[カテゴリを表示] をクリックして、ページのカテゴリを指定します。カテゴリまたは部門のリスト（最大 10 個）を指定できます。フォーマットは、ユーザー イベントのページ カテゴリと同じである必要があります。たとえば、page_categories : Sales > 2023 Black Friday Deals になります。後者とイベント（ブラウズ用）に渡されたページカテゴリの 1 つの間に完全一致（大文字と小文字を区別）がある場合、次に指定されたファセットキーは、動的ファセットの中でそれぞれの位置の周辺か上に表示されます。

  5. 有効なファセットキーと 1～100 の整数位置を指定します。

  6. 複数のファセットキーを指定する場合は、[調整を追加] をクリックして再度前の手順で操作します。

  7. [送信] をクリックします。

動的ファセットを再ランク付けするコントロールを作成する

動的ファセットのランク付けは、クエリ（検索）またはページのカテゴリ（ブラウジング）によって異なります。動的ファセットの再ランク付けコントロールを使用すると、ユーザーが操作した一部のファセット値に応じてランク付けを変更することもできます。

たとえば、このコントロールを使用して、ユーザーが検索または参照後にファセットキー attributes.department のファセット値 watches を操作した場合、ランキングもファセット値 watches によって異なります。再ランク付けするファセット値をファセットキーで指定することも、ファセットキーのみを指定して、そのファセット値すべてで再ランク付けすることもできます。

動的ファセットを再ランク付けするコントロールを作成する

  1. Search for commerce コンソールの [コントロール] ページに移動します。

    [Controls] ページに移動

  2. [ファセット コントロール] タブで、 [コントロールを作成] をクリックします。

    [コントロールを作成する] ペインが開きます。

  3. [動的ファセットを再ランク付けする] を選択します。

  4. 有効なカスタム テキスト ファセットキーを指定します（すべてのカスタムキーには attributes. という接頭辞が付いています）。

  5. 特定のファセット値を指定することも、すべてのファセット値に適用することもできます。

    • すべてのファセット値を再ランク付けする場合は、 [すべての値の変更] をクリックします。

    • 特定のファセット値を再ランキングする場合は、 [選択した値の変更] をクリックします。次に、再ランク付けするすべてのファセット値を挿入します（大文字と小文字が区別されます）。たとえば、watches、luggages、bed になります。

  6. [送信] をクリックします。

次の理由により、ユーザーが操作したすべてのファセットキーをリクエストで渡す必要があります。

  • ユーザーがセールスを検索し、ファセットキーの最初のリストが表示されたとします。
  • 次に、ユーザーはファセットキー attributes.age_group を最初に操作します。
  • 次に、ファセット値 watches を持つファセットキー attributes.department を操作します。このファセットキーに対して、再ランキングを行うコントロールを設定します。

この時点で、検索はキーのランク付けを再調整します。

そのため、以前にエンゲージメントしたファセットキー attributes.age_group がレスポンスで返されない可能性があります。リクエストでこのキーを渡すと（enableDynamicPosition が true に設定された Facetspec を使用）、レスポンスで自動的に返されます。

ただし、検索ではそのキーが 27 番目の位置で返される可能性があり、ユーザーには最初の 20 個のキーのみが表示されることがあります。そのため、クライアント側で以前にやり取りしたこれらのキーがユーザーに表示されることを確認する必要があります。ユーザーにキーを提供しすぎないようにする場合は、エンゲージメントされていない中間キーをいくつか除外しなければならない場合もあります。