これは、Recommendations AI、Retail Search、新しい Retail コンソールに関するドキュメントです。制限付き一般提供フェーズで Retail Search を使用するには、Cloud 営業担当者にお問い合わせください

Recommendations AI のみを使用している場合は、Recommendations コンソールを引き続き使用し、Recommendations AI のドキュメントをご覧ください。

制御機能の作成と管理

このページでは、コントロールを追加、表示、編集、削除する方法について説明します。

  • サービス提供コントロールは、個々の Retail Search サービス提供構成を定義して適用するルールです。
  • サイト全体のコントロールはすべての Retail Search 結果に適用されます。

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

サービス提供コントロールを使用すると、検索結果でのサービス提供構成をカスタマイズするルールを作成できます。

Cloud Console で、ルールをトリガーする条件とそれによって実行されるアクションで構成されるルールベースのサービス提供コントロールを作成できます。その後、作成したすべての Retail Search サービス提供構成に新しいサービス提供コントロールを接続できます。

Retail Search のサービス提供構成には、コントロールとの多対多関係があります。1 つのサービス提供構成に複数のコントロールを追加でき、1 つのコントロールを複数のサービス提供構成に関連付けることができます。

コントロールを作成し、ライブ Retail Search サービス提供構成に追加したり、入れ替えたりできます。

[Controls] ページで、いつでもサービス提供コントロールを作成または変更できます。Retail Search のサービス提供構成を作成すると、Retail Cloud Console でコントロールも作成するよう求められます(省略可)。

最大 1,000 個のサービス提供コントロールを作成できます。

サービス提供コントロールでは次の設定を使用できます。

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

これらコントロールの例については、サービス提供コントロールのルールをご覧ください。

新しいサービス提供コントロールを作成する

Google Cloud Console の [Controls] ページで新しいサービス提供コントロールを追加します。

  1. Google Cloud Console の [Retail Controls] ページに移動します。

    [Controls] ページに移動

  2. [Serving controls] タブで、 [Create control] をクリックします。

  3. 新しいコントロールの名前を入力します。

  4. コントロール ID を入力します。

  5. コントロール タイプを選択します。

    ブースト / 埋め込み

    このコントロール タイプの詳細については、ブースト / 埋め込みコントロールをご覧ください。

    1. (省略可)クエリ用語を入力して(例: running shoes)、ブーストまたは埋め込み、それぞれの用語に対して次のいずれかを選択します。

      • 部分一致: このルールは、クエリ語句に部分一致が含まれている場合に適用されます。
      • 完全一致: このルールは、クエリ語句に完全に一致する語句がクエリに含まれている場合にのみ適用されます。

      これは制御条件です。これらの語句の 1 つがクエリに含まれている場合、ブースト / 埋め込みルールが有効になります。期間を指定した場合、時間範囲の条件も満たしている場合にのみ、このルールが適用されます。

    2. (省略可)[時間範囲を追加] ボタンをクリックして、このルールが適用される期間を 1 つ以上追加します。

      これは制御条件です。クエリ用語を指定した場合、このルールは、これらの用語のいずれかがこの時間範囲内でクエリに使用された場合にのみ適用されます。

    3. [ブースト / 埋め込みサービス] フィールドで、ブーストまたは埋め込みを行う商品属性を指定します。フィルタリングと並べ替えで記載されているフィルタ式の構文を使用してください。

      たとえば、「product1」と「product2」の赤と青のバージョンを指定するには: (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

    4. [ブースト / 埋め込み値] には、スライダーを使用してブーストの強さを設定します。正の値は結果をブーストし、負の値は結果を埋め込みます。

      これは制御アクションで、コントロール条件が満たされた場合にルールが実行する動作を指定します。

    フィルタ

    このコントロール タイプの詳細については、フィルタ オプションをご覧ください。

    1. クエリ語句を入力して(例: running shoes)フィルタリングし、語句ごとに次のいずれかを選択します。

      • 部分一致: このルールは、クエリ語句に部分一致が含まれている場合に適用されます。
      • 完全一致: このルールは、クエリ語句に完全に一致する語句がクエリに含まれている場合にのみ適用されます。

      これは制御条件です。これらの語句の 1 つがクエリに含まれている場合、フィルタルールが有効になります。期間を指定した場合、時間範囲の条件も満たしている場合にのみ、このルールが適用されます。

    2. (省略可)[時間範囲を追加] ボタンをクリックして、このルールが適用される期間を 1 つ以上追加します。

      これは制御条件です。ルールは、指定したいずれかのクエリ用語がクエリ時間中に使用された場合にのみ適用されます。

    3. [フィルタ アクション] フィールドで、ルールがトリガーされたときに適用するフィルタを指定します。

      フィルタリングと並べ替えで記載されているフィルタ式の構文を使用してください。

      たとえば、「product1」と「product2」の赤と青のバージョンをフィルタリングするには: (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

      これは制御アクションで、コントロール条件が満たされた場合にルールが実行する動作を指定します。

    リダイレクト

    このコントロール タイプの詳細については、リダイレクト コントロールをご覧ください。

    1. クエリ語句を入力して(例: running shoes)、リダイレクト ルールをトリガーし、語句ごとに次のいずれかを選択します。

      • 部分一致: このルールは、クエリ語句に部分一致が含まれている場合に適用されます。
      • 完全一致: このルールは、クエリ語句に完全に一致する語句がクエリに含まれている場合にのみ適用されます。

      これは制御条件です。これらの語句の 1 つがクエリに含まれている場合、リダイレクト ルールが有効になります。期間を指定した場合、時間範囲の条件も満たしている場合にのみ、このルールが適用されます。

    2. (省略可)[時間範囲を追加] ボタンをクリックして、このルールが適用される期間を 1 つ以上追加します。

      これは制御条件です。ルールは、指定したいずれかのクエリ用語がクエリ時間中に使用された場合にのみ適用されます。

    3. [リダイレクト URI] フィールドに、ルールがトリガーされたときにリダイレクトするページを指定します。

      これは制御アクションで、コントロール条件が満たされた場合にルールが実行する動作を指定します。

    シノニム

    このコントロール タイプの詳細については、類義語コントロールをご覧ください。

    1. 類義語である 2 つ以上のクエリ用語を入力して(例: running shoes )、用語ごとに次のいずれかを選択します。

      • 部分一致: このルールは、クエリ語句に部分一致が含まれている場合に適用されます。
      • 完全一致: このルールは、クエリ語句に完全に一致する語句がクエリに含まれている場合にのみ適用されます。

      これらの語句のいずれかがクエリに含まれている場合、検索ではその他のクエリ語句は含まれている語句の類義語と見なされます。

      これは制御条件です。これらの語句の 1 つがクエリに含まれている場合、類義語ルールが有効になります。期間を指定した場合、時間範囲の条件も満たしている場合にのみ、このルールが適用されます。(このフィールドで、類義語として指定した他の語句を使用する制御アクションも指定されます)。

    2. (省略可)[時間範囲を追加] ボタンをクリックして、このルールが適用される期間を 1 つ以上追加します。

      これは制御条件です。ルールは、指定したいずれかのクエリ用語がクエリ時間中に使用された場合にのみ適用されます。

    一方向の類義語

    このコントロール タイプの詳細については、一方向の類義語コントロールをご覧ください。

    1. クエリ語句を入力して(例: running shoes)、関連する同義語が含まれていることを確認し、語句ごとに次のいずれかを選択します。

      • 部分一致: このルールは、クエリ語句に部分一致が含まれている場合に適用されます。
      • 完全一致: このルールは、クエリ語句に完全に一致する語句がクエリに含まれている場合にのみ適用されます。

      これは制御条件です。これらの語句のいずれかがクエリに含まれている場合、検索ではその他のクエリ語句は含まれている語句の類義語と見なされ、[関連付けられている用語] セクションで指定します。期間を指定した場合、時間範囲の条件も満たしている場合にのみ、このルールが適用されます。

    2. (省略可)[時間範囲を追加] ボタンをクリックして、このルールが適用される期間を 1 つ以上追加します。

      これは制御条件です。ルールは、指定したいずれかのクエリ用語がクエリ時間中に使用された場合にのみ適用されます。

    3. [関連付けられている用語] セクションで、以前に指定したクエリ用語の類義語として使用する用語を入力します。

      これは制御アクションで、コントロール条件が満たされた場合にルールが実行する動作を指定します。

    関連付けない

    このコントロール タイプの詳細については、非関連付けコントロールをご覧ください。

    1. クエリ語句を入力して(例: running shoes)(他の語句から明確に区別されている)、語句ごとに次のいずれかを選択します。

      • 部分一致: このルールは、クエリ語句に部分一致が含まれている場合に適用されます。
      • 完全一致: このルールは、クエリ語句に完全に一致する語句がクエリに含まれている場合にのみ適用されます。

      これは制御条件です。いずれかの語句がクエリに含まれる場合、このルールにより [関連付けられている用語] フィールドに指定した用語とは関連付けられなくなります。期間を指定した場合、時間範囲の条件も満たしている場合にのみ、このルールが適用されます。

    2. (省略可)[時間範囲を追加] ボタンをクリックして、このルールが適用される期間を 1 つ以上追加します。

      これは制御条件です。ルールは、指定したいずれかのクエリ用語がクエリ時間中に使用された場合にのみ適用されます。

    3. [関連付けられている用語] に、前に指定したクエリ用語と検索結果で関連付けてはならない用語を入力します。

      これは制御アクションで、コントロール条件が満たされた場合にルールが実行する動作を指定します。

    無視する

    このコントロール タイプの詳細については、類義語コントロールをご覧ください。

    1. クエリ語句を入力して(例: running shoes)(検索で使用されないようにする語句)、語句ごとに次のいずれかを選択します。

      • 部分一致: このルールは、クエリ語句に部分一致が含まれている場合に適用されます。
      • 完全一致: このルールは、クエリ語句に完全に一致する語句がクエリに含まれている場合にのみ適用されます。

      これは制御条件です。これらの語句のうちの 1 つがクエリに含まれている場合、ignore ルールを適用できます。(これにより、指定された用語を無視する制御アクションも指定されます)。期間を指定した場合、時間範囲の条件も満たしている場合にのみ、このルールが適用されます。

    2. (省略可)[時間範囲を追加] ボタンをクリックして、このルールが適用される期間を 1 つ以上追加します。

      ルールは、指定したいずれかのクエリ用語がクエリ時間中に使用された場合にのみ適用されます。

    置換

    このコントロール タイプの詳細については、置き換えコントロールをご覧ください。

    1. クエリ語句を入力して(例: running shoes)(置き換える語句)、語句ごとに次のいずれかを選択します。

      • 部分一致: このルールは、クエリ語句に部分一致が含まれている場合に適用されます。
      • 完全一致: このルールは、クエリ語句に完全に一致する語句がクエリに含まれている場合にのみ適用されます。

      これは制御条件です。これらの語句のいずれかがクエリに含まれている場合は、置き換え語句で指定した語句に置き換えられます。期間を指定した場合、時間範囲の条件も満たしている場合にのみ、このルールが適用されます。

    2. (省略可)[時間範囲を追加] ボタンをクリックして、このルールが適用される期間を 1 つ以上追加します。

      これは制御条件です。ルールは、指定したいずれかのクエリ用語がクエリ時間中に使用された場合にのみ適用されます。

    3. [置換条件] で、前に指定したクエリ用語を置き換える用語を入力します。

      これは制御アクションで、コントロール条件が満たされた場合にルールが実行する動作を指定します。

  6. コントロールを適用するサービス提供構成を選択します。

  7. コントロール設定を送信します。

    新規作成または更新されたコントロールがライブ トラフィックを提供できるようになるまでに、数分かかります。変更はすぐに [Evaluate] ページでテストできます。

新しいコントロールは、[Controls] ページの [Serving controls] タブに表示されます。

サービス提供コントロールを表示または編集する

[Control] ページの [Serving controls] タブには、すべてのサービス提供コントロールとそれに関連するサービス提供構成が一覧表示されます。[Edit] をクリックして、追加のサービス提供構成に適用するかどうかを含めて、コントロールの設定を変更します。

また、各サービス提供構成のコントロールは、[サービス提供構成] ページでも表示、編集できます。サービス提供構成をクリックすると、[詳細] ページが表示され、その構成のすべてのサービス提供とサイト全体のコントロールが一覧表示されます。

新規作成または更新されたコントロールがライブ トラフィックを提供できるようになるまでに、数分かかります。変更はすぐに [Evaluate] ページでテストできます。

サービス提供コントロールを削除する

サーバー コントロールを削除して、そのルールを使用しているすべてのサービス提供構成からルールを削除します。

  1. Google Cloud Console の [Retail Controls] ページに移動します。

    [Controls] ページに移動

  2. 表の削除するコントロールの行で、 [Delete] をクリックします。

  3. 確認ウィンドウで、[Delete] をクリックして削除を完了します。

サイト全体のコントロール

サイト全体のコントロールを使用すると、すべてのサービス提供構成にまたがって設定をグローバルに管理できます。

属性コントロール

サイト全体の属性コントロールは、Cloud Console でカタログの商品属性に使用できます。

サイト全体の属性コントロール機能は次のとおりです。

  • Indexable: この属性を使用すると、Retail Search でフィルタを使用してファセットをフィルタリングできます。
  • 動的ファセット: Retail Search では、ユーザーの過去の操作(ファセットのクリックや表示など)に基づいて、この属性が動的ファセットとして自動的に使用されます。属性の動的ファセットを有効にするには、その属性の Indexable を true に設定する必要があります。
  • 検索可能: この属性は Retail Search クエリで検索できます。これによって、この属性の再現率が向上します。このコントロールは、テキスト属性にのみ適用されます。

個々の属性に対してサイト全体の属性コントロールを有効または無効にできます。

動的ファセットは、サイト全体の属性コントロールとして使用できます。デフォルトでは、動的ファセットはすべてのカスタム属性に対して有効になっています。

カタログレベルの構成モードでは、サイト全体の属性コントロールを Indexable と検索可能で使用できます。

事前定義されたシステム属性(ブランド、色、サイズなど)は常に Indexable です。テキスト システム属性は常に検索可能です。カスタム属性(Product.attributes[] を使用して定義された属性)について、Indexable と検索可能を切り替えることができます。デフォルトではカスタム属性について false に設定されます。

Product API メソッドのみを使用して、商品ごとに一部の属性構成を設定することもできます。

属性構成と使用可能な場合の詳細については、属性構成をご覧ください。

サイト全体の属性コントロールを設定する

Google Cloud Console の [Controls] ページでサイト全体のコントロールを設定します。

属性コントロールのグローバルでの設定は、デフォルトのカタログレベルの構成モードで使用できます。以前は、商品レベルの構成がデフォルトのモードでした。まだ商品レベルの構成モードで、モードの切り替えが必要な場合は、Retail サポートにお問い合わせください。

  1. Google Cloud Console の [Retail Controls] ページに移動します。

    [Controls] ページに移動

  2. [Site-wide controls] タブに移動します。

    このタブには、サイト全体のコントロールを設定できるすべての商品属性の表が表示されます。

  3. [Control Controls] をクリックします。

  4. コントロールを有効または無効にします。

    • True: その属性のコントロールを有効にします。これは、Retail API の商品レベルの属性構成をオーバーライドします。
    • False: その属性のコントロールを無効にします。これは、Retail API 内の商品レベルの属性構成より優先されます。

      動的ファセットを true に設定できるのは、インデックス可能に設定されている属性のみです。

  5. [コントロールを保存] をクリックします。

    Indexable と検索可能についての属性構成の設定の変更は、12 時間以内、または次回のカタログ取り込み直後に有効になります。動的ファセット構成の変更は最大 2 日かかります。変更はすぐに [Evaluate] ページでテストできます。