Vertex AI Search for retail 已更名為 Vertex AI Search for commerce。我們會更新內容，反映新的品牌形象。

本頁面由 Cloud Translation API 翻譯而成。

建立供應控制項

本頁說明如何建立放送控制選項。

放送控制項是您定義並套用至個別放送設定的規則。

你可以在 Search for commerce 控制台中建立放送控制項，其中包含觸發控制項的條件，以及條件觸發時執行的動作。接著，您可以將新的放送控制項附加至放送設定。

放送控制項和設定之間的關係

供應設定與控制項之間存在多對多關係。您可以在供應設定中新增多個控制選項，單一控制選項也可以與多個供應設定建立關聯。

建立供應控制項和供應設定時，請選取控制項適用的產品 (建議或搜尋)。

供應控制項只能與相同產品類型的供應設定建立關聯。舉例來說，為建議建立的供應控制項無法與為搜尋建立的供應設定建立關聯。

供應設定可管理在搜尋或預測要求期間套用的控制項。在放送期間，系統只會考量要求有效放送設定中的控制選項。舉例來說，假設您建立了兩項控制項：一項名為「gShoe Sale」的控制項，會在搜尋「鞋子」時提升 gShoe 品牌的結果；另一項名為「More shoes」的控制項，會使用「跑鞋」一詞擴大查詢範圍，納入「運動鞋」。如果只將 gShoe Sale 控制項附加至供應設定，則使用該供應設定的搜尋要求會提升使用「shoes」一詞查詢時的 gShoe 結果，但「More shoes」控制項不會生效，因為該控制項未附加至您使用的供應設定。

詳情請參閱「關於供應設定」。

快速入門影片和指南

供應控制項簡介：供應控制項可讓您建立規則，自訂供應設定傳回搜尋結果的方式。
提升/隱藏：影響傳回結果清單中的結果排名和順序。可供搜尋和推薦。
篩選：從傳回的結果清單中，移除未通過篩選器的結果。僅適用於搜尋。
重新導向：根據搜尋查詢，將使用者重新導向至特定頁面。僅適用於搜尋。

本教學課程說明如何使用重新導向控制項。

如要直接在 Cloud Shell 編輯器中按照逐步指南操作，請按一下「Guide me」(逐步引導)：

逐步引導

語言：自訂搜尋查詢語言。僅適用於搜尋。

可用的語言控制項類型如下：
- 同義詞：擴大搜尋查詢的同義詞範圍。
- 單向同義詞：針對特定字詞，單向擴展視為同義詞的字詞。
- 不要建立關聯：防止特定字詞出現時，在搜尋中使用一組字詞。
- 忽略：禁止在搜尋中使用特定字詞。
- 取代：取代搜尋查詢中的字詞。
釘選：影響結果排序，將結果放在特定位置，例如第 4 個位置。可供搜尋及瀏覽。

如需這些控制項的範例，請參閱「關於供應控制項」。

供應控制設定選項

您可以建立控制項，然後新增或替換為放送中的設定。

最多可建立 100 個放送控制選項。如需更多放送控制選項，請申請更多配額。如要瞭解如何申請額外配額，請參閱「提高配額」。供應設定最多可有 100 個供應控制項 (重新導向控制項除外)，每個供應設定最多可有 1000 個重新導向控制項。

您可以透過下列方式建立放送控制項：

在Google Cloud 控制台的「Controls」頁面中：您可以在建立放送設定的過程中，選擇建立控制項。
你可以使用推銷控制台。
您可以使用 Controls.create 方法，內嵌建立放送控制項。

使用 Google Cloud 控制台

如要使用 Google Cloud 控制台建立放送控制項，請按照下列步驟操作：

前往 Search for commerce 控制台的「Controls」頁面。

前往「Controls」(控制項) 頁面
請按照 Google Cloud 各服務控制項部分的控制台步驟操作。

使用 Merchandising 控制台

商品陳列控制台是專為商品陳列人員設計的工具，可建立及管理控制選項。這項功能提供核准流程，讓所有商品銷售人員都能提出控制項，並由商品銷售人員核准者審查。

使用 Merchandising 控制台建立放送控制項，例如釘選、升級/埋藏、同義字和 facet。Merchandising 控制台提供簡單易用的介面，方便商品銷售人員有效建立及管理控制項。這項工具也能簡化核准程序，讓任何商品銷售人員都能提議控管措施，並由商品銷售人員核准者審查。

如要存取「商品」控制台分頁，您至少必須具備下列權限： Google Cloud

專案檢視者 (檢視者)：存取專案。
零售業編輯者：編輯及儲存商品陳列控制台設定。

以管理員身分使用控制台

開始前，你必須是 Google Cloud 管理員，才能將使用者加入 Merchandising 控制台。

接著，在 Google Cloud 控制台中存取 Merchandising 控制台分頁，初始化 Merchandising 控制台：

如要存取、編輯及指派「建立者」或「核准者」角色給 Merchandising 控制台使用者，您需要下列 IAM 角色：

如要編輯 Merchandising 控制台，至少需要零售編輯者角色。
如要將「建立者」或「核准者」角色指派給使用者，您必須具備專案層級的 IAM 管理員角色。

如要瞭解 IAM 專案層級和 Vertex AI Search for Commerce 權限的完整配置，請參閱本 [Vertex AI Search for Commerce 產品](/retail/docs/iam)說明文件中的「[預先定義的管理員角色](/retail/docs/iam#roles)」一節。

為 Merchandising 控制台使用者提供新手上路指南

如果你是 Google Cloud 控制台管理員，如要授予網站商品銷售人員 Merchandising 控制台的存取權，並指派「建立者」或「核准者」角色，請按照下列步驟操作：

前往 Search for commerce 控制台的「Controls」頁面。

前往「Controls」(控制項) 頁面
前往「商品目錄管理控制台」分頁。
你可以看到與目前 Google Cloud 專案相關聯的 Merchandising 控制台專屬網址。複製連結或直接在 Google Cloud 控制台中開啟連結。
選取預設供應設定，供銷售人員用來預覽和附加核准的控制項。
授予使用者「核准者」或「建立者」角色。
你可以看到與目前 Google Cloud 專案相關聯的 Merchandising 控制台專屬網址。複製連結或直接在 Google Cloud 控制台中開啟。
在商品陳列控制台中，選取「預覽」的預設供應設定。
(選用) 使用下列函式編輯 Merchandising 控制台的存取權：

新增使用者：授予使用者「核准者」或「建立者」存取權，讓他們能使用商品目錄管理控制台。
刪除使用者：刪除核准者或建立者，撤銷他們對 Merchandising 控制台的存取權。

新增核准者電子郵件地址。每當商品目錄管理員提交控管措施，核准者電子郵件清單中的使用者就會收到電子郵件，可審查並核准這項控管措施。

以使用者身分存取控制台

如果您是透過網址取得存取權，可以選擇使用 Merchandising 控制台，而非標準 Google Cloud 控制台。如要使用 Merchandising 控制台建立控管選項，請按照下列步驟操作：

使用管理員提供的憑證登入。
請按照各服務控制部分的步驟，參閱 Merchandising 控制台說明文件。
提交後，你會收到主旨為「[商家主控台] 待審查的建議控制項」的通知電子郵件。
核准者可以接受、拒絕或變更控制權要求。

以網站商品陳列人員身分使用控制台

請按照下列步驟，以網站商品銷售人員的身分開始使用 Merchandising 控制台。

設定問題的核准流程。

前往主選單的「設定」部分。
根據預設，系統會在「定義目標」畫面中設定預先定義的問題清單。

按一下「新增問題」新增問題，協助「核准者」瞭解新控管措施的用途。
按一下「儲存」即可儲存問題。

建立控制項。

前往「控制項」部分。
按一下「建立控制項」。
定義目標：必須回答先前定義的所有問題。如果您尚未定義任何問題，就不會看到這個畫面。
選取控制項。指定控制項類型，並為控制項指派名稱。
設定規則：您可以為每項規則定義觸發條件和動作。
定義觸發條件：目標是設定套用這項控制項的時機。

查詢字詞：當搜尋查詢包含或完全符合特定字詞時，系統就會觸發這項規則。您可以定義這些查詢字詞。
適用時間範圍：您可以套用時間限制，將這項規則的啟用時間限制在特定時間範圍內。

定義動作：視控制項類型而定，您可以定義動作，例如釘選控制項的項目 ID 和位置。
預覽規則：畫面上會顯示規則的動態預覽畫面。
提交規則：按一下「提交」提交零售商設定的規則後，你可以在控制項清單中查看「待處理」控制項。

核准控制選項

如要核准控制項，請按一下控制項清單中控制項旁的「更多」圖示。選取「檢閱」。
系統會提供畫面，讓您核准、拒絕或核准並編輯特定控制項。
核准後，系統會將您重新導向至控制項清單頁面，並顯示控制項為「已核准」。

商品企劃控制台階段

控制項類型

控制項的類型不同，要求也不同。請前往您打算建立的控制項類型建立程序：

建立升級/埋沒控制項
建立篩選器控制選項
建立重新導向控制項
建立釘選控制項
建立雙向同義詞控制項
建立單向同義詞控制項
建立「請勿建立關聯」控制選項
建立忽略控制項
建立替代控制項

建立提高/降低排名控制項

此控制項類型適用於搜尋和建議。

建立搜尋升級/隱藏控制項
建立推薦內容升級/隱藏控制選項

如要進一步瞭解這類控制項，請參閱「升級/埋沒控制項」。

建立搜尋升降級控制項

如要建立搜尋升級/隱藏控制項，請按照下列步驟操作：

商品企劃主控台

按一下管理員提供的網址。 (登入)。

系統會將你導向商品目錄控制台的「控制項」頁面。
按一下「建立控制項」。
定義目標使用者和所需時間。請務必回答所有問題。點選「下一步」。
選取控制項。輸入控制選項的名稱，選取「搜尋」產品，然後選擇「提高/降低排名」控制選項類型。
設定「提高/降低排名」控制項：
1. 在「觸發條件」下方，為相關搜尋查詢提供條件 (例如「包含」或「不在範圍內」)，定義觸發這項控制項的目錄屬性。如未設定任何目錄屬性，系統一律會套用這項控管機制。
2. 輸入「日期範圍」，定義「適用時間範圍」。如果符合任何指定的時間範圍，目錄屬性就會在任何指定的時間範圍內與查詢相符。使用「新增時間範圍」新增時間範圍。
3. 定義要透過這個控制項觸發的升級/埋藏動作。這些動作是由目錄屬性 (例如顏色)、條件 (例如包含) 和值 (例如紅色) 所定義。
4. 按一下「新增屬性」即可新增更多屬性。
使用滑桿設定升級/隱藏值。負數代表埋葬，正數代表提升。
按一下「提交」，將控制權要求提交給核准者。你可以在 Merchandising Console 中查看已提交要求的狀態。如果改變心意，可以刪除控制權要求。

核准者步驟

在「供應設定」下方，將控制項指派給現有的供應設定。
核准「提高/降低排名」控制選項的要求。

Cloud 控制台

前往 Search for commerce 控制台的「Controls」頁面。

前往「Controls」(控制項) 頁面
在「放送控制項」分頁下方，按一下「建立控制項」。

「建立控制項」窗格隨即開啟。
在「偏好設定」部分的「控制項名稱」欄位中，輸入新控制項的名稱。
選用：如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。
在「產品選擇」部分中，選取「搜尋」。
選擇「升級/埋藏控制項」做為控制項類型。按一下「繼續」
在「觸發條件」部分，選取會觸發這項控制項的使用者行為類型。
- 瀏覽類別：當使用者瀏覽網站上的類別時，就會觸發規則 (search.request.query 為空白)。
- 搜尋：當使用者在您的網站上搜尋時 (search.request.query 不為空白)，系統就會觸發規則。如要設定這項控制項，在瀏覽任何類別或搜尋任何查詢時觸發，請略過下列步驟。
選用：根據瀏覽的類別或搜尋的查詢，設定可觸發這項控制項的特定類別或查詢。
- 如果選擇「瀏覽類別」：在「類別」欄位中，輸入瀏覽時會觸發這項控制選項的類別。
- 如果選擇「搜尋」：按一下「新增查詢」按鈕，新增要篩選的查詢字詞 (例如 running shoes)。為每個字詞選擇「部分比對」或「完整比對」。
注意： 如果除了時間範圍條件外，您還指定了類別或查詢字詞條件，則只有在同時符合這兩項條件時，系統才會套用控管設定。
選用：按一下「新增時間範圍」按鈕，新增一或多個可套用這項控制項的時間範圍。

注意： 如果除了這類條件外，您還指定時間範圍條件，則只有在同時符合這兩項條件時，系統才會套用控管措施。
按一下「繼續」，前往「動作」部分。
在「Boost/bury product」(升級/埋藏產品) 欄位中新增產品屬性的篩選條件。

使用「篩選和排序」一文所述的篩選運算式語法。舉例來說，如要指定「product1」和「product2」的紅色和藍色版本：(id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))
如要設定升級強度，請使用「Boost/bury value」(升級/埋沒值) 滑桿。正值會提升結果，負值則會埋藏結果。點選「繼續」。
在「供應設定」部分，選取要套用控制項的供應設定。
提交控制項設定。

新建立或更新的控制項需要幾分鐘才能準備好放送即時流量。您可以在控制台的「評估」頁面，測試變更是否已套用。

您現在可以在「控制項」頁面的「供應控制項」分頁中，找到列出的新控制項。

curl

提出 Control.create 要求，並在要求主體中包含控制項 ID 和 Control 的例項。

如需欄位詳細資料，請參閱 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 參考資料。
如需這個方法的範例，請參閱「管理放送設定」。

建立推薦內容升降權重控制項

如要建立建議提高/降低排名控制項，請按照下列步驟操作：

商品企劃主控台

按一下管理員提供的網址。 (登入)。

系統會將你導向商品目錄控制台的「控制項」頁面。
按一下「建立控制項」。
定義目標使用者和所需時間。請務必回答所有問題。點選「下一步」。
選取控制項。輸入控制選項的名稱，選取「瀏覽」產品，然後選擇「提高/降低排名」控制選項類型。
設定「提高/降低排名」控制項：
1. 在「觸發條件」下方，輸入要觸發控制項的網頁類別。如未設定任何目錄屬性，則此控制項隨時都會處於有效狀態。
2. 輸入「日期範圍」，定義「適用時間範圍」。如果符合任何指定的時間範圍，目錄屬性就會在任何指定的時間範圍內與查詢相符。使用「新增時間範圍」新增時間範圍。
3. 定義要透過這個控制項觸發的升級/埋藏動作。這些動作是由目錄屬性 (例如顏色)、條件 (例如包含) 和值 (例如紅色) 所定義。
4. 按一下「新增屬性」即可新增更多屬性。
使用滑桿設定升級/隱藏值。負數代表埋藏，正數代表提升。
按一下「提交」，將控制權要求提交給核准者。你可以在 Merchandising Console 中查看已提交要求的狀態。如果改變心意，可以刪除控制權要求。

核准者步驟

在「供應設定」下方，將控制項指派給現有的供應設定。
核准「提高/降低排名」控制選項的要求。

Cloud 控制台

前往 Search for commerce 控制台的「Controls」頁面。

前往「Controls」(控制項) 頁面
在「供應控制項」分頁中，按一下「建立控制項」。

「建立控制項」窗格隨即開啟。
在「偏好設定」部分的「控制項名稱」欄位中，輸入新控制項的名稱。
(選用) 如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。
在「產品選擇」部分中，選取「建議」。
選擇「升級/埋藏控制項」做為控制項類型。
按一下「繼續」，前往「動作」部分。
在「Boost/bury product」(升級/埋藏產品) 欄位中新增產品屬性的篩選條件。

使用「篩選建議」一文所述的篩選運算式語法。

舉例來說，如要指定「product1」和「product2」的紅色和藍色版本： (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))
如要設定升級強度，請使用「Boost/bury value」(升級/埋沒值) 滑桿。正值會提升結果，負值則會埋藏結果。
按一下「繼續」，前往「放送設定」部分。
選取要套用控管的供應設定。
提交控制項設定。

新建立或更新的控制項需要幾分鐘才能準備好放送即時流量。您可以在控制台的「評估」頁面，測試變更是否已套用。

您可以在「控制項」頁面的「供應控制項」分頁中，找到新的控制項。

curl

提出 Control.create 要求，並在要求主體中包含控制項 ID 和 Control 的例項。

如需欄位詳細資料，請參閱 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 參考資料。
如需這個方法的範例，請參閱「管理放送設定」。

建立篩選器控制項

如要進一步瞭解這類控制項，請參閱「篩選器控制項」。

商品企劃主控台

按一下管理員提供的網址。 (登入)。

系統會將你導向商品目錄控制台的「控制項」頁面。
按一下「建立控制項」。
定義目標使用者和所需時間。請務必回答所有問題。點選「下一步」。
選取控制項。輸入控制選項名稱，選取「搜尋」或「瀏覽」產品，然後選擇「篩選器」控制選項類型。
設定「篩選器」控制項：
1. 在「觸發條件」下方，為相關搜尋查詢或網頁類別提供條件 (例如「包含」或「不在範圍內」)，定義觸發這項控管機制的目錄屬性。如未設定任何目錄屬性，系統一律會套用這項控管機制。
2. 輸入「日期範圍」，定義「適用時間範圍」。如果符合任何指定的時間範圍，目錄屬性就會在任何指定的時間範圍內與查詢相符。使用「新增時間範圍」新增時間範圍。
3. 定義要透過這個控制項觸發的篩選器動作。這些動作是由目錄屬性 (例如顏色)、條件 (例如包含) 和值 (例如紅色) 所定義。
4. 按一下「新增屬性」即可新增更多屬性。
按一下「提交」，將控制權要求提交給核准者。你可以在 Merchandising Console 中查看已提交要求的狀態。如果改變心意，可以刪除控制權要求。

核准者步驟

在「供應設定」下方，將控制項指派給現有的供應設定。
核准「篩選器」控制項的要求。

Cloud 控制台

前往 Search for commerce 控制台的「Controls」頁面。

前往「Controls」(控制項) 頁面
在「供應控制項」分頁中，按一下「建立控制項」。

「建立控制項」窗格隨即開啟。
在「偏好設定」部分的「控制項名稱」欄位中，輸入新控制項的名稱。
選用：如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。
選擇「篩選器控制項」做為控制項類型。
按一下「繼續」，前往「觸發條件」部分。
選取會觸發這項控管機制的行為類型：
- 瀏覽類別：當使用者瀏覽網站上的類別時，就會觸發規則 (search.request.query 為空白)。
- 搜尋：使用者在網站上搜尋時會觸發規則 (search.request.query 不為空白)。
選用：設定控制條件，根據瀏覽的類別或搜尋的查詢觸發規則。可用選項取決於你選擇「瀏覽類別」或「搜尋」：
- 如果選擇「瀏覽類別」：在「類別」欄位中，輸入瀏覽時會觸發這項控制選項的類別。
- 如果選擇「搜尋」：按一下「新增查詢」按鈕，新增要篩選的查詢字詞 (例如 running shoes)，然後為每個字詞選取下列其中一個選項：
  - 部分比對：如果查詢部分比對這個查詢字詞，就會套用這項控制項。
  - 完全比對：只有在查詢完全比對這個查詢字詞時，這項控制項才會生效。
  查詢中包含這些字詞時，系統就會套用控管措施。
注意： 如果除了這項條件外，您還指定了時間範圍條件，則只有在同時符合這兩項條件時，系統才會套用控制項。
選用：按一下「新增時間範圍」按鈕，新增一或多個可套用這項控制項的時間範圍。

注意： 如果除了這個時間範圍條件外，您還指定了類別或查詢字詞條件，則只有在同時符合這兩個條件時，系統才會套用控制選項。
按一下「繼續」，前往「動作」部分。
在「篩選動作」欄位中新增產品屬性的篩選條件。

使用「篩選和排序」一節中記錄的篩選運算式語法。

舉例來說，如要指定「product1」和「product2」的紅色和藍色版本： (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))
按一下「繼續」，前往「放送設定」部分。
選取要套用控管的供應設定。
提交控制項設定。

新建立或更新的控制項需要幾分鐘才能準備好放送即時流量。您可以在控制台的「評估」頁面，測試變更是否已套用。

您可以在「控制項」頁面的「供應控制項」分頁中，找到新的控制項。

curl

提出 Control.create 要求，並在要求主體中包含控制項 ID 和 Control 的例項。

如需欄位詳細資料，請參閱 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"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "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": {
                  "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 參考資料。
如需這個方法的範例，請參閱「管理放送設定」。

建立重新導向控制項

如要進一步瞭解這類控制項，請參閱「重新導向控制項」。

商品企劃主控台

按一下管理員提供的網址。 (登入)。

系統會將你導向商品目錄控制台的「控制項」頁面。
按一下「建立控制項」。
定義目標使用者和所需時間。請務必回答所有問題。點選「下一步」。
選取控制項。輸入控制選項的名稱，選取「搜尋」產品，然後選擇「重新導向」控制選項類型。
設定「重新導向」控制項：
1. 在「觸發條件」下方，為相關搜尋查詢提供條件 (例如「包含」或「不在範圍內」)，定義觸發這項控制項的目錄屬性。如未設定任何目錄屬性，系統一律會套用這項控管機制。
2. 輸入「日期範圍」，定義「適用時間範圍」。如果符合任何指定的時間範圍，目錄屬性就會在任何指定的時間範圍內與查詢相符。使用「新增時間範圍」新增時間範圍。
3. 輸入重新導向網址，定義要透過這個控制項觸發的重新導向動作。
按一下「提交」，將控制權要求提交給核准者。你可以在 Merchandising Console 中查看已提交要求的狀態。如果改變心意，可以刪除控制權要求。

核准者步驟

在「供應設定」下方，將控制項指派給現有的供應設定。
核准「重新導向」控制項的要求。

Cloud 控制台

前往 Search for commerce 控制台的「Controls」頁面。

前往「Controls」(控制項) 頁面
在「供應控制項」分頁中，按一下「建立控制項」。

「建立控制項」窗格隨即開啟。
在「偏好設定」部分的「控制項名稱」欄位中，輸入新控制項的名稱。
選用：如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。
選擇「重新導向控制項」做為控制項類型。
按一下「繼續」，前往「觸發條件」部分。
建立至少一個查詢字詞或時間範圍觸發條件。如要使用重新導向控制項，至少須提供一個觸發條件：
選取會觸發這項控管機制的行為類型：
- 瀏覽類別：當使用者瀏覽網站上的類別時，就會觸發規則 (search.request.query 為空白)。
- 搜尋：使用者在網站上搜尋時會觸發規則 (search.request.query 不為空白)。
根據瀏覽的類別或搜尋的查詢設定控制條件，以觸發規則。可用選項取決於你選擇「瀏覽類別」或「搜尋」：
- 如果選擇「瀏覽類別」：在「類別」欄位中，輸入瀏覽時會觸發這項控制選項的類別。
- 如果選擇「搜尋」：按一下「新增查詢」按鈕，新增要篩選的查詢字詞 (例如 running shoes)，然後為每個字詞選取下列其中一個選項：
  - 部分比對：如果查詢部分比對這個查詢字詞，就會套用這項控制項。
  - 完全比對：只有在查詢完全比對這個查詢字詞時，這項控制項才會生效。
  查詢中包含這些字詞時，系統就會套用控管措施。
注意： 如果除了這項條件外，您還指定了時間範圍條件，則只有在同時符合這兩項條件時，系統才會套用控制項。
按一下「新增時間範圍」按鈕，即可新增一或多個時間範圍，並套用這項控制選項。

注意： 如果除了這個時間範圍條件外，您還指定了類別或查詢字詞條件，則只有在同時符合這兩個條件時，系統才會套用控制選項。
按一下「繼續」，前往「動作」部分。
輸入觸發這項控制項時要重新導向的 URI。
按一下「繼續」，前往「放送設定」部分。
選取要套用控管的供應設定。
提交控制項設定。

新建立或更新的控制項需要幾分鐘才能準備好放送即時流量。您可以在控制台的「評估」頁面，測試變更是否已套用。

您可以在「控制項」頁面的「供應控制項」分頁中，找到新的控制項。

curl

提出 Control.create 要求，並在要求主體中包含控制項 ID 和 Control 的例項。

如需欄位詳細資料，請參閱 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": {
                  "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"

以下範例顯示搜尋觸發控制項的欄位，其中 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"
                    }
                  ]
                },
                "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 參考資料。
如需這個方法的範例，請參閱「管理放送設定」。

建立雙向同義詞控制項

如要進一步瞭解這類控制項，請參閱「雙向同義詞控制項」。

商品企劃主控台

按一下管理員提供的網址。 (登入)。

系統會將你導向商品目錄控制台的「控制項」頁面。
按一下「建立控制項」。
定義目標使用者和所需時間。請務必回答所有問題。點選「下一步」。
選取控制項。輸入控制選項的名稱，選取「搜尋」產品，然後選擇「同義字」控制選項類型。
設定「雙向同義詞」控制項：
1. 在「觸發條件」下方，為相關搜尋查詢提供條件 (例如「包含」或「不在範圍內」)，定義觸發這項控制項的目錄屬性。如未設定任何目錄屬性，系統一律會套用這項控管機制。
2. 輸入「日期範圍」，定義「適用時間範圍」。如果符合任何指定的時間範圍，目錄屬性就會在任何指定的時間範圍內與查詢相符。使用「新增時間範圍」新增時間範圍。
3. 定義要透過這個控制項觸發的同義字類型。選取「雙向」。如要進一步瞭解同義字類型，請參閱「同義字」一節。
按一下「提交」。系統會將您帶往詳細的「雙向同義字」設定畫面。
在「雙向同義字動作」下方的欄位中輸入同義字。這項動作會將字詞雙向連結在一起，以便在搜尋結果中視為相同字詞，因此「紅色沙發」查詢會產生「紅色紫紅沙發」結果，但「紫紅沙發」查詢會擴大範圍，納入所有類型的紅色沙發，例如深紅色或粉紅色。
再次提交，將控制權要求傳送給核准者。你可以在 Merchandising Console 中查看已提交要求的狀態。如果改變心意，可以刪除控制權要求。

核准者步驟

在「供應設定」下方，將控制項指派給現有的供應設定。
核准「雙向同義詞」控制項的要求。

Cloud 控制台

前往 Search for commerce 控制台的「Controls」頁面。

前往「Controls」(控制項) 頁面
在「供應控制項」分頁中，按一下「建立控制項」。
在「Control name」(控制項名稱) 欄位中，輸入新控制項的名稱。

「建立控制項」窗格隨即開啟。
系統會將你帶往「偏好設定」部分。
選用：如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。
選擇「雙向同義詞控制項」做為控制項類型。
按一下「繼續」，前往「觸發條件」部分。
選用：按一下「新增時間範圍」按鈕，新增一或多個可套用這項控制項的時間範圍。
按一下「繼續」，前往「動作」部分。
在「同義詞」欄位中，輸入 2 到 100 個查詢字詞 (例如 shirt 和 top)，這些字詞應互為同義詞。

如果查詢中包含其中任何一個字詞，搜尋功能會將其他查詢字詞視為所含字詞的同義詞。
按一下「繼續」，前往「放送設定」部分。
選取要套用控管的供應設定。
提交控制項設定。

新建立或更新的控制項需要幾分鐘才能準備好放送即時流量。您可以在控制台的「評估」頁面，測試變更是否已套用。

您可以在「控制項」頁面的「供應控制項」分頁中，找到新的控制項。

curl

提出 Control.create 要求，並在要求主體中包含控制項 ID 和 Control 的例項。

如需欄位詳細資料，請參閱 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 方法。請參閱「在供應設定中內嵌加入控制項」。

建立單向同義詞控制項

如要進一步瞭解這類控制項，請參閱「單向同義字控制項」。

商品企劃主控台

按一下管理員提供的網址。 (登入)。

系統會將你導向商品目錄控制台的「控制項」頁面。
按一下「建立控制項」。
定義目標使用者和所需時間。請務必回答所有問題。點選「下一步」。
選取控制項。輸入控制選項的名稱，選取「搜尋」產品，然後選擇「同義字」控制選項類型。
設定單向同義詞控制項：
1. 在「觸發條件」下方，為相關搜尋查詢提供條件 (例如「包含」或「不在範圍內」)，定義觸發這項控制項的目錄屬性。如未設定任何目錄屬性，系統一律會套用這項控管機制。
2. 輸入「日期範圍」，定義「適用時間範圍」。如果符合任何指定的時間範圍，目錄屬性就會在任何指定的時間範圍內與查詢相符。使用「新增時間範圍」新增時間範圍。
3. 定義要透過這個控制項觸發的同義字類型。選取「單向」。如要進一步瞭解同義字類型，請參閱「同義字」一節。
按一下「提交」。系統會將您帶往詳細的「單向同義字」設定畫面。
在「單向同義字動作」下方的欄位中輸入同義字。這項動作會單向連結字詞，以便在搜尋結果中視為相同字詞，因此「紅色沙發」查詢會包含「深紅色沙發」，但「深紅色沙發」查詢不會傳回其他類型的紅色沙發，只會傳回深紅色沙發。
再次按一下「提交」，將控制權要求傳送給核准者。你可以在 Merchandising Console 中查看已提交要求的狀態。如果改變心意，可以刪除控制權要求。

核准者步驟

在「供應設定」下方，將控制項指派給現有的供應設定。
核准「單向同義詞」控制項的要求。

Cloud 控制台

前往 Search for commerce 控制台的「Controls」頁面。

前往「Controls」(控制項) 頁面
在「供應控制項」分頁中，按一下「建立控制項」。

「建立控制項」窗格隨即開啟。
在「偏好設定」部分的「控制項名稱」欄位中，輸入新控制項的名稱。
選用：如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。
選擇「單向同義字控制」做為控制項類型。
按一下「繼續」，前往「觸發條件」部分。
選用：按一下「新增時間範圍」按鈕，新增一或多個可套用這項控制項的時間範圍。
按一下「繼續」，前往「動作」部分。
在「查詢字詞」欄位中輸入字詞 (例如 shoes)，當查詢中包含這些字詞時，系統應會一併顯示同義詞。
在「同義詞」欄位中，輸入應做為指定查詢字詞同義詞的字詞 (例如 shoes 的單向同義詞 sneakers 和 sandals)。
按一下「繼續」，前往「放送設定」部分。
選取要套用控管的供應設定。
提交控制項設定。

新建立或更新的控制項需要幾分鐘才能準備好放送即時流量。您可以在控制台的「評估」頁面，測試變更是否已套用。

您可以在「控制項」頁面的「供應控制項」分頁中，找到新的控制項。

curl

提出 Control.create 要求，並在要求主體中包含控制項 ID 和 Control 的例項。

如需欄位詳細資料，請參閱 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 參考資料。
如需這個方法的範例，請參閱「管理放送設定」。

建立「請勿建立關聯」控制項

如要進一步瞭解這類控制項，請參閱「請勿建立關聯控制項」。

商品企劃主控台

按一下管理員提供的網址。 (登入)。

系統會將你導向商品目錄控制台的「控制項」頁面。
按一下「建立控制項」。
定義目標使用者和所需時間。請務必回答所有問題。點選「下一步」。
選取控制項。輸入控制選項名稱，選取「搜尋」產品，然後選擇「不建立關聯」控制選項類型。
設定「Do-not-associate」控制項：
1. 在「觸發條件」下方，為相關搜尋查詢提供條件 (例如「包含」或「不在範圍內」)，定義觸發這項控制項的目錄屬性。如未設定任何目錄屬性，系統一律會套用這項控管機制。
2. 輸入「日期範圍」，定義「適用時間範圍」。如果符合任何指定的時間範圍，目錄屬性就會在任何指定的時間範圍內與查詢相符。使用「新增時間範圍」新增時間範圍。
3. 在「不要建立關聯的動作」下方，指定不應與您在先前「觸發條件」部分輸入的查詢字詞建立關聯的字詞。分別輸入查詢字詞和已取消關聯的字詞欄位。
按一下「提交」，將控制權要求傳送給核准者。你可以在 Merchandising Console 中查看已提交要求的狀態。如果改變心意，可以刪除控制權要求。

核准者步驟

在「供應設定」下方，將控制項指派給現有的供應設定。
核准「請勿建立關聯」控制項的要求。

Cloud 控制台

前往 Search for commerce 控制台的「Controls」頁面。

前往「Controls」(控制項) 頁面
在「供應控制項」分頁中，按一下「建立控制項」。

「建立控制項」窗格隨即開啟。
在「偏好設定」部分的「控制項名稱」欄位中，輸入新控制項的名稱。
選用：如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。
選擇「不建立控制項關聯」做為控制項類型。
按一下「繼續」，前往「觸發條件」部分。
選用：按一下「新增時間範圍」按鈕，新增一或多個可套用這項控制項的時間範圍。
按一下「繼續」，前往「動作」部分。
在「查詢字詞」欄位中，輸入要明確與其他字詞區別的字詞 (例如 gShoe)。
在「已取消關聯的字詞」欄位中，輸入要從搜尋結果中取消關聯的字詞，這些搜尋結果包含您指定的查詢字詞。

舉例來說，您可以將查詢字詞 gShoe 與字詞 cheap 取消關聯。
按一下「繼續」，前往「放送設定」部分。
選取要套用控管的供應設定。
提交控制項設定。

新建立或更新的控制項需要幾分鐘才能準備好放送即時流量。您可以在控制台的「評估」頁面，測試變更是否已套用。

您可以在「控制項」頁面的「供應控制項」分頁中，找到新的控制項。

curl

提出 Control.create 要求，並在要求主體中包含控制項 ID 和 Control 的例項。

如需欄位詳細資料，請參閱 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 參考資料。
如需這個方法的範例，請參閱「管理放送設定」。

建立忽略控制項

如要進一步瞭解這類控制項，請參閱「忽略控制項」。

商品企劃主控台

按一下管理員提供的網址。 (登入)。

系統會將你導向商品目錄控制台的「控制項」頁面。
按一下「建立控制項」。
定義目標使用者和所需時間。請務必回答所有問題。點選「下一步」。
選取控制項。輸入控制選項名稱，選取「搜尋」產品，然後選擇「忽略」控制選項類型。
設定「忽略」控制項：
1. 在「觸發條件」下方，為相關搜尋查詢提供條件 (例如「包含」或「不在範圍內」)，定義觸發這項控制項的目錄屬性。如未設定任何目錄屬性，系統一律會套用這項控管機制。
2. 輸入「日期範圍」，定義「適用時間範圍」。如果符合任何指定的時間範圍，目錄屬性就會在任何指定的時間範圍內與查詢相符。使用「新增時間範圍」新增時間範圍。
3. 在「忽略動作」下方輸入要忽略的字詞。
按一下「提交」，將控制權要求提交給核准者。你可以在 Merchandising Console 中查看已提交要求的狀態。如果改變心意，可以刪除控制權要求。

核准者步驟

在「供應設定」下方，將控制項指派給現有的供應設定。
核准「忽略」控制項的要求。

Cloud 控制台

前往 Search for commerce 控制台的「Controls」頁面。

前往「Controls」(控制項) 頁面
在「供應控制項」分頁中，按一下「建立控制項」。

「建立控制項」窗格隨即開啟。
在「偏好設定」部分的「控制項名稱」欄位中，輸入新控制項的名稱。
選用：如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。
選擇「不建立控制項關聯」做為控制項類型。
按一下「繼續」，前往「觸發條件」部分。
選用：按一下「新增時間範圍」按鈕，新增一或多個可套用這項控制項的時間範圍。
按一下「繼續」，前往「動作」部分。
在「忽略的字詞」欄位中，輸入您希望搜尋功能忽略的字詞 (例如 shoddy)，這些字詞會以查詢字詞的形式輸入。
按一下「繼續」，前往「放送設定」部分。
選取要套用控管的供應設定。
提交控制項設定。

新建立或更新的控制項需要幾分鐘才能準備好放送即時流量。您可以在控制台的「評估」頁面，測試變更是否已套用。

您可以在「控制項」頁面的「供應控制項」分頁中，找到新的控制項。

curl

提出 Control.create 要求，並在要求主體中包含控制項 ID 和 Control 的例項。

如需欄位詳細資料，請參閱 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 參考資料。
如需這個方法的範例，請參閱「管理放送設定」。

建立替代控制項

如要進一步瞭解這類控制項，請參閱「替代控制項」。

商品企劃主控台

按一下管理員提供的網址。 (登入)。

系統會將你導向商品目錄控制台的「控制項」頁面。
按一下「建立控制項」。
定義目標使用者和所需時間。請務必回答所有問題。點選「下一步」。
選取控制項。輸入控制選項名稱，選取「搜尋」產品，然後選擇「替代」控制選項類型。
設定「Replacement」(更換) 控制項：
1. 在「觸發條件」下方，為相關搜尋查詢提供條件 (例如「包含」或「不在範圍內」)，定義觸發這項控制項的目錄屬性。如未設定任何目錄屬性，系統一律會套用這項控管機制。
2. 輸入「日期範圍」，定義「適用時間範圍」。如果符合任何指定的時間範圍，目錄屬性就會在任何指定的時間範圍內與查詢相符。使用「新增時間範圍」新增時間範圍。
3. 在「取代動作」下方，於第一個欄位中定義要取代的查詢字詞，並在第二個欄位中輸入替代字詞。
按一下「提交」，將控制權要求傳送給核准者。你可以在 Merchandising Console 中查看已提交要求的狀態。如果改變心意，可以刪除控制權要求。

核准者步驟

在「供應設定」下方，將控制項指派給現有的供應設定。
核准「取代」控制項的要求。

Cloud 控制台

前往 Search for commerce 控制台的「Controls」頁面。

前往「Controls」(控制項) 頁面
在「供應控制項」分頁中，按一下「建立控制項」。

「建立控制項」窗格隨即開啟。
在「偏好設定」部分的「控制項名稱」欄位中，輸入新控制項的名稱。
選用：如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。
選擇「替代控制項」做為控制項類型。
按一下「繼續」，前往「觸發條件」部分。
選用：按一下「新增時間範圍」按鈕，新增一或多個可套用這項控制項的時間範圍。
按一下「繼續」，前往「動作」部分。
在「查詢字詞」欄位中，輸入要以取代字詞取代的查詢字詞 (例如 gShoe)。
在「替換字詞」欄位中，輸入要取代指定查詢字詞的字詞。

舉例來說，您可以將查詢字詞 gShoe 替換為替代字詞 Google Shoe。
按一下「繼續」，前往「放送設定」部分。
選取要套用控管的供應設定。
提交控制項設定。

新建立或更新的控制項需要幾分鐘才能準備好放送即時流量。您可以在控制台的「評估」頁面，測試變更是否已套用。

您可以在「控制項」頁面的「供應控制項」分頁中，找到新的控制項。

curl

提出 Control.create 要求，並在要求主體中包含控制項 ID 和 Control 的例項。

如需欄位詳細資料，請參閱 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 參考資料。
如需這個方法的範例，請參閱「管理放送設定」。

建立釘選控制項

如要建立釘選控制項：

商品企劃主控台

按一下管理員提供的網址。 (登入)。

系統會將你導向商品目錄控制台的「控制項」頁面。
按一下「建立控制項」。
定義目標使用者和所需時間。請務必回答所有問題。點選「下一步」。
選取控制項。輸入控制選項名稱，選取「搜尋」產品，然後選擇「置頂」控制選項類型。
設定「釘選」控制項：
1. 在「觸發條件」下方，為相關搜尋查詢提供條件 (例如「包含」或「不在範圍內」)，定義觸發這項控制項的目錄屬性。如未設定任何目錄屬性，系統一律會套用這項控管機制。
2. 輸入「日期範圍」，定義「適用時間範圍」。如果符合任何指定的時間範圍，目錄屬性就會在任何指定的時間範圍內與查詢相符。使用「新增時間範圍」新增時間範圍。
3. 定義要透過這個控制項觸發的釘選動作。這些動作是由「產品 ID」和圖釘位置定義，最好是小於 120 的數字 (一般頁面大小)。按一下「新增產品」，最多可新增 10 個。
按一下「提交」，將控制權要求提交給核准者。你可以在 Merchandising Console 中查看已提交要求的狀態。如果改變心意，可以刪除控制權要求。

核准者步驟

在「供應設定」下方，將控制項指派給現有的供應設定。
核准「釘選」控制項的要求。

Cloud 控制台

前往 Search for commerce 控制台的「Controls」頁面。

前往「Controls」(控制項) 頁面
在「供應控制項」分頁中，按一下「建立控制項」。

「建立控制項」窗格隨即開啟。
在「偏好設定」部分的「控制項名稱」欄位中，輸入新控制項的名稱。
選用步驟：如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。
在「產品選取」部分，選取「搜尋或瀏覽」。
選擇「釘選控制項」做為控制項類型。點選「繼續」。
在「觸發條件」部分中，選擇會觸發這項控管措施的使用者行為：
- 瀏覽類別：瀏覽要求必須填入 page_categories 欄位，且 search.request.query 必須為空白。
- 搜尋：搜尋要求只需要填入 search.request.query。
  
  根據預設，瀏覽的所有類別和搜尋的查詢都會觸發這項控制選項。
選用：設定條件，根據瀏覽的特定類別或搜尋的查詢觸發規則：
- 瀏覽類別：在「類別」欄位中，輸入會觸發控制項的類別。
- 搜尋：如要新增要篩選的查詢字詞 (例如 running shoes)，請按一下「新增查詢」。為每個字詞選擇「部分比對」或「完整比對」。
選用：按一下「新增時間範圍」或「新增日期範圍」，新增一或多個可套用這項控制項的時間範圍。

注意： 如果您指定類別或查詢字詞，並加上時間或日期範圍條件，只有在兩種條件都符合時，系統才會套用控管設定。
按一下「繼續」，前往「動作」部分。如要固定產品位置，請使用滑桿指定產品要固定的位置。圖釘值滑桿不接受 0、負數或非整數值。

Vertex AI Search 電子商務套件允許在任何單一控制項的釘選地圖中釘選 10 個位置。位置可以是 1 到 120 之間的任何值 (要求網頁大小上限)。

注意： 如果位置大於要求頁面大小，系統不會將圖釘釘選至第二頁。舉例來說，如果搜尋查詢要求的網頁大小為 50，但您已將圖釘設在第 75 頁，搜尋結果就會忽略該項目。
按一下「繼續」，前往「放送設定」部分。選取要套用控制項的供應設定，然後提交控制項設定。

新建立或更新的控制項需要幾分鐘才能準備好放送即時流量。您可以在控制台的「評估」頁面，測試變更是否已套用。

您可以在「控制項」頁面的「供應控制項」分頁中，找到新的控制項。

curl

提出 Control.create 要求，並在要求主體中包含控制項 ID 和 Control 執行個體。

如需欄位詳細資料，請參閱 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 控制台

前往 Search for commerce 控制台的「評估」頁面。

前往「評估」頁面
前往「搜尋」分頁。
在搜尋查詢欄位中輸入測試查詢。
按一下「搜尋預覽」。
查看結果，確認所選產品已釘選。

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"

錯誤檢查的限制

檢查錯誤時，請注意下列限制：

兩個產品無法釘選在相同位置，也就是說，產品「a」和「b」無法同時佔據位置 #2。
反之，一個產品無法釘選至多個位置，也就是說，同一查詢的產品「a」無法同時釘選至位置 #2 和 #3。
假設沒有套用任何篩選器或排序方式，product_id 必須是目錄中的產品。

建立供應控制項 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

放送控制項和設定之間的關係

快速入門影片和指南

供應控制設定選項

使用 Google Cloud 控制台

使用 Merchandising 控制台

以管理員身分使用控制台

為 Merchandising 控制台使用者提供新手上路指南

以使用者身分存取控制台

以網站商品陳列人員身分使用控制台

控制項類型

建立提高/降低排名控制項

建立搜尋升降級控制項

商品企劃主控台

核准者步驟

Cloud 控制台

curl

建立推薦內容升降權重控制項

商品企劃主控台

核准者步驟

Cloud 控制台

curl

建立篩選器控制項

商品企劃主控台

核准者步驟

Cloud 控制台

curl

建立重新導向控制項

商品企劃主控台

核准者步驟

Cloud 控制台

curl

建立雙向同義詞控制項

商品企劃主控台

核准者步驟

Cloud 控制台

curl

建立單向同義詞控制項

商品企劃主控台

核准者步驟

Cloud 控制台

curl

建立「請勿建立關聯」控制項

商品企劃主控台

核准者步驟

Cloud 控制台

curl

建立忽略控制項

商品企劃主控台

核准者步驟

Cloud 控制台

curl

建立替代控制項

商品企劃主控台

核准者步驟

Cloud 控制台

curl

建立釘選控制項

商品企劃主控台

核准者步驟

Cloud 控制台

curl

Cloud 控制台

curl

錯誤檢查的限制

建立供應控制項