これは、Recommendations AI、Retail Search、新しい Retail コンソールに関するドキュメントです。

サービス提供コントロール

サービス制御をサービス構成に適用して、Retail Search が検索クエリを扱い、結果を返す方法をカスタマイズできます。サービス制御は、条件とアクションのペアで構成されるルールです。条件は、サービス コントロールがいつ実行されるかを示します。アクションは、サービス制御が動作する動作を指定します。

サービス制御は、Cloud Console または API Control.create メソッドを使用して作成できます。

その後、作成したすべての Retail Search サービス提供構成に新しいサービス管理をアタッチできます。 リクエストの時点で、アクティブなサービス構成の制御のみが考慮されます。

Cloud Console でサービス制御を作成する方法の詳細については、制御機能の作成と管理をご覧ください。

次のサービス管理を使用できます。

  • ブースト / 埋め込み: 返される結果リスト内の検索結果のランキングと順序に影響します。
  • フィルタ: 返される結果リストからフィルタを通過しない結果を削除します。
  • リダイレクト: 検索クエリに応じてユーザーを特定のページにリダイレクトします。
  • 言語: 検索クエリの言語をカスタマイズします。言語制御には、いくつかのタイプがあります。
    • 類義語: 検索クエリの類義語と考えられるものを拡張します。
    • 一方向の類義語: 特定のキーワードの類義語と考えられるものを一方向に拡張します。
    • 無視: 検索に特定のキーワードが使用されないようにします。
    • 非関連付け: 特定のキーワードが表示されたときにキーワードが検索に使用されないようにします。
    • 置換: 検索クエリのキーワードを置き換えます。

制御条件

制御条件は、サービス制御がいつ実行されるかを規定します。

制御条件フィールドには、クエリ キーワード、期間、またはその両方にすることができます。制御のタイプに応じて、複数の条件フィールドを指定できます。

使用可能な条件フィールド:

  • クエリ キーワード: 検索クエリにキーワードが表示されたときにトリガーされます。
    • 完全一致では、検索クエリ全体がクエリ キーワードに一致する必要があります。
    • 複数のクエリ キーワードを指定できます。検索クエリにいずれかのクエリ キーワードが表示されている限りトリガーされます。
  • 有効期間: 検索クエリの日付が期間内にあるときにトリガーされます。
    • 複数の期間を指定できます。クエリの日付が(包括的な)期間内である限りトリガーされます。

指定する条件フィールドで、制御が適用されるかどうかを決定します。

  • 複数の条件フィールドは AND を使用して結合されます。つまり、期間とクエリ キーワードの両方を指定した場合は、制御を適用するには、両方の条件フィールドがトリガーされる必要があります。
  • 複数条件サブフィールドは OR を使用して結合されます。つまり、複数のクエリ キーワードがある場合は、いずれかのクエリ キーワードが一致するとクエリ キーワードがトリガーされます。複数の期間がある場合は、いずれかの期間が一致すると期間がトリガーされます。
  • 指定された条件フィールドがないとは、制御は常に適用されるということです。ただし、一部の制御ではフィールドを定義する必要があります。

条件の設定の詳細については、Controls.condition API リファレンスをご覧ください。

制御アクション

制御アクションは、検索中に条件が満たされた場合にサービス制御が有効にするアクションを指定します。

指定できるアクションの種類は、作成するサービス制御のタイプによって異なります。たとえば、ブースト / 埋め込みのアクションはブースト / 埋め込み値を指定したフィルタ済み商品に適用し、一方向の類義語制御のアクションは指定した関連用語に適用します。

ブースト/ベリー制御

ブースト/ベリー制御を使用すると、特定の検索結果のランキングを上げたり下げたりして表示できます。

ブースト / 埋め込み制御を作成する場合は、フィルタ式を使用して Product フィールドに基づいて条件を指定できます。フィルタ式の構文については、結果のフィルタリングと並べ替えをご覧ください。次に、-1.0 ~ 1.0 の範囲の boost 値を適用して、これらの条件と一致する商品の増加をブーストまたは埋め込むことができます。正の値は結果をブーストし、負の値はこれらを埋め込みます。

ブーストの強さを高く設定すると、アイテムに大幅な昇格が適用されますが、ブーストされたアイテムが常に上位の結果になるとは限りません。検索クエリに著しく関連している結果は、重要性が高いが関連していないアイテムよりも依然として優先されます。同様に、ブーストの強度を -1.0 に設定すると、アイテムに大幅な降格が適用されますが、深く関連している結果が引き続き表示されることがあります。

制御条件として、クエリ キーワードと該当する期間を設定できます。制御アクションとして、ブーストまたは埋め込む商品のフィルタを指定し、ブースト / 埋め込み値を設定します。

ブースト/ベリーを使用する例として、より安価な商品を優先し、高価な商品の優先順位を低くできます。

Cloud Console でブースト/ベリー制御を作成するには、新しいサービス管理の作成をご覧ください。

ブースト / 埋め込み制御設定の詳細については、Controls.BoostAction API リファレンスをご覧ください。

フィルタ制御

フィルタ オプションを使用すると、特定の検索リクエストに基づいて、事前に定義されたフィルタを動的に追加できます。

Product フィールドに基づいてフィルタ式を使用できます。フィルタ式の構文については、結果のフィルタリングと並べ替えをご覧ください。

制御条件として、クエリ キーワードと該当する期間を設定できます。制御アクションとして、クエリ時に適用するフィルタを指定します。

たとえば、「青い靴」というクエリの場合、フィルタ制御を使用して、検索結果を青の色で自動的にフィルタできます。フィルタ制御を使用して、特定の結果を買い物客に返さないようにすることもできます。

Cloud Console でフィルタ オプションを作成するには、新しいサービス管理の作成をご覧ください。

フィルタ制御設定の詳細については、Controls.FilterAction API リファレンスをご覧ください。

リダイレクト制御

リダイレクト制御を使用すると、検索結果を表示するだけではなく、買い物客の意図に基づいて異なるページに買い物客をリダイレクトできます。

制御条件として、クエリ キーワードと該当する期間を設定できます。制御アクションとして、条件が一致した場合にリダイレクトするリダイレクト URI を指定します。

たとえば、「gShoe」という商品のプロモーション中に、「ランニング シューズ」または「スポーツ」シューズを含むクエリが gShoe の商品ページにリダイレクトされるようにリダイレクト制御を作成できます。

Cloud Console でリダイレクト制御を作成するには、新しいサービス管理の作成をご覧ください。

リダイレクト制御設定の詳細については、Controls.RedirectAction API リファレンスをご覧ください。

言語制御

デフォルトでの語句の処理方法に追加やオーバーライドが作成できます。

たとえば、小売業の場合、「ランニング シューズ」というキーワードを含むクエリを拡張して「スポーツ シューズ」を含むようにすると、検索結果に両方のキーワードが含まれるようになります。言語制御を使用すると、言語の類義語制御を作成して、条件に検索キーワードとして「ランニング シューズ」を入力し、アクションとしてその検索に「スポーツ シューズ」という類義語を含めることができます。サイトの買い物客がクエリとして「ランニング シューズ」を入力する場合は、Retail Search が作成した言語制御との一致を見つけると、買い物客に検索結果を返す際に「スポーツ シューズ」が含まれるように検索を拡張します。

双方向の類義語制御

双方向の類義語制御を使用して複数のキーワードを一緒に結びつけ、Retail Search が検索中にそれらを同じものとして扱うようにします。

制御条件として、クエリ キーワードと該当する期間を設定できます。 別途制御アクションを設定する必要はありません。指定したキーワードがクエリとして使用される場合は、制御アクションは類義語として指定した他のキーワードを使用します。

たとえば、キーワードの「ディッシュ タオル」と「キッチン タオル」を類義語として関連付ける双方向類義語制御を設定できます。サイトの買い物客がクエリに「キッチン タオル」と入力すると、Retail Search では、それからクエリを拡張して「ディッシュ タオル」の結果を含むようにできます。逆も同様です。

Cloud Console で類義語制御を作成するには、新しいサービス管理を作成するをご覧ください。

双方向の類義語制御設定の詳細については、Controls.TwowaySynonymsAction API リファレンスをご覧ください。

一方向の類義語制御

一方向の類義語制御では、キーワードを一緒に一方向に結びつげます。

制御条件として、クエリ キーワードと該当する期間を設定できます。制御アクションとして、一方向の類義語として使用するキーワードを指定します。

たとえば、「バラ」というキーワードの検索を拡張して「ピンク」というキーワードを含める、一方向の類義語制御を設定できます。これは一方向の類義語であるため、「ピンク」というキーワードの検索は「バラ」というキーワードを含むように拡張されません。

Cloud Console で一方向の類義語制御を作成するには、新しいサービス管理を作成するをご覧ください。

一方向の類義語制御設定の詳細については、Controls.OnewaySynonymsAction API リファレンスをご覧ください。

無視制御

無視制御により、Retail Search が検索中に特定のクエリ キーワードを使用することを防ぐことができます。

無視制御は、Retail Search が結果を何も提供しないことを保証しません。このことの発生を完全に防ぐには、フィルタ制御を使用します。

制御条件として、クエリ キーワードと該当する期間を設定できます。 別途制御アクションを設定する必要はありません。指定したキーワードがクエリとして使用された場合、制御アクションはそのキーワードを無視します。

たとえば、不適切な語句を使用するクエリ キーワードを無視する制御を作成できます。

Cloud Console で無視制御を作成するには、新しいサービス管理を作成するをご覧ください。

無視制御設定の詳細については、Controls.IgnoreAction API リファレンスをご覧ください。

非関連付け制御

非関連付け制御を使用すると、指定した他のキーワードの検索中に、クエリ キーワードが一緒にクエリされないようにできます。

制御条件として、クエリ キーワードと該当する期間を設定できます。制御アクションとして、クエリ キーワードに関連付けてはならないキーワードを指定します。

たとえば、ブランド名(「gShoe」など)がクエリで「cheap」と「oor quality」の用語に分類されないようにする制御を作成し、買い物客が「poor quality cheap gShoe」の場合、Retail Search は「gShoe」のみを検索します。

検索キーワードの関連する結果に、「非関連付け」と指定されたキーワードも含まれている場合は、その関連する結果が依然として返されることがあります。このことの発生を完全に防ぐには、フィルタ制御を使用します。

Cloud Console で非関連付け制御を作成するには、新しいサービス管理を作成するをご覧ください。

非関連付け制御設定の詳細については、Controls.DoNotAssociateAction API リファレンスをご覧ください。

置換制御

置換制御は、1 つ以上の所与のクエリ キーワードを指定した別のキーワードに置き換えます。単一のキーワードにマッピングできる複数のキーワードを指定できます(ただし、その逆はできません)。

制御条件として、クエリ キーワードと該当する期間を設定できます。制御アクションとして、代わりに使用すべきキーワードを指定します。

たとえば、ブランドのニックネームを、商品の説明で一般的に使用される完全なブランド名に置き換える制御を作成できます。

Cloud Console で無視制御を作成するには、新しいサービス管理を作成するをご覧ください。

置換制御設定の詳細については、Controls.ReplacementAction API リファレンスをご覧ください。