「Retail」は「小売業向け Vertex AI Search」に名称変更されます。現在、新しいブランディングを反映するようにコンテンツの更新を進めています。

このページは Cloud Translation API によって翻訳されました。

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

このページでは、サービス提供コントロールの作成方法について説明します。

サービス提供コントロールは、個々のサービス構成を定義して適用するルールです。

サービス提供コントロールは、コントロールをトリガーする条件と、条件によってトリガーされるときに発生するアクションで構成される、コマース向け検索コンソールで作成できます。その後、新しいサービス提供コントロールをサービス構成に関連付けることができます。

サービングコントロールと構成の関係

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

サービス提供コントロールとサービス構成を作成するときに、そのコントロールを使用できるプロダクト（レコメンデーションまたは検索）を選択します。

サービス提供コントロールを関連付けできるのは、同じプロダクトタイプのサービス構成のみです。たとえば、レコメンデーション用に作成されたサービス提供コントロールを、Retail Search 用に作成されたサービス構成に関連付けることはできません。

サービス構成は、検索リクエストまたは予測リクエスト時に適用されるコントロールを管理します。リクエストの有効なサービス構成のコントロールだけが、サービス提供時に考慮されます。たとえば、2 つのコントロールを作成したとします。1 つは「gShoe セール」というコントロールで、靴が検索されたときにブランド gShoe の検索結果をブーストします。もう 1 つは「靴の詳細」というコントロールで、ランニングシューズというキーワードを含むクエリを拡張して「スポーツシューズ」を含めます。サービング構成に gShoe セール コントロールのみを適用した場合、そのサービング構成を使用する検索リクエストでは、靴というキーワードを含むクエリに対して gShoe の結果が優先されますが、靴の検索結果を表示コントロールは、使用しているサービング構成に適用されていないため、効果がありません。

詳細については、サービス構成についてをご覧ください。

クイックスタート動画とガイド

サービス提供コントロールの概要: サービス提供コントロールを使用すると、サービス提供構成が検索結果を返す方法をカスタマイズするルールを作成できます。
ブースト / 埋め込み: 返される結果リスト内の検索結果のランキングと順序に影響します。 Retail Search とレコメンデーションで使用できます。
フィルタ: 返された結果リストからフィルタを通過しない結果を削除します。Retail Search でのみ利用できます。
リダイレクト: 検索クエリに応じてユーザーを特定のページにリダイレクトします。Retail Search でのみ利用できます。

このチュートリアルでは、リダイレクト制御の使用方法について説明します。

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

ガイドを表示

言語学: 検索クエリの言語学をカスタマイズします。検索でのみ使用できます。

数種類の言語制御を使用できます。
- 類義語: 検索クエリの類義語と考えられるものを拡張します。
- 一方向の類義語: 特定のキーワードの類義語と考えられるものを一方向に拡張します。
- 関連付けない: 特定のキーワードが表示されたときに、あるキーワードグループが検索で使用されないようにします。
- 無視: 検索に特定のキーワードが使用されないようにします。
- 置換: 検索クエリのキーワードを置き換えます。
固定: 検索結果の並べ替えに影響し、検索結果を特定の位置（4 番目など）に配置します。検索とブラウジングで使用できます。

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

サービス提供コントロールの構成オプション

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

最大 100 個のサービス提供コントロールを作成できます。さらにサービス提供コントロールが必要な場合は、追加の割り当てをリクエストしてください。追加の割り当てをリクエストする方法については、割り当てを増やすをご覧ください。サービス提供構成には、リダイレクトコントロール以外の最大 100 個のサービス提供コントロールを含めることができます。サービス提供構成ごとの上限は 1,000 個です。

サービス提供コントロールは次の方法で作成できます。

Google Cloud コンソールの [コントロール] ページ: ここでは、必要に応じてサービス構成の作成プロセス中にコントロールを作成できます。
商品コンソールを使用できます。
サービス提供コントロールは、Controls.create メソッドを使用してインラインで作成できます。

Google Cloud コンソールを使用する

Google Cloud コンソールを使用してサービス提供コントロールを作成するには:

検索広告コンソールの [コントロール] ページに移動します。

[コントロール] ページに移動
Google Cloud コンソールの各サービングコントロールセクションの手順に沿って操作します。

商品コンソールを使用する

マーチャンダイジングコンソールは、マーチャンダイザーがコントロールを作成、管理するために設計されたツールです。承認フローが用意されているため、すべてのコントロールをすべてのマーチャンダイザーが提案し、マーチャンダイザーの承認担当者が審査できます。

マーチャンダイジングコンソールを使用すると、固定、ブースト/非表示、類義語、ファセットなどのサービス提供コントロールを作成できます。マーチャンダイジングコンソールには、マーチャンダイザーがコントロールを効率的に作成、管理できる使いやすいインターフェースが備わっています。このツールは承認プロセスも容易にし、すべてのマーチャンダイザーが管理機能を提案し、マーチャンダイザーの承認者がそれらを確認できるようにします。

Google Cloudで [商品コンソール] タブにアクセスするには、少なくとも次の権限が必要です。

プロジェクト閲覧者（閲覧者）: プロジェクトにアクセスできます。
Retail 編集者: マーチャンダイジングコンソールの設定を編集して保存します。

管理者としてコンソールを使用する

開始する前に、 Google Cloud ユーザーをマーチャンダイジングコンソールにオンボーディングする管理者である必要があります。

次に、 Google Cloud コンソールの [Merchanising Console] タブにアクセスして、Merchanising Console を初期化します。

マーチャンダイジングコンソールのユーザーに クリエイターまたは承認者のロールへのアクセス、編集、割り当てを行うには、次の IAM ロールが必要です。

マーチャンダイジングコンソールを編集するには、少なくともRetail 編集者のロールが必要です。
ユーザーに作成者または承認者のロールを割り当てるには、プロジェクトレベルの IAM 管理者のロールが必要です。

IAM プロジェクトレベルと Vertex AI Search for Commerce の権限の詳細については、この [Vertex AI Search for Commerce プロダクト](/retail/docs/iam) ドキュメントの [事前定義された管理者ロール](/retail/docs/iam#roles) セクションをご覧ください。

マーチャンダイジングコンソールのユーザーをオンボーディングする

Google Cloud コンソール管理者は、サイトマーチャンダイザーにマーチャンダイジングコンソールへのアクセス権を付与し、作成者または承認者のロールを割り当てることができます。

検索広告コンソールの [コントロール] ページに移動します。

[コントロール] ページに移動
[Merchandising console] タブに移動します。
現在のプロジェクトに関連付けられている Merchandising コンソールの一意の URL が表示されます。 Google Cloud リンクをコピーするか、 Google Cloud コンソールで直接開きます。
マーチャンダイザーが承認済みのコントロールのプレビューとアタッチに使用するデフォルトのサービス提供構成を選択します。
ユーザーに [承認者] ロールまたは [作成者] ロールを付与します。
現在のプロジェクトに関連付けられている Merchandising Console への固有の URL が表示されます。 Google Cloud リンクをコピーするか、 Google Cloud コンソールで直接開きます。
商品構成コンソールで、[プレビュー] のデフォルトのサービス提供構成を選択します。
（省略可）次の関数を使用して、マーチャンダイジングコンソールへのアクセス権を編集します。

ユーザーを追加する: 承認者またはクリエイターとして 商品化コンソールへのアクセス権をユーザーに付与します。
ユーザーを削除する: 承認者またはクリエイターを削除して、マーチャンダイジングコンソールへのアクセス権を取り消します。

承認者のメールアドレスを追加します。マーチャンダイザーが送信したコントロールごとに、承認者のメールリストに、このコントロールを確認して承認するためのメールが届きます。

ユーザーとしてコンソールにアクセスする

URL でアクセス権が付与されている場合は、標準の Google Cloud コンソールではなく、商品コンソールを使用できます。マーチャンダイジングコンソールを使用してコントロールを作成するには:

管理者から提供された認証情報を使用してログインします。
マーチャンダイジングコンソールのドキュメントの各配信制御セクションの手順に沿って操作します。
送信すると、件名が「[Merchant Console] Proposed control awaiting review」の通知メールが届きます。
承認者は、管理リクエストを承認、拒否、変更できます。

サイトマーチャンダイザーとしてコンソールを使用する

サイトマーチャンダイザーとして商品構成コンソールで作業を開始する手順は次のとおりです。

質問の承認フローを設定する。

メインメニューの [設定] に移動します。
デフォルトでは、[目標を定める] 画面に事前定義された質問のリストが設定されています。

[質問を追加] をクリックして質問を追加し、承認者が新しい管理の目的を理解できるようにします。
[Save] をクリックして質問を保存します。

コントロールを作成する。

[管理] セクションに移動します。
[コントロールを作成] をクリックします。
目標を定義する: 前述の質問にすべて回答する必要があります。まだ質問を定義していない場合、この画面は表示されません。
コントロールを選択します。コントロールタイプを指定し、コントロールに名前を割り当てます。
ルールを設定する: ルールごとにトリガーとアクションを定義できます。
トリガーを定義する: このコントロールを適用するタイミングを設定します。

クエリキーワード: このルールは、検索クエリに特定のキーワードが含まれている場合、または特定のキーワードと完全に一致する場合にトリガーされます。これらのクエリキーワードを定義できます。
適用される期間: 時間制限を適用して、このルールの有効化を特定の期間に限定できます。

アクションを定義する: コントロールのタイプに応じて、アイテム ID や固定コントロールの位置などのアクションを定義できます。
ルールをプレビューする: ルールのダイナミックプレビューが画面に表示されます。
ルールを送信する: [送信] をクリックして販売者が設定したルールを送信すると、コントロールリストにコントロールが [保留中] として表示されます。

コントロールを承認する

コントロールの承認を付与するには、コントロールリストでコントロールの横にある [その他] アイコンをクリックします。[確認] を選択します。
特定のコントロールの画面が表示され、[承認]、[拒否]、[編集して承認] のいずれかを選択できます。
承認されると、コントロールのリストページにリダイレクトされ、コントロールが [承認済み] と表示されます。

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

コントロールの種類

コントロールの要件は、タイプによって異なります。作成するコントロールタイプの作成手順に進みます。

ブースト / 埋め込みコントロールを作成する
フィルタオプションを作成する
リダイレクトコントロールを作成する
固定コントロールを作成する
双方向の類義語コントロールを作成する
一方向の類義語コントロールを作成する
「関連付けなし」のコントロールを作成する
取り消しコントロールを作成する
代替コントロールを作成する

ブースト / 埋め込みコントロールを作成する

このコントロールタイプは、Retail Search とレコメンデーションで利用できます。

検索のブースト/埋め込みコントロールを作成する
レコメンデーションのブースト / 埋め込みコントロールを作成する

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

検索のブースト/埋め込みコントロールを作成する

Retail Search のブースト / 埋め込みコントロールを作成するには:

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

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

商品コンソールの [コントロール] ページが表示されます。
[コントロールを作成] をクリックします。
エンドユーザーの目標と必要なタイミングを定義します。すべての質問に回答する必要があります。[次へ] をクリックします。
コントロールを選択します。コントロールの名前を入力し、検索プロダクトを選択して、コントロールタイプ [ブースト/埋め込み] を選択します。
ブースト/ベリー コントロールを設定します。
1. [トリガー] で、関連する検索クエリに条件（「contains」や「not in range」など）を指定して、このコントロールをトリガーするカタログ属性を定義します。カタログ属性が構成されていない場合、このコントロールは常に適用されます。
2. [期間] に入力して、適用期間を定義します。指定した期間のいずれかが満たされると、指定した期間のいずれかでカタログ属性がクエリと照合されます。[期間を追加] を使用して期間を追加します。
3. このコントロールでトリガーするブースト/埋め込みアクションを定義します。これらのアクションは、カタログ属性（colors など）、条件（contains など）、値（red など）で定義されます。
4. [属性を追加] をクリックして、属性を追加します。
スライダーを使用して [ブースト/埋め込み値] を設定します。負の数値は「埋もれ」、正の数値は「ブースト」です。
[送信] をクリックして、管理リクエストを承認者に送信します。送信されたリクエストのステータスは、販売管理コンソールで確認できます。管理リクエストは、後で削除することもできます。

承認者の手順

[サービス構成] で、既存のサービス構成にコントロールを割り当てます。
ブースト/埋め込みコントロールのリクエストを承認します。

Cloud コンソール

検索広告コンソールの [コントロール] ページに移動します。

[コントロール] ページに移動
[サービス提供コントロール] タブで、 [コントロールを作成] をクリックします。

[コントロールを作成する] ペインが開きます。
[設定] セクションの [コントロール名] フィールドに、新しいコントロールの名前を入力します。
省略可: 自動的に作成されたコントロール ID を変更するには、[編集] をクリックして新しいコントロール ID を入力します。
[プロダクトの選択] セクションで、[検索] を選択します。
コントロールタイプとして [ブースト/埋め込みコントロール] を選択します。[続行] をクリックします。
[トリガー] セクションで、このコントロールをトリガーするユーザーの行動のタイプを選択します。
- カテゴリを閲覧する: ユーザーがサイトのカテゴリを閲覧したときにルールがトリガーされます（search.request.query は空です）。
- 検索: ユーザーがサイトで検索したときにルールがトリガーされます（search.request.query は空ではありません）。カテゴリが閲覧されたとき、またはクエリが検索されたときに、このコントロールを設定してトリガーするには、次の手順をスキップします。
省略可: 特定のカテゴリが閲覧されたか、特定のクエリが検索されたかに応じて、このコントロールをトリガーできる特定のカテゴリまたはクエリを設定します。
- [カテゴリを閲覧] を選択した場合: [カテゴリ] フィールドに、閲覧時にこのコントロールをトリガーするカテゴリを入力します。
- [検索] を選択した場合: [クエリを追加] ボタンをクリックして、フィルタするクエリ用語（running shoes など）を追加します。キーワードごとに、[部分一致] または [完全一致] を選択します。
注: 時間範囲条件に加えてカテゴリまたはクエリの利用条件を指定すると、両方の条件が満たされた場合にのみコントロールが適用されます。
省略可: [時間範囲を追加] ボタンをクリックして、このコントロールを適用する時間範囲を 1 つ以上追加します。

注: このタイプの条件に加えて、時間範囲の条件を指定すると、両方の条件が満たされた場合にのみコントロールが適用されます。
[続行] をクリックして [アクション] セクションに進みます。
[ブースト / 埋め込み商品] フィールドに商品属性のフィルタを追加します。

フィルタリングと並べ替えで記載されているフィルタ式の構文を使用してください。たとえば、「product1」と「product2」の赤と青のバージョンを指定するには: (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))
[ブースト / 埋め込み値] には、スライダーを使用してブーストの強さを設定します。正の値は結果をブーストし、負の値は結果を埋め込みます。[続行] をクリックします。
[サービス提供構成] セクションで、コントロールを適用するサービス提供構成を選択します。
コントロール設定を送信します。

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

新しいコントロールは、[コントロール] ページの [サービス提供コントロール] タブに表示されます。

curl

リクエスト本文に含まれる Control のコントロール ID とインスタンスを使用して、Control.create リクエストを行います。

フィールドの詳細については、Controls API リファレンスと Controls.create API リファレンスをご覧ください。

ユーザーがサイトのカテゴリを閲覧した場合（search.request.query が空）、またはユーザーがサイトを検索した場合（search.request.query が空でない）、ブースト / 埋め込みコントロールをトリガーできます。

次の例は、閲覧でトリガーされるコントロールのフィールドを示しています。ここで、searchSolutionUseCase は SEARCH_SOLUTION_USE_CASE_BROWSE に設定されています。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

次の例は、検索でトリガーされるコントロールのフィールドを示しています（searchSolutionUseCase は SEARCH_SOLUTION_USE_CASE_SEARCH に設定されています）。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

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

サービス構成にコントロールを追加するには、ServingConfig.addControl メソッドを使用します。

このメソッドの詳細については、ServingConfig.addControl API リファレンスをご覧ください。
このメソッドの例については、サービス構成を管理をご覧ください。

レコメンデーションのブースト/埋め込みコントロールを作成する

レコメンデーションのブースト/埋め込みコントロールを作成するには:

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

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

商品コンソールの [コントロール] ページが表示されます。
[コントロールを作成] をクリックします。
エンドユーザーの目標と必要なタイミングを定義します。すべての質問に回答する必要があります。[次へ] をクリックします。
コントロールを選択します。コントロールの名前を入力し、[Browse] プロダクトを選択して、コントロールタイプ [Boost/Bury] を選択します。
ブースト/ベリー コントロールを設定します。
1. [トリガー] で、コントロールをトリガーするページのカテゴリを入力します。カタログ属性が構成されていない場合、このコントロールは常に有効です。
2. [期間] に入力して、適用期間を定義します。指定した期間のいずれかが満たされると、指定した期間のいずれかでカタログ属性がクエリと照合されます。[期間を追加] を使用して期間を追加します。
3. このコントロールでトリガーするブースト/埋め込みアクションを定義します。これらのアクションは、カタログ属性（colors など）、条件（contains など）、値（red など）で定義されます。
4. [属性を追加] をクリックして、属性を追加します。
スライダーを使用して [ブースト/埋め込み値] を設定します。負の数値は埋める、正の数値はブーストします。
[送信] をクリックして、管理リクエストを承認者に送信します。送信されたリクエストのステータスは、販売管理コンソールで確認できます。管理リクエストは、後で削除することもできます。

承認者の手順

[サービス構成] で、既存のサービス構成にコントロールを割り当てます。
ブースト/埋め込みコントロールのリクエストを承認します。

Cloud コンソール

検索広告コンソールの [コントロール] ページに移動します。

[コントロール] ページに移動
[Serving controls] タブで、 [Create control] をクリックします。

[コントロールを作成する] ペインが開きます。
[設定] セクションの [コントロール名] フィールドに、新しいコントロールの名前を入力します。
省略可: 自動的に作成されたコントロール ID を変更するには、[編集] をクリックして新しいコントロール ID を入力します。
[プロダクトの選択] セクションで、[レコメンデーション] を選択します。
コントロールタイプとして [ブースト / 埋め込みコントロール] を選択します。
[続行] をクリックして [アクション] セクションに進みます。
[ブースト / 埋め込み商品] フィールドに商品属性のフィルタを追加します。

レコメンデーションのフィルタのドキュメントに記載されているフィルタ式の構文を使用します。

たとえば、「product1」と「product2」の赤と青のバージョンを指定するには: (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))
[ブースト / 埋め込み値] には、スライダーを使用してブーストの強さを設定します。正の値は結果をブーストし、負の値は結果を埋め込みます。
[続行] をクリックして [サービス提供構成] セクションに進みます。
コントロールを適用するサービス構成を選択します。
コントロール設定を送信します。

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

新しいコントロールは、[コントロール] ページの [サービス提供コントロール] タブに表示されます。

curl

リクエスト本文に含まれる Control のコントロール ID とインスタンスを使用して、Control.create リクエストを行います。

フィールドの詳細については、Controls API リファレンスと Controls.create API リファレンスをご覧ください。

フィルタ式を作成するには、レコメンデーションのフィルタに記載されているフィルタ式の構文を使用します。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ],
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

サービス構成にコントロールを追加するには、ServingConfig.addControl メソッドを使用します。

このメソッドの詳細については、ServingConfig.addControl API リファレンスをご覧ください。
このメソッドの例については、サービス構成を管理をご覧ください。

フィルタオプションを作成する

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

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

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

商品コンソールの [コントロール] ページが表示されます。
[コントロールを作成] をクリックします。
エンドユーザーの目標と必要なタイミングを定義します。すべての質問に回答する必要があります。[次へ] をクリックします。
コントロールを選択します。コントロールの名前を入力し、[検索] または [閲覧] プロダクトを選択し、コントロールタイプ [フィルタ] を選択します。
[フィルタ] コントロールを設定します。
1. [トリガー] で、関連する検索クエリまたはページカテゴリに条件（「次を含む」や「範囲外」など）を指定して、このコントロールをトリガーするカタログ属性を定義します。カタログ属性が構成されていない場合、このコントロールは常に適用されます。
2. [期間] に入力して、適用期間を定義します。指定した期間のいずれかが満たされると、指定した期間のいずれかでカタログ属性がクエリと照合されます。[期間を追加] を使用して期間を追加します。
3. このコントロールでトリガーするフィルタアクションを定義します。これらのアクションは、カタログ属性（colors など）、条件（contains など）、値（red など）で定義されます。
4. [属性を追加] をクリックして、属性を追加します。
[送信] をクリックして、管理リクエストを承認者に送信します。送信されたリクエストのステータスは、販売管理コンソールで確認できます。管理リクエストは、後で削除することもできます。

承認者の手順

[サービス構成] で、既存のサービス構成にコントロールを割り当てます。
フィルタ コントロールのリクエストを承認します。

Cloud コンソール

検索広告コンソールの [コントロール] ページに移動します。

[コントロール] ページに移動
[Serving controls] タブで、 [Create control] をクリックします。

[コントロールを作成する] ペインが開きます。
[設定] セクションの [コントロール名] フィールドに、新しいコントロールの名前を入力します。
省略可: 自動的に作成されたコントロール ID を変更するには、[編集] をクリックして新しいコントロール ID を入力します。
コントロールタイプとして [フィルタオプション] を選択します。
[続行]をクリックして [トリガー] セクションに進みます。
このコントロールをトリガーするユーザーの行動のタイプを選択します。
- カテゴリを閲覧する: ユーザーがサイトのカテゴリを閲覧したときにルールがトリガーされます（search.request.query は空です）。
- 検索: ユーザーがサイトで検索したときにルールがトリガーされます（search.request.query は空ではありません）。
省略可: 閲覧されるカテゴリまたは検索されるクエリに基づいてルールをトリガーするコントロール条件を設定します。使用可能なオプションは、[カテゴリを閲覧] か [検索] のどちらを選択するかによって異なります。
- [カテゴリを閲覧] を選択した場合: [カテゴリ] フィールドに、閲覧時にこのコントロールをトリガーするカテゴリを入力します。
- [検索] を選択した場合: [クエリを追加] ボタンをクリックし、フィルタするクエリ用語（running shoes など）を追加して、次の各用語のいずれかを選択します。
  - 部分一致: このコントロールは、クエリ語句に部分一致が含まれている場合に適用されます。
  - 完全一致: このコントロールは、クエリ語句に完全に一致する語句がクエリに含まれている場合にのみ適用されます。
  これらの語句の 1 つがクエリに含まれている場合にコントロールが適用されます。
注: この条件に加えて、時間範囲の条件を指定すると、両方の条件が満たされた場合にのみコントロールが適用されます。
省略可: [時間範囲を追加] ボタンをクリックして、このコントロールを適用する時間範囲を 1 つ以上追加します。

注: この期間条件に加えて、カテゴリまたはクエリの利用条件を指定すると、両方の条件が満たされた場合にのみコントロールが適用されます。
[続行] をクリックして [アクション] セクションに進みます。
[フィルタアクション] フィールドに、商品属性のフィルタを追加します。

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

たとえば、「product1」と「product2」の赤と青のバージョンを指定するには: (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))
[続行] をクリックして [サービス提供構成] セクションに進みます。
コントロールを適用するサービス構成を選択します。
コントロール設定を送信します。

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

新しいコントロールは、[コントロール] ページの [サービス提供コントロール] タブに表示されます。

curl

リクエスト本文に含まれる Control のコントロール ID とインスタンスを使用して、Control.create リクエストを行います。

フィールドの詳細については、Controls API リファレンスと Controls.create API リファレンスをご覧ください。

ユーザーがサイトのカテゴリを閲覧した場合（search.request.queryが空）、またはユーザーがサイトを検索した場合（search.request.queryが空でない）、フィルタオプションをトリガーできます。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

サービス構成にコントロールを追加するには、ServingConfig.addControl メソッドを使用します。

このメソッドの詳細については、ServingConfig.addControl API リファレンスをご覧ください。
このメソッドの例については、サービス構成を管理をご覧ください。

リダイレクトコントロールを作成する

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

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

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

商品コンソールの [コントロール] ページが表示されます。
[コントロールを作成] をクリックします。
エンドユーザーの目標と必要なタイミングを定義します。すべての質問に回答する必要があります。[次へ] をクリックします。
コントロールを選択します。コントロールの名前を入力し、検索プロダクトを選択し、コントロールタイプ [リダイレクト] を選択します。
リダイレクト コントロールを設定します。
1. [トリガー] で、関連する検索クエリに条件（「contains」や「not in range」など）を指定して、このコントロールをトリガーするカタログ属性を定義します。カタログ属性が構成されていない場合、このコントロールは常に適用されます。
2. [期間] に入力して、適用期間を定義します。指定した期間のいずれかが満たされると、指定した期間のいずれかでカタログ属性がクエリと照合されます。[期間を追加] を使用して期間を追加します。
3. リダイレクト URL を入力して、このコントロールでトリガーするリダイレクトアクションを定義します。
[送信] をクリックして、管理リクエストを承認者に送信します。送信されたリクエストのステータスは、販売管理コンソールで確認できます。管理リクエストは、後で削除することもできます。

承認者の手順

[サービス構成] で、既存のサービス構成にコントロールを割り当てます。
リダイレクト コントロールのリクエストを承認します。

Cloud コンソール

検索広告コンソールの [コントロール] ページに移動します。

[コントロール] ページに移動
[Serving controls] タブで、 [Create control] をクリックします。

[コントロールを作成する] ペインが開きます。
[設定] セクションの [コントロール名] フィールドに、新しいコントロールの名前を入力します。
省略可: 自動的に作成されたコントロール ID を変更するには、[編集] をクリックして新しいコントロール ID を入力します。
コントロールタイプとして [リダイレクトコントロール] を選択します。
[続行]をクリックして [トリガー] セクションに進みます。
検索語句または期間トリガーを 1 つ以上作成します。リダイレクトコントロールには、少なくとも 1 つのトリガーが必要です。
このコントロールをトリガーするユーザーの行動のタイプを選択します。
- カテゴリを閲覧する: ユーザーがサイトのカテゴリを閲覧したときにルールがトリガーされます（search.request.query は空です）。
- 検索: ユーザーがサイトで検索したときにルールがトリガーされます（search.request.query は空ではありません）。
閲覧されるカテゴリまたは検索されるクエリに基づいてルールをトリガーするコントロール条件を設定します。使用可能なオプションは、[カテゴリを閲覧] か [検索] のどちらを選択するかによって異なります。
- [カテゴリを閲覧] を選択した場合: [カテゴリ] フィールドに、閲覧時にこのコントロールをトリガーするカテゴリを入力します。
- [検索] を選択した場合: [クエリを追加] ボタンをクリックし、フィルタするクエリ用語（running shoes など）を追加して、次の各用語のいずれかを選択します。
  - 部分一致: このコントロールは、クエリ語句に部分一致が含まれている場合に適用されます。
  - 完全一致: このコントロールは、クエリ語句に完全に一致する語句がクエリに含まれている場合にのみ適用されます。
  これらの語句の 1 つがクエリに含まれている場合にコントロールが適用されます。
注: この条件に加えて、時間範囲の条件を指定すると、両方の条件が満たされた場合にのみコントロールが適用されます。
[時間範囲を追加] ボタンをクリックして、このコントロールを適用する時間範囲を 1 つ以上追加します。

注: この期間条件に加えて、カテゴリまたはクエリの利用条件を指定すると、両方の条件が満たされた場合にのみコントロールが適用されます。
[続行] をクリックして [アクション] セクションに進みます。
このコントロールがトリガーされたときにリダイレクトする URI を入力します。
[続行] をクリックして [サービス提供構成] セクションに進みます。
コントロールを適用するサービス構成を選択します。
コントロール設定を送信します。

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

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

curl

リクエスト本文に含まれる Control のコントロール ID とインスタンスを使用して、Control.create リクエストを行います。

フィールドの詳細については、Controls API リファレンスと Controls.create API リファレンスをご覧ください。

ユーザーがサイトのカテゴリを閲覧した場合（search.request.queryが空）、またはユーザーがサイトを検索した場合（search.request.queryが空でない）、リダイレクトコントロールをトリガーできます。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

サービス構成にコントロールを追加するには、ServingConfig.addControl メソッドを使用します。

このメソッドの詳細については、ServingConfig.addControl API リファレンスをご覧ください。
このメソッドの例については、サービス構成を管理をご覧ください。

双方向の類義語コントロールを作成する

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

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

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

商品コンソールの [コントロール] ページが表示されます。
[コントロールを作成] をクリックします。
エンドユーザーの目標と必要なタイミングを定義します。すべての質問に回答する必要があります。[次へ] をクリックします。
コントロールを選択します。コントロールの名前を入力し、[検索] プロダクトを選択して、コントロールタイプ [類義語] を選択します。
双方向の類義語コントロールを構成します。
1. [トリガー] で、関連する検索クエリに条件（「contains」や「not in range」など）を指定して、このコントロールをトリガーするカタログ属性を定義します。カタログ属性が構成されていない場合、このコントロールは常に適用されます。
2. [期間] に入力して、適用期間を定義します。指定した期間のいずれかが満たされると、指定した期間のいずれかでカタログ属性がクエリと照合されます。[期間を追加] を使用して期間を追加します。
3. このコントロールでトリガーする類義語タイプを定義します。[双方向] を選択します。類義語の種類の詳細については、類義語のセクションをご覧ください。
[送信] をクリックします。詳細な双方向の類義語の設定画面が表示されます。
[双方向の類義語アクション] のフィールドに類義語を入力します。このアクションにより、検索結果で同じように扱われるように用語が双方向にリンクされます。たとえば、「赤いソファ」というクエリの結果には赤いマルーン色のソファが含まれますが、「マルーン色のソファ」というクエリの結果は、深紅やピンクなど、すべての種類の赤いソファが含まれるように拡張されます。
もう一度送信して、管理リクエストを承認者に送信します。送信されたリクエストのステータスは、販売管理コンソールで確認できます。管理リクエストは、後で削除することもできます。

承認者の手順

[サービス構成] で、既存のサービス構成にコントロールを割り当てます。
双方向の類義語コントロールのリクエストを承認します。

Cloud コンソール

検索広告コンソールの [コントロール] ページに移動します。

[コントロール] ページに移動
[Serving controls] タブで、 [Create control] をクリックします。
[コントロール名] フィールドに新しいコントロールの名前を入力します。

[コントロールを作成する] ペインが開きます。
[設定] セクションが表示されます。
省略可: 自動的に作成されたコントロール ID を変更するには、[編集] をクリックして新しいコントロール ID を入力します。
コントロールタイプとして [双方向の類義語コントロール] を選択します。
[続行]をクリックして [トリガー] セクションに進みます。
省略可: [時間範囲を追加] ボタンをクリックして、このコントロールを適用する時間範囲を 1 つ以上追加します。
[続行] をクリックして [アクション] セクションに進みます。
[類義語] フィールドに、互いに類義語であるクエリキーワード（shirt と top など）を 2 ～ 100 個入力します。

これらの語句のいずれかがクエリに含まれている場合、検索ではその他のクエリ語句は含まれている語句の類義語と見なされます。
[続行] をクリックして [サービス提供構成] セクションに進みます。
コントロールを適用するサービス構成を選択します。
コントロール設定を送信します。

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

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

curl

リクエスト本文に含まれる Control のコントロール ID とインスタンスを使用して、Control.create リクエストを行います。

フィールドの詳細については、Controls API リファレンスと Controls.create API リファレンスをご覧ください。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                    ]
                },
                "twoWaySynonymAction": {
                  "synonyms": [
                    "SYNONYM_1",
                    "SYNONYM_2"
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

サービス構成にコントロールを追加するには、ServingConfig.addControl メソッドを使用します。サービス構成にインラインでコントロールを追加するをご覧ください。

一方向の類義語コントロールを作成する

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

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

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

商品コンソールの [コントロール] ページが表示されます。
[コントロールを作成] をクリックします。
エンドユーザーの目標と必要なタイミングを定義します。すべての質問に回答する必要があります。[次へ] をクリックします。
コントロールを選択します。コントロールの名前を入力し、[検索] プロダクトを選択して、コントロールタイプ [類義語] を選択します。
一方向の類義語コントロールを構成します。
1. [トリガー] で、関連する検索クエリに条件（「contains」や「not in range」など）を指定して、このコントロールをトリガーするカタログ属性を定義します。カタログ属性が構成されていない場合、このコントロールは常に適用されます。
2. [期間] に入力して、適用期間を定義します。指定した期間のいずれかが満たされると、指定した期間のいずれかでカタログ属性がクエリと照合されます。[期間を追加] を使用して期間を追加します。
3. このコントロールでトリガーする類義語タイプを定義します。[片道] を選択します。類義語の種類の詳細については、類義語のセクションをご覧ください。
[送信] をクリックします。詳細な一方向の類義語の設定画面が表示されます。
[One-way synonym actions] のフィールドに類義語を入力します。この操作では、単一方向で語句をリンクし、検索結果で同じように扱われるようにします。たとえば、「赤いソファ」というクエリには「赤紫色のソファ」が含まれますが、「赤紫色のソファ」というクエリには他の種類の赤いソファは含まれず、結果は赤紫色のソファに限定されます。
もう一度 [送信] をクリックして、管理リクエストを承認者に送信します。送信されたリクエストのステータスは、販売管理コンソールで確認できます。管理リクエストは、後で削除することもできます。

承認者の手順

[サービス構成] で、既存のサービス構成にコントロールを割り当てます。
一方向の類義語コントロールのリクエストを承認します。

Cloud コンソール

検索広告コンソールの [コントロール] ページに移動します。

[コントロール] ページに移動
[Serving controls] タブで、 [Create control] をクリックします。

[コントロールを作成する] ペインが開きます。
[設定] セクションの [コントロール名] フィールドに、新しいコントロールの名前を入力します。
省略可: 自動的に作成されたコントロール ID を変更するには、[編集] をクリックして新しいコントロール ID を入力します。
コントロールタイプとして [一方向の類義語コントロール] を選択します。
[続行]をクリックして [トリガー] セクションに進みます。
省略可: [時間範囲を追加] ボタンをクリックして、このコントロールを適用する時間範囲を 1 つ以上追加します。
[続行] をクリックして [アクション] セクションに進みます。
[クエリキーワード] フィールドに、いずれかがクエリに含まれるときに類義語を関連付ける必要のある用語（shoes など）を入力します。
[類義語] フィールドに、指定したクエリキーワードの類義語として使用するキーワードを入力します（例: クエリキーワード shoes の一方向の類義語としての sneakers と sandals）。
[続行] をクリックして [サービス提供構成] セクションに進みます。
コントロールを適用するサービス構成を選択します。
コントロール設定を送信します。

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

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

curl

リクエスト本文に含まれる Control のコントロール ID とインスタンスを使用して、Control.create リクエストを行います。

フィールドの詳細については、Controls API リファレンスと Controls.create API リファレンスをご覧ください。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "oneWaySynonymAction": {
                  "synonyms": [
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "synonyms": [
                      "SYNONYM_1",
                      "SYNONYM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

サービス構成にコントロールを追加するには、ServingConfig.addControl メソッドを使用します。

このメソッドの詳細については、ServingConfig.addControl API リファレンスをご覧ください。
このメソッドの例については、サービス構成を管理をご覧ください。

「関連付けなし」のコントロールを作成する

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

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

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

商品コンソールの [コントロール] ページが表示されます。
[コントロールを作成] をクリックします。
エンドユーザーの目標と必要なタイミングを定義します。すべての質問に回答する必要があります。[次へ] をクリックします。
コントロールを選択します。コントロールの名前を入力し、[検索] プロダクトを選択して、コントロールタイプ [関連付けない] を選択します。
「関連付けなし」のコントロールを構成します。
1. [トリガー] で、関連する検索クエリに条件（「contains」や「not in range」など）を指定して、このコントロールをトリガーするカタログ属性を定義します。カタログ属性が構成されていない場合、このコントロールは常に適用されます。
2. [期間] に入力して、適用期間を定義します。指定した期間のいずれかが満たされると、指定した期間のいずれかでカタログ属性がクエリと照合されます。[期間を追加] を使用して期間を追加します。
3. [アクションを関連付けない] で、前の [トリガー] セクションで入力したクエリキーワードに関連付けないキーワードを指定します。それぞれ [クエリ語句] フィールドと [関連付け解除された語句] フィールドに入力します。
[送信] をクリックして、管理リクエストを承認者に送信します。送信されたリクエストのステータスは、販売管理コンソールで確認できます。管理リクエストは、後で削除することもできます。

承認者の手順

[サービス構成] で、既存のサービス構成にコントロールを割り当てます。
非関連付けコントロールのリクエストを承認します。

Cloud コンソール

検索広告コンソールの [コントロール] ページに移動します。

[コントロール] ページに移動
[Serving controls] タブで、 [Create control] をクリックします。

[コントロールを作成する] ペインが開きます。
[設定] セクションの [コントロール名] フィールドに、新しいコントロールの名前を入力します。
省略可: 自動的に作成されたコントロール ID を変更するには、[編集] をクリックして新しいコントロール ID を入力します。
コントロールタイプとして [Do not associate control] を選択します。
[続行]をクリックして [トリガー] セクションに進みます。
省略可: [時間範囲を追加] ボタンをクリックして、このコントロールを適用する時間範囲を 1 つ以上追加します。
[続行] をクリックして [アクション] セクションに進みます。
[クエリキーワード] フィールドに、他のクエリと明確に区別するキーワード（gShoe など）を入力します。
[関連付けられていないキーワード] フィールドに、指定したクエリキーワードに関連付けないようにするキーワードを入力します。

たとえば、クエリキーワード gShoe とキーワード cheap の関連付けを解除できます。
[続行] をクリックして [サービス提供構成] セクションに進みます。
コントロールを適用するサービス構成を選択します。
コントロール設定を送信します。

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

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

curl

リクエスト本文に含まれる Control のコントロール ID とインスタンスを使用して、Control.create リクエストを行います。

フィールドの詳細については、Controls API リファレンスと Controls.create API リファレンスをご覧ください。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "doNotAssociateAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "doNotAssociateTerms": [
                      "DISSOCIATED_TERM_1",
                      "DISSOCIATED_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

サービス構成にコントロールを追加するには、ServingConfig.addControl メソッドを使用します。

このメソッドの詳細については、ServingConfig.addControl API リファレンスをご覧ください。
このメソッドの例については、サービス構成を管理をご覧ください。

取り消しコントロールを作成する

このコントロールタイプの詳細については、取り消しコントロールをご覧ください。

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

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

商品コンソールの [コントロール] ページが表示されます。
[コントロールを作成] をクリックします。
エンドユーザーの目標と必要なタイミングを定義します。すべての質問に回答する必要があります。[次へ] をクリックします。
コントロールを選択します。コントロールの名前を入力し、[検索] プロダクトを選択して、コントロールタイプ [無視] を選択します。
[無視] コントロールを構成します。
1. [トリガー] で、関連する検索クエリに条件（「contains」や「not in range」など）を指定して、このコントロールをトリガーするカタログ属性を定義します。カタログ属性が構成されていない場合、このコントロールは常に適用されます。
2. [期間] に入力して、適用期間を定義します。指定した期間のいずれかが満たされると、指定した期間のいずれかでカタログ属性がクエリと照合されます。[期間を追加] を使用して期間を追加します。
3. 無視するアクションを [アクションを無視] に入力します。
[送信] をクリックして、管理リクエストを承認者に送信します。送信されたリクエストのステータスは、販売管理コンソールで確認できます。管理リクエストは、後で削除することもできます。

承認者の手順

[サービス構成] で、既存のサービス構成にコントロールを割り当てます。
[無視] コントロールのリクエストを承認します。

Cloud コンソール

検索広告コンソールの [コントロール] ページに移動します。

[コントロール] ページに移動
[Serving controls] タブで、 [Create control] をクリックします。

[コントロールを作成する] ペインが開きます。
[設定] セクションの [コントロール名] フィールドに、新しいコントロールの名前を入力します。
省略可: 自動的に作成されたコントロール ID を変更するには、[編集] をクリックして新しいコントロール ID を入力します。
コントロールタイプとして [Do not associate control] を選択します。
[続行]をクリックして [トリガー] セクションに進みます。
省略可: [時間範囲を追加] ボタンをクリックして、このコントロールを適用する時間範囲を 1 つ以上追加します。
[続行] をクリックして [アクション] セクションに進みます。
[キーワードを無視] フィールドに、クエリキーワードで入力するときに検索が無視するキーワード（shoddy など）を入力します。
[続行] をクリックして [サービス提供構成] セクションに進みます。
コントロールを適用するサービス構成を選択します。
コントロール設定を送信します。

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

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

curl

リクエスト本文に含まれる Control のコントロール ID とインスタンスを使用して、Control.create リクエストを行います。

フィールドの詳細については、Controls API リファレンスと Controls.create API リファレンスをご覧ください。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "ignoreAction": {
                  "ignoreTerms": [
                      "IGNORE_TERM_1",
                      "IGNORE_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

サービス構成にコントロールを追加するには、ServingConfig.addControl メソッドを使用します。

このメソッドの詳細については、ServingConfig.addControl API リファレンスをご覧ください。
このメソッドの例については、サービス構成を管理をご覧ください。

代替コントロールを作成する

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

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

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

商品コンソールの [コントロール] ページが表示されます。
[コントロールを作成] をクリックします。
エンドユーザーの目標と必要なタイミングを定義します。すべての質問に回答する必要があります。[次へ] をクリックします。
コントロールを選択します。コントロールの名前を入力し、検索プロダクトを選択し、コントロールタイプ [置換] を選択します。
置換コントロールを構成します。
1. [トリガー] で、関連する検索クエリに条件（「contains」や「not in range」など）を指定して、このコントロールをトリガーするカタログ属性を定義します。カタログ属性が構成されていない場合、このコントロールは常に適用されます。
2. [期間] に入力して、適用期間を定義します。指定した期間のいずれかが満たされると、指定した期間のいずれかでカタログ属性がクエリと照合されます。[期間を追加] を使用して期間を追加します。
3. [置換アクション] で、置き換えるクエリキーワードを最初のフィールドに、その代替キーワードを 2 番目のフィールドに定義します。
[送信] をクリックして、管理リクエストを承認者に送信します。送信されたリクエストのステータスは、販売管理コンソールで確認できます。管理リクエストは、後で削除することもできます。

承認者の手順

[サービス構成] で、既存のサービス構成にコントロールを割り当てます。
交換コントロールのリクエストを承認します。

Cloud コンソール

検索広告コンソールの [コントロール] ページに移動します。

[コントロール] ページに移動
[Serving controls] タブで、 [Create control] をクリックします。

[コントロールを作成する] ペインが開きます。
[設定] セクションの [コントロール名] フィールドに、新しいコントロールの名前を入力します。
省略可: 自動的に作成されたコントロール ID を変更するには、[編集] をクリックして新しいコントロール ID を入力します。
コントロールタイプとして [代替コントロール] を選択します。
[続行]をクリックして [トリガー] セクションに進みます。
省略可: [時間範囲を追加] ボタンをクリックして、このコントロールを適用する時間範囲を 1 つ以上追加します。
[続行] をクリックして [アクション] セクションに進みます。
[クエリキーワード] フィールドに、代替キーワードで置き換えるクエリキーワード（gShoe など）を入力します。
[代替キーワード] フィールドに、指定したクエリキーワードを置き換えるキーワードを入力します。

たとえば、クエリキーワード gShoe を代替キーワード Google Shoe に置き換えることができます。
[続行] をクリックして [サービス提供構成] セクションに進みます。
コントロールを適用するサービス構成を選択します。
コントロール設定を送信します。

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

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

curl

リクエスト本文に含まれる Control のコントロール ID とインスタンスを使用して、Control.create リクエストを行います。

フィールドの詳細については、Controls API リファレンスと Controls.create API リファレンスをご覧ください。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "replacementAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "replacementTerm": "REPLACEMENT_TERM"
                  }
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

サービス構成にコントロールを追加するには、ServingConfig.addControl メソッドを使用します。

このメソッドの詳細については、ServingConfig.addControl API リファレンスをご覧ください。
このメソッドの例については、サービス構成を管理をご覧ください。

固定コントロールを作成する

固定コントロールを作成するには:

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

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

商品コンソールの [コントロール] ページが表示されます。
[コントロールを作成] をクリックします。
エンドユーザーの目標と必要なタイミングを定義します。すべての質問に回答する必要があります。[次へ] をクリックします。
コントロールを選択します。コントロールの名前を入力し、検索プロダクトを選択し、コントロールタイプ [固定] を選択します。
[固定] コントロールを設定します。
1. [トリガー] で、関連する検索クエリに条件（「contains」や「not in range」など）を指定して、このコントロールをトリガーするカタログ属性を定義します。カタログ属性が構成されていない場合、このコントロールは常に適用されます。
2. [期間] に入力して、適用期間を定義します。指定した期間のいずれかが満たされると、指定した期間のいずれかでカタログ属性がクエリと照合されます。[期間を追加] を使用して期間を追加します。
3. このコントロールでトリガーする固定アクションを定義します。これらのアクションは、商品 ID とピンの位置（120 未満の数字が望ましい）で定義されます（120 は一般的なページサイズです）。[商品を追加] をクリックして、最大 10 個追加できます。
[送信] をクリックして、管理リクエストを承認者に送信します。送信されたリクエストのステータスは、販売管理コンソールで確認できます。管理リクエストは、後で削除することもできます。

承認者の手順

[サービス構成] で、既存のサービス構成にコントロールを割り当てます。
固定コントロールのリクエストを承認します。

Cloud コンソール

検索広告コンソールの [コントロール] ページに移動します。

[コントロール] ページに移動
[Serving controls] タブで、 [Create control] をクリックします。

[コントロールを作成する] ペインが開きます。
[設定] セクションの [コントロール名] フィールドに、新しいコントロールの名前を入力します。
省略可: 自動的に作成されたコントロール ID を変更するには、[編集] をクリックして新しいコントロール ID を入力します。
[プロダクトの選択] セクションで、[検索または参照] を選択します。
コントロールタイプとして [固定コントロール] を選択します。[続行] をクリックします。
[トリガー] セクションで、このコントロールをトリガーするユーザーの行動を選択します。
- カテゴリをブラウジングする: ブラウジングリクエストでは、search.request.query が空であるだけでなく、page_categories フィールドに値を入力する必要があります。
- 検索: 検索リクエストでは、search.request.query のみを入力する必要があります。
  
  デフォルトでは、閲覧されたすべてのカテゴリと検索されたすべてのクエリがこのコントロールをトリガーします。
省略可: 閲覧された特定のカテゴリまたは検索されたクエリに基づいてルールをトリガーする条件を設定します。
- カテゴリを閲覧: [カテゴリ] フィールドに、コントロールをトリガーするカテゴリを入力します。
- 検索: フィルタするクエリキーワード（running shoes など）を追加するには、[クエリを追加] をクリックします。キーワードごとに、[部分一致] または [完全一致] を選択します。
省略可: [時間範囲を追加] または [期間を追加] をクリックして、このコントロールを適用する時間範囲を 1 つ以上追加します。

注: カテゴリまたはクエリの利用条件と期間条件または日付範囲条件を指定すると、両方の条件が満たされた場合にのみコントロールが適用されます。
[続行] をクリックして [アクション] セクションに進みます。[固定位置] で、商品を固定する位置をスライダーで指定します。ピンの値スライダーでは、0、負の数値、整数以外の値は使用できません。

Vertex AI Search for Commerce では、1 つのコントロールのピンマップ内に 10 個のピンを配置できます。位置は 1 ～ 120（最大リクエストページサイズ）の任意の値に設定できます。

注: 2 ページ目への固定は、位置がリクエストページサイズより大きい場合、適用されません。たとえば、検索クエリでページサイズが 50 とリクエストされているにもかかわらず、固定ページが 75 ページに設定されている場合、検索結果ではその検索項目は無視されます。
[続行] をクリックして [サービス提供構成] セクションに進みます。コントロールを適用するサービス構成を選択し、コントロール設定を送信します。

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

新しいコントロールは、[コントロール] ページの [サービス提供コントロール] タブに表示されます。

curl

リクエスト本文に含まれる Control のコントロール ID とインスタンスを使用して、Control.create リクエストを行います。

フィールドの詳細については、Controls API リファレンスと Controls.create API リファレンスをご覧ください。

curl -X POST \
 -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
 -H "Content-Type: application/json; charset=utf-8" \
 -H "X-Goog-User-Project: PROJECT_NUMBER" \
 --data '{
          "displayName": "DisplayName",
          "solutionTypes": "SOLUTION_TYPE_SEARCH",
          "searchSolutionUseCase": ["SEARCH_SOLUTION_USE_CASE_SEARCH"],
     "rule": {
            "condition": {
 "queryTerms": [
                {
                  "value": "Term1",
                  "fullMatch": "boolean: true / false"
                },
                {
                  "value": "Term2",
                  "fullMatch": "boolean: true / false"
                },
             ],
             "activeTimeRange": [
               {
                 "startTime": timestamp1,
                 "endTime": timestamp2
               },
               {
                 "startTime": timestamp3,
                 "endTime": timestamp4
               }
             ]
            },
            "pinAction": {
               "pinMap" :  {
                        "pin_position1": "product_id",
                      "pin_position2": "product_id>"
                    }
            }
              }
}' \
"https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/controls?controlId=CONTROL_ID"

pin_position は [1,10] の整数にする必要があります。また、product_id はカタログに存在している必要があります。ピンマップ内で許可される要素の最大数は、コントロールごとに 10 個です。

次に、固定コントロールをサービス構成にアタッチします。

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-H "X-Goog-User-Project: PROJECT_NUMBER" \
-d '{
      "controlId": "CONTROL_ID"
  }' \
'https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:addControl'

この場合、CONTROL_ID は、前に作成した固定コントロール id にする必要があります。

サービス構成にコントロールを追加するには、ServingConfig.addControl メソッドを使用します。

このメソッドの詳細については、ServingConfig.addControl API リファレンスをご覧ください。
このメソッドの例については、サービス構成を管理をご覧ください。

最後に、設定をテストするために検索リクエストを行います。リクエストに固定コントロールが正常に適用されるようにするには、前の手順で作成したコントロールで指定したキーワードまたはページカテゴリと一致するクエリキーワード（検索の場合）またはページカテゴリ（ブラウジングの場合）を使用します。

Cloud コンソール

検索広告コンソールの [評価] ページに移動します。

[評価] ページに移動
[検索] タブに移動します。
検索クエリフィールドにテストクエリを入力します。
[検索プレビュー] をクリックします。
結果を表示して、選択した商品が固定されていることを確認します。

curl

curl -s -X POST -H "Authorization: Bearer " -H "Content-Type: application/json"
--data "{'query': '','visitorId': ''}" \ "https://retail.googleapis.com/v2/projects/PROJECT/locations/global/catalogs/CATALOG/placements/default_search:search"

エラーチェックの制約

エラーチェックでは、次の制約に注意してください。

2 つの商品を同じ位置に固定することはできません。つまり、商品「a」と商品「b」の両方を位置 2 に配置することはできません。
一方、1 つの商品を複数の位置に固定することはできません。つまり、同じクエリで商品「a」を位置 #2 と #3 に同時に固定することはできません。
フィルタや並べ替えが適用されていないことを前提として、product_id はカタログに商品として存在している必要があります。

サービス提供コントロールを作成する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

サービング コントロールと構成の関係

クイックスタート動画とガイド

サービス提供コントロールの構成オプション

Google Cloud コンソールを使用する

商品コンソールを使用する

管理者としてコンソールを使用する

マーチャンダイジング コンソールのユーザーをオンボーディングする

ユーザーとしてコンソールにアクセスする

サイト マーチャンダイザーとしてコンソールを使用する

コントロールの種類

ブースト / 埋め込みコントロールを作成する

検索のブースト/埋め込みコントロールを作成する

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

承認者の手順

Cloud コンソール

curl

レコメンデーションのブースト/埋め込みコントロールを作成する

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

承認者の手順

Cloud コンソール

curl

フィルタ オプションを作成する

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

承認者の手順

Cloud コンソール

curl

リダイレクト コントロールを作成する

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

承認者の手順

Cloud コンソール

curl

双方向の類義語コントロールを作成する

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

承認者の手順

Cloud コンソール

curl

一方向の類義語コントロールを作成する

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

承認者の手順

Cloud コンソール

curl

「関連付けなし」のコントロールを作成する

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

承認者の手順

Cloud コンソール

curl

取り消しコントロールを作成する

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

承認者の手順

Cloud コンソール

curl

代替コントロールを作成する

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

承認者の手順

Cloud コンソール

curl

固定コントロールを作成する

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

承認者の手順

Cloud コンソール

curl

Cloud コンソール

curl

エラーチェックの制約

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

サービングコントロールと構成の関係

マーチャンダイジングコンソールのユーザーをオンボーディングする

サイトマーチャンダイザーとしてコンソールを使用する

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

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

フィルタオプションを作成する

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

リダイレクトコントロールを作成する

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

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

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

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

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

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

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