建立供應控制項

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

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

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

服務控制項和設定之間的關係

供應設定與控制項之間具有多對多關係。您可以為供應設定新增多個控制項，且單一控制項可與多個供應設定相關聯。

建立供應控制項和供應設定時，請選取可用於控制項的產品 (推薦內容或搜尋)。

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

供應設定可管理在搜尋或預測要求期間套用的控制項。系統只會在放送時間考量要求的有效供應設定中的控制項。舉例來說，假設您已建立兩個控制項：一個名為「gShoe Sale」的控制項，可在搜尋「shoes」時提升品牌 gShoe 的搜尋結果；另一個名為「More shoes」的控制項，可將使用「running shoes」一詞的查詢擴展至「sport shoes」。如果您只將 gShoe Sale 控制項附加至放送設定，那麼使用該放送設定的搜尋要求會針對使用字詞「shoes」的查詢提升 gShoe 結果，但「More shoes」控制項不會生效，因為它並未附加至您使用的放送設定。

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

快速入門影片和指南

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

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

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

逐步引導

  • 語言：自訂搜尋查詢語言。僅適用於搜尋。
    可使用多種語言控制選項：
    • 同義詞：擴大搜尋查詢的可能同義詞。
    • 單向同義詞：針對特定字詞，單向展開已視為同義詞的字詞。
    • 不要建立關聯：當特定字詞出現時，避免一組字詞在搜尋中使用。
    • 忽略：防止特定字詞在搜尋中使用。
    • 替換：取代搜尋查詢中的字詞。
  • 固定：影響搜尋結果排序，將搜尋結果置於特定位置，例如第 4 個位置。可用於搜尋和瀏覽。

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

供應控制項設定選項

您可以建立控制項，然後將其加入或交換至即時放送設定。

您最多可以建立 100 個放送控管條件。如果需要更多刊登控制項，請申請額外配額。如要瞭解如何申請額外配額，請參閱「提高配額」。供應設定最多可包含 100 個任何類型的供應控制項 (除了重新導向控制項，每個供應設定的重新導向控制項上限為 1000 個)。

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

  • Google Cloud 控制台的「Controls」頁面：您可以選擇在供應設定建立程序中建立控制項。

  • 你可以使用推銷控制台。

  • 您可以使用 Controls.create 方法，在內文中建立刊登控制項。

使用 Google Cloud 主控台

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

  1. 前往「Search for Commerce」控制台的「Controls」頁面。

    前往「控制」頁面

  2. 請按照 Google Cloud 「各個服務控制部分」下方的控制台步驟操作。

使用 Merchandising 控制台

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

行銷控制台可協助建立放送控制項，例如固定、提升/埋藏、同義字和面向。商品目錄主控台提供簡單易用的介面，方便商品目錄管理員有效建立及管理控制項。這項工具也能簡化核准程序，讓任何商品銷售者都能提出控管措施，而商品銷售者核准者則可審查這些措施。

在 Google Cloud中，如要存取「Merchandising 主控台」分頁，您至少必須具備下列權限：

  • 專案檢視者 (檢視者)：存取專案。
  • Retail 編輯器：編輯並儲存 Merchandising 控制台設定。

以管理員身分使用控制台

Google Cloud 您必須先是管理員，才能開始將使用者導入 Merchandising 資訊主頁。

接著，請前往 Google Cloud 控制台的「Merchandising 控制台」分頁，初始化 Merchandising 控制台：

「Merchandising」主控台分頁
Merchandising 主控台分頁

你必須具備下列 IAM 角色，才能存取、編輯，以及將「創作者」或「核准者」角色指派給商品化服務主控台使用者：

  • 如要編輯行銷資訊主頁，至少必須具備零售編輯者角色。
  • 如要將建立者或核准者角色指派給使用者，您必須具備專案層級 IAM 管理員角色。

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

培訓 Merchandising 主控台使用者

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

  1. 前往「Search for Commerce」控制台的「Controls」頁面。

    前往「控制」頁面
  2. 前往「Merchandising console」分頁。
  3. 您可以看到與目前 Google Cloud 專案相關聯的 Merchandising 控制台專屬網址。複製連結，或直接在 Google Cloud 控制台中開啟連結。
  4. 選取默認供應設定，供商品經銷商預覽及附加已核准的控制項。
  5. 將審核者或創作者角色指派給使用者。
  6. 您可以看到與目前 Google Cloud 專案相關聯的 Merchandising 控制台專屬網址。複製連結或直接在 Google Cloud 主控台中開啟連結。
  7. 在行銷主控台中，選取預覽的預設供應設定。
  8. (選用) 使用下列函式編輯 Merchandising 控制台的存取權：
    • 新增使用者：將核准者或創作者的存取權授予授權管理控制台。
    • 刪除使用者：刪除核准者或創作者，撤銷對商品化控制台的存取權。
  9. 新增核准者的電子郵件地址。對於商品經理提交的每個控制項，核准者電子郵件清單都會收到電子郵件，要求審查並核准該控制項。

以使用者身分存取控制台

如果您已獲得網址的存取權，可以選擇使用商品目錄主控台，而非標準 Google Cloud 主控台。 如何使用 Merchandising 控制台建立控管機制：

  1. 使用管理員提供的憑證登入。
  2. 請按照「各個刊登控制項部分」下方的行銷管理控制台說明文件步驟操作。
  3. 提交後，您會收到一封通知電子郵件，主旨為「[Merchant Console] 待審查的建議控制項」。
  4. 核准者可以接受、拒絕或變更控制項要求。

以網站商品經理身分使用控制台

請按照下列步驟，在 Merchandising 主控台中開始使用網站商品目錄。

  1. 設定問題的核准流程。
    1. 前往主選單的 「設定」部分。
    2. 根據預設，系統會在「Define the goal」畫面中設定預先定義的問題清單。
      3. 商品企劃主控台相關問題
      Merchandising 資訊主頁常見問題
    3. 按一下「新增問題」圖示 新增問題，協助核准者瞭解新控制項的用途。
    4. 按一下「儲存」即可儲存問題。
  2. 建立控制項。
    1. 前往「控制項」部分。
    2. 按一下「建立控制項」。
    3. 定義目標：您必須回答先前定義的所有問題。如果您尚未定義任何問題，系統就不會顯示這個畫面。
    4. 選取控制項。指定控制項類型，並為控制項指派名稱。
    5. 設定規則：您可以為每項規則定義觸發條件和動作。
    6. 定義觸發條件：目的是建立套用此控制項的時機。
      • 搜尋字詞：當搜尋查詢包含或完全符合特定字詞時，系統就會觸發這項規則。您可以定義這些查詢字詞。
      • 適用的時間範圍：您可以套用時間限制，將這項規則的啟用時間限制在特定時間範圍內。
      定義觸發條件
      定義觸發條件
    7. 定義動作：視控制項類型而定，您可以定義動作，例如釘選控制項的商品 ID 和位置。
    8. 預覽規則：畫面上會顯示規則的動態預覽畫面。
    9. 提交規則：點選「提交」後，系統會提交商品經理設定的規則，你會在控制項清單中看到「待處理」。
  3. 核准控制項
    1. 如要核准控制項，請在控制項清單中，按一下控制項旁的 「更多」圖示。選取「查看」。
    2. 系統會為指定的控制項提供畫面，讓您選擇「核准」、「拒絕」或「核准並修改」。
    3. 核准後，系統會將您重新導向至控制項清單頁面，並將控制項標示為「已核准」。
      商品陳列控管階段
      商品企劃資訊主頁階段

控制項類型

控制項的規定會因類型而異。請參閱您要建立的控制項類型的建立程序：

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

這個控制項類型適用於搜尋和推薦內容。

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

如要建立搜尋廣告加強/埋藏控制項，請按照下列步驟操作：

商品企劃主控台

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

    這會將你導向行銷控制台中的「控制項」頁面。

  2. 按一下「建立控制項」。

  3. 定義目標和必要的時間。請務必回答所有問題。點按「Next」。

  4. 選取控制項。輸入控制項名稱，選取「Search」產品，然後選擇「Boost/Bury」控制項類型。

  5. 設定「提高/降低排名」控制項：

    1. 在「觸發條件」下方，定義哪些目錄屬性會觸發此控制項，方法是為相關搜尋查詢提供條件，例如「包含」或「不在範圍內」。如果未設定目錄屬性，系統一律會套用這項控制項。

    2. 輸入日期範圍，定義適用時間範圍。如果符合任何指定的時間範圍，系統會在這段時間範圍內將目錄屬性與查詢相符。使用 「新增時間範圍」新增時間範圍。

    3. 定義要透過這個控制項觸發的提升/埋沒動作。這些動作是由目錄屬性 (例如「顏色」)、評估標準 (例如「包含」) 和值 (例如「紅色」) 定義。

    4. 按一下「新增屬性」，即可新增更多屬性。

  6. 使用滑桿設定提升/埋藏值。負數代表埋葬，正數代表提升。

  7. 按一下「提交」，將控制項要求提交給核准者。你可以在 Merchandising 主控台中查看提交要求的狀態。如果改變心意，可以刪除控制要求。

Cloud 控制台

  1. 前往「Search for Commerce」控制台的「Controls」頁面。

    前往「控制」頁面

  2. 在「Serving controls」分頁下方，按一下 「Create control」。

    「Create control」窗格隨即開啟。

  3. 在「偏好設定」部分的「控制項名稱」欄位中，輸入新控制項的名稱。

  4. 選用步驟：如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。

  5. 在「產品選項」部分中，選取「搜尋」。

  6. 選擇「提高/降低排名控制項」做為控制項類型。按一下「繼續」

  7. 在「觸發條件」部分中，選取觸發此控制項的使用者行為類型。

    • 瀏覽類別：當使用者在您的網站上瀏覽類別時，系統就會觸發這項規則 (search.request.query 為空白)。

    • 搜尋：當使用者在您的網站上搜尋 (search.request.query 不為空白) 時，系統就會觸發此規則。如要設定這個控制項，讓系統在瀏覽任何類別或搜尋任何查詢時觸發，請略過下列步驟。

  8. 選用：根據瀏覽特定類別或搜尋特定查詢，設定可觸發此控制項的特定類別或查詢。

    • 如果您選擇「瀏覽類別」：請在「類別」欄位中，輸入瀏覽時會觸發此控制項的類別。

    • 如果您選擇「搜尋」：請按一下「新增查詢」按鈕，新增要篩選的查詢字詞 (例如 running shoes)。針對每個字詞，選擇「部分比對」或「完全比對」。

  9. 選用：按一下「新增時間範圍」按鈕，新增一或多個可套用此控制項的時間範圍。

  10. 按一下「Continue」，前往「Actions」部分。

  11. 在「提升/埋沒產品」欄位中新增產品屬性篩選器。

    請使用「篩選和排序」一節所述的篩選運算式語法。例如，如要指定「product1」和「product2」的紅色和藍色版本：(id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

  12. 如要設定「Boost/bury value」，請使用滑桿設定加強的強度。正值會提升結果，負值則會將結果隱藏。按一下「繼續」。

  13. 在「供應設定」部分中，選取要套用控制項的供應設定。

  14. 提交控制項設定。

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

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

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 方法：

建立推薦內容提高/降低排名控制項

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

商品企劃主控台

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

    這會將你導向行銷控制台中的「控制項」頁面。

  2. 按一下「建立控制項」。

  3. 定義目標和必要的時間。請務必回答所有問題。點按「Next」。

  4. 選取控制項。輸入控制項的名稱，選取「瀏覽」產品，然後選擇「提升/埋藏」控制類型。

  5. 設定「提高/降低排名」控制項：

    1. 在「觸發條件」下方，輸入要觸發控制項的網頁類別。如未設定目錄屬性，則此控管機制一律會處於有效狀態。

    2. 輸入日期範圍，定義適用時間範圍。如果符合任何指定的時間範圍，系統會在這段時間範圍內將目錄屬性與查詢相符。使用 「新增時間範圍」新增時間範圍。

    3. 定義要透過這個控制項觸發的提升/埋沒動作。這些動作是由目錄屬性 (例如「顏色」)、評估標準 (例如「包含」) 和值 (例如「紅色」) 定義。

    4. 按一下「新增屬性」，即可新增更多屬性。

  6. 使用滑桿設定提升/埋藏值。負數代表埋沒，正數代表提升。

  7. 按一下「提交」，將控制項要求提交給核准者。你可以在 Merchandising 主控台中查看提交要求的狀態。如果改變心意，可以刪除控制要求。

Cloud 控制台

  1. 前往「Search for Commerce」控制台的「Controls」頁面。

    前往「控制」頁面

  2. 在「Serving controls」(供應控制項) 分頁中，按一下 「Create control」(建立控制項)。

    「Create control」窗格隨即開啟。

  3. 在「偏好設定」部分的「控制項名稱」欄位中，輸入新控制項的名稱。

  4. (選用) 如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。

  5. 在「產品選項」部分中，選取「推薦」。

  6. 選擇「提高/降低排名控制項」做為控制項類型。

  7. 按一下「Continue」，前往「Actions」部分。

  8. 在「提升/埋沒產品」欄位中新增產品屬性篩選器。

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

    例如，如要指定「product1」和「product2」的紅色和藍色版本： (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

  9. 如要設定「Boost/bury value」，請使用滑桿設定加強的強度。正值會提升結果，負值則會將結果隱藏。

  10. 按一下「Continue」，前往「Serving configs」部分。

  11. 選取要套用控制項的供應設定。

  12. 提交控制項設定。

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

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

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 方法：

建立篩選器控制項

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

商品企劃主控台

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

    這會將你導向行銷控制台中的「控制項」頁面。

  2. 按一下「建立控制項」。

  3. 定義目標和必要的時間。請務必回答所有問題。點按「Next」。

  4. 選取控制項。輸入控制項名稱、選取「搜尋」或「瀏覽」產品，然後選擇「篩選器」控制項類型。

  5. 設定「Filter」控制項：

    1. 在「觸發條件」下方，為相關搜尋查詢或網頁類別指定條件，定義觸發這項控管機制的目錄屬性，例如「包含」或「不在範圍內」。如果未設定目錄屬性，系統一律會套用這項控制項。

    2. 輸入日期範圍，定義適用時間範圍。如果符合任何指定的時間範圍，系統會在這段時間範圍內將目錄屬性與查詢相符。使用 「新增時間範圍」新增時間範圍。

    3. 定義要透過這個控制項觸發的篩選動作。這些動作是由目錄屬性 (例如「顏色」)、評估標準 (例如「包含」) 和值 (例如「紅色」) 定義。

    4. 按一下「新增屬性」，即可新增更多屬性。

  6. 按一下「提交」，將控制項要求提交給核准者。你可以在 Merchandising 主控台中查看提交要求的狀態。如果改變心意，可以刪除控制要求。

Cloud 控制台

  1. 前往「Search for Commerce」控制台的「Controls」頁面。

    前往「控制」頁面

  2. 在「Serving controls」(供應控制項) 分頁中，按一下 「Create control」(建立控制項)。

    「Create control」窗格隨即開啟。

  3. 在「偏好設定」部分的「控制項名稱」欄位中，輸入新控制項的名稱。

  4. 選用步驟：如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。

  5. 選擇「篩選器控制項」做為控制項類型。

  6. 按一下「繼續」即可前往「觸發條件」部分。

  7. 選取會觸發這項控管機制的使用者行為類型：

    • 瀏覽類別：當使用者在您的網站上瀏覽類別時，系統就會觸發這項規則 (search.request.query 為空白)。

    • 搜尋：當使用者在您的網站上搜尋 (search.request.query 不為空白) 時，系統就會觸發此規則。

  8. 選用：設定控制條件，根據瀏覽的類別或搜尋的查詢字詞觸發規則。可用的選項取決於您選擇「瀏覽類別」或「搜尋」：

    • 如果您選擇「瀏覽類別」：請在「類別」欄位中，輸入瀏覽時會觸發此控制項的類別。

    • 如果您選擇「搜尋」：請按一下「新增查詢」按鈕，新增要篩選的查詢字詞 (例如 running shoes)，然後為每個字詞選取下列其中一個選項：

      • 部分比對：如果查詢包含與此查詢字詞部分比對的字詞，就會套用這項控制項。
      • 完全比對：只有在查詢包含與此查詢字詞完全比對的情況下，才會套用這項控制項。

      當查詢中包含其中一個字詞時，系統就會套用控制項。

  9. 選用：按一下「新增時間範圍」按鈕，新增一或多個可套用此控制項的時間範圍。

  10. 按一下「Continue」，前往「Actions」部分。

  11. 在「Filter action」欄位中新增產品屬性篩選器。

    請使用「篩選和排序」一節所述的篩選運算式語法。

    例如，如要指定「product1」和「product2」的紅色和藍色版本： (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

  12. 按一下「Continue」，前往「Serving configs」部分。

  13. 選取要套用控制項的供應設定。

  14. 提交控制項設定。

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

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

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 方法：

建立重新導向控制項

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

商品企劃主控台

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

    這會將你導向行銷控制台中的「控制項」頁面。

  2. 按一下「建立控制項」。

  3. 定義目標和必要的時間。請務必回答所有問題。點按「Next」。

  4. 選取控制項。輸入控制項名稱，選取「搜尋」產品，然後選擇「重新導向」控制項類型。

  5. 設定重新導向控管機制：

    1. 在「觸發條件」下方，定義哪些目錄屬性會觸發此控制項，方法是為相關搜尋查詢提供條件，例如「包含」或「不在範圍內」。如果未設定目錄屬性，系統一律會套用這項控制項。

    2. 輸入日期範圍，定義適用時間範圍。如果符合任何指定的時間範圍，系統會在這段時間範圍內將目錄屬性與查詢相符。使用 「新增時間範圍」新增時間範圍。

    3. 輸入重新導向網址，定義要透過這個控制項觸發的重新導向動作。

  6. 按一下「提交」，將控制項要求提交給核准者。你可以在 Merchandising 主控台中查看提交要求的狀態。如果改變心意，可以刪除控制要求。

Cloud 控制台

  1. 前往「Search for Commerce」控制台的「Controls」頁面。

    前往「控制」頁面

  2. 在「Serving controls」(供應控制項) 分頁中，按一下 「Create control」(建立控制項)。

    「Create control」窗格隨即開啟。

  3. 在「偏好設定」部分的「控制項名稱」欄位中，輸入新控制項的名稱。

  4. 選用步驟：如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。

  5. 選擇「Redirect controls」做為控制項類型。

  6. 按一下「繼續」即可前往「觸發條件」部分。

  7. 請建立至少一個查詢字詞或時間範圍觸發條件。轉向控制項至少需要一個觸發條件：

  8. 選取會觸發這項控管機制的使用者行為類型：

    • 瀏覽類別：當使用者在您的網站上瀏覽類別時，系統就會觸發這項規則 (search.request.query 為空白)。

    • 搜尋：當使用者在您的網站上搜尋 (search.request.query 不為空白) 時，系統就會觸發此規則。

  9. 設定控制條件，根據瀏覽的類別或搜尋的查詢觸發規則。可用的選項取決於您選擇「瀏覽類別」或「搜尋」：

    • 如果您選擇「瀏覽類別」：請在「類別」欄位中，輸入瀏覽時會觸發此控制項的類別。

    • 如果您選擇「搜尋」：請按一下「新增查詢」按鈕，新增要篩選的查詢字詞 (例如 running shoes)，然後為每個字詞選取下列其中一個選項：

      • 部分比對：如果查詢包含與此查詢字詞部分比對的字詞，就會套用這項控制項。
      • 完全比對：只有在查詢包含與此查詢字詞完全比對的情況下，才會套用這項控制項。

      當查詢中包含其中一個字詞時，系統就會套用控制項。

  10. 按一下「新增時間範圍」按鈕，新增一或多個可套用這項控制項的時間範圍。

  11. 按一下「Continue」，前往「Actions」部分。

  12. 輸入觸發這項控制項時要重新導向的 URI。

  13. 按一下「Continue」，前往「Serving configs」部分。

  14. 選取要套用控制項的供應設定。

  15. 提交控制項設定。

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

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

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 方法：

建立雙向同義詞控制項

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

商品企劃主控台

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

    這會將你導向行銷控制台中的「控制項」頁面。

  2. 按一下「建立控制項」。

  3. 定義目標和必要的時間。請務必回答所有問題。點按「Next」。

  4. 選取控制項。輸入控制項名稱，選取「Search」產品，然後選擇「同義詞」控制項類型。

  5. 設定雙向同義詞控制項：

    1. 在「觸發條件」下方，定義哪些目錄屬性會觸發此控制項，方法是為相關搜尋查詢提供條件，例如「包含」或「不在範圍內」。如果未設定目錄屬性，系統一律會套用這項控制項。

    2. 輸入日期範圍，定義適用時間範圍。如果符合任何指定的時間範圍，系統會在這段時間範圍內將目錄屬性與查詢相符。使用 「新增時間範圍」新增時間範圍。

    3. 定義要透過這個控制項觸發的同義詞類型。選取「雙向」。如要進一步瞭解同義詞類型，請參閱「同義詞」一節。

  6. 按一下「提交」。系統會將您導向詳細的「雙向同義字」設定畫面。

  7. 在「雙向同義詞動作」下方的欄位中輸入同義詞。這個動作會以雙向方式連結字詞，以便在搜尋結果中以相同方式處理，因此「紅色沙發」查詢會顯示紅色沙發，但「紅棕色沙發」查詢會擴充為所有紅色沙發，例如深紅色或粉紅色。

  8. 再次按提交，將控制項要求傳送給核准者。你可以在 Merchandising 主控台中查看提交要求的狀態。如果改變心意，可以刪除控制要求。

Cloud 控制台

  1. 前往「Search for Commerce」控制台的「Controls」頁面。

    前往「控制」頁面

  2. 在「Serving controls」(供應控制項) 分頁中，按一下 「Create control」(建立控制項)。

  3. 在「Control name」欄位中，輸入新控制項的名稱。

    「Create control」窗格隨即開啟。

  4. 您會進入「偏好設定」部分。

  5. 選用步驟：如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。

  6. 選擇「雙向同義詞控制項」做為控制項類型。

  7. 按一下「繼續」即可前往「觸發條件」部分。

  8. 選用：按一下「新增時間範圍」按鈕，新增一或多個可套用此控制項的時間範圍。

  9. 按一下「Continue」，前往「Actions」部分。

  10. 在「同義詞」欄位中，輸入 2 到 100 個查詢字詞 (例如 shirt 和 top)，這些字詞應為彼此的同義詞。

    當查詢中包含任一上述字詞時，搜尋引擎會將其他查詢字詞視為所包含字詞的同義詞。

  11. 按一下「Continue」，前往「Serving configs」部分。

  12. 選取要套用控制項的供應設定。

  13. 提交控制項設定。

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

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

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. 定義目標和必要的時間。請務必回答所有問題。點按「Next」。

  4. 選取控制項。輸入控制項名稱，選取「Search」產品，然後選擇「同義詞」控制項類型。

  5. 設定單向同義詞控制項：

    1. 在「觸發條件」下方，定義哪些目錄屬性會觸發此控制項，方法是為相關搜尋查詢提供條件，例如「包含」或「不在範圍內」。如果未設定目錄屬性，系統一律會套用這項控制項。

    2. 輸入日期範圍，定義適用時間範圍。如果符合任何指定的時間範圍，系統會在這段時間範圍內將目錄屬性與查詢相符。使用 「新增時間範圍」新增時間範圍。

    3. 定義要透過這個控制項觸發的同義詞類型。選取「單程」。如要進一步瞭解同義詞類型，請參閱「同義詞」一節。

  6. 按一下「提交」。系統會帶您前往詳細的單向同義字設定畫面。

  7. 在「單向同義詞動作」下方的欄位中輸入同義詞。這個動作會將字詞以單向方式連結在一起，在搜尋結果中以相同方式處理，因此「紅色沙發」查詢會包含紅棕色沙發，但「紅棕色沙發」查詢不會傳回其他類型的紅色沙發，只會將結果限制在紅棕色沙發。

  8. 再次按一下「提交」，將控制項要求傳送給核准者。你可以在 Merchandising 主控台中查看提交要求的狀態。如果改變心意，可以刪除控制要求。

Cloud 控制台

  1. 前往「Search for Commerce」控制台的「Controls」頁面。

    前往「控制」頁面

  2. 在「Serving controls」(供應控制項) 分頁中，按一下 「Create control」(建立控制項)。

    「Create control」窗格隨即開啟。

  3. 在「偏好設定」部分的「控制項名稱」欄位中，輸入新控制項的名稱。

  4. 選用步驟：如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。

  5. 選擇「單向同義詞控制」做為控制類型。

  6. 按一下「繼續」即可前往「觸發條件」部分。

  7. 選用：按一下「新增時間範圍」按鈕，新增一或多個可套用此控制項的時間範圍。

  8. 按一下「Continue」，前往「Actions」部分。

  9. 在「查詢字詞」欄位中輸入字詞 (例如 shoes)，當查詢中包含任何這些字詞時，應與相關同義詞相關聯。

  10. 在「同義詞」欄位中，輸入應用於指定查詢字詞的同義詞 (例如，sneakers 和 sandals 是查詢字詞 shoes 的一方向同義詞)。

  11. 按一下「Continue」，前往「Serving configs」部分。

  12. 選取要套用控制項的供應設定。

  13. 提交控制項設定。

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

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

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 方法：

建立「不建立關聯」控制項

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

商品企劃主控台

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

    這會將你導向行銷控制台中的「控制項」頁面。

  2. 按一下「建立控制項」。

  3. 定義目標和必要的時間。請務必回答所有問題。點按「Next」。

  4. 選取控制項。輸入控制項名稱，選取「搜尋」產品，然後選擇「不關聯」控制項類型。

  5. 設定「不要建立關聯」控制項：

    1. 在「觸發條件」下方，定義哪些目錄屬性會觸發此控制項，方法是為相關搜尋查詢提供條件，例如「包含」或「不在範圍內」。如果未設定目錄屬性，系統一律會套用這項控制項。

    2. 輸入日期範圍，定義適用時間範圍。如果符合任何指定的時間範圍，系統會在這段時間範圍內將目錄屬性與查詢相符。使用 「新增時間範圍」新增時間範圍。

    3. 在「不要建立關聯的動作」下方，指定不應與您在前一個「觸發條件」部分中輸入的查詢字詞建立關聯的字詞。分別輸入至「查詢字詞」和「已取消關聯的字詞」欄位。

  6. 按一下「提交」，將控制項要求傳送給核准者。你可以在 Merchandising 主控台中查看提交要求的狀態。如果改變心意，可以刪除控制要求。

Cloud 控制台

  1. 前往「Search for Commerce」控制台的「Controls」頁面。

    前往「控制」頁面

  2. 在「Serving controls」(供應控制項) 分頁中，按一下 「Create control」(建立控制項)。

    「Create control」窗格隨即開啟。

  3. 在「偏好設定」部分的「控制項名稱」欄位中，輸入新控制項的名稱。

  4. 選用步驟：如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。

  5. 選擇「不關聯控制項」做為控制項類型。

  6. 按一下「繼續」即可前往「觸發條件」部分。

  7. 選用：按一下「新增時間範圍」按鈕，新增一或多個可套用此控制項的時間範圍。

  8. 按一下「Continue」，前往「Actions」部分。

  9. 在「查詢字詞」欄位中，輸入要明確區分其他字詞的字詞 (例如 gShoe)。

  10. 在「已取消關聯的字詞」欄位中，輸入要與指定查詢字詞取消關聯的字詞。

    舉例來說，您可以將查詢字詞 gShoe 與字詞 cheap 分離。

  11. 按一下「Continue」，前往「Serving configs」部分。

  12. 選取要套用控制項的供應設定。

  13. 提交控制項設定。

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

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

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 方法：

建立忽略控制項

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

商品企劃主控台

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

    這會將你導向行銷控制台中的「控制項」頁面。

  2. 按一下「建立控制項」。

  3. 定義目標和必要的時間。請務必回答所有問題。點按「Next」。

  4. 選取控制項。輸入控制項名稱，選取「Search」產品，然後選擇「Ignore」控制項類型。

  5. 設定「忽略」控制項：

    1. 在「觸發條件」下方，定義哪些目錄屬性會觸發此控制項，方法是為相關搜尋查詢提供條件，例如「包含」或「不在範圍內」。如果未設定目錄屬性，系統一律會套用這項控制項。

    2. 輸入日期範圍，定義適用時間範圍。如果符合任何指定的時間範圍，系統會在這段時間範圍內將目錄屬性與查詢相符。使用 「新增時間範圍」新增時間範圍。

    3. 在「忽略動作」下方輸入要忽略的字詞。

  6. 按一下「提交」，將控制項要求提交給核准者。你可以在 Merchandising 主控台中查看提交要求的狀態。如果改變心意，可以刪除控制要求。

Cloud 控制台

  1. 前往「Search for Commerce」控制台的「Controls」頁面。

    前往「控制」頁面

  2. 在「Serving controls」(供應控制項) 分頁中，按一下 「Create control」(建立控制項)。

    「Create control」窗格隨即開啟。

  3. 在「偏好設定」部分的「控制項名稱」欄位中，輸入新控制項的名稱。

  4. 選用步驟：如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。

  5. 選擇「不關聯控制項」做為控制項類型。

  6. 按一下「繼續」即可前往「觸發條件」部分。

  7. 選用：按一下「新增時間範圍」按鈕，新增一或多個可套用此控制項的時間範圍。

  8. 按一下「Continue」，前往「Actions」部分。

  9. 在「忽略字詞」欄位中，輸入要讓搜尋功能忽略的字詞 (例如 shoddy)，當這些字詞以查詢字詞的形式輸入時，搜尋功能就會忽略。

  10. 按一下「Continue」，前往「Serving configs」部分。

  11. 選取要套用控制項的供應設定。

  12. 提交控制項設定。

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

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

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 方法：

建立替換控制項

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

商品企劃主控台

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

    這會將你導向行銷控制台中的「控制項」頁面。

  2. 按一下「建立控制項」。

  3. 定義目標和必要的時間。請務必回答所有問題。點按「Next」。

  4. 選取控制項。輸入控制項名稱，選取「Search」產品，然後選擇「Replacement」控制項類型。

  5. 設定替換控制項：

    1. 在「觸發條件」下方，定義哪些目錄屬性會觸發此控制項，方法是為相關搜尋查詢提供條件，例如「包含」或「不在範圍內」。如果未設定目錄屬性，系統一律會套用這項控制項。

    2. 輸入日期範圍，定義適用時間範圍。如果符合任何指定的時間範圍，系統會在這段時間範圍內將目錄屬性與查詢相符。使用 「新增時間範圍」新增時間範圍。

    3. 在「取代動作」下方，定義要在第一個欄位中取代的查詢字詞，以及第二個欄位的替代字詞。

  6. 按一下「提交」，將控制項要求傳送給核准者。你可以在 Merchandising 主控台中查看提交要求的狀態。如果改變心意，可以刪除控制要求。

Cloud 控制台

  1. 前往「Search for Commerce」控制台的「Controls」頁面。

    前往「控制」頁面

  2. 在「Serving controls」(供應控制項) 分頁中，按一下 「Create control」(建立控制項)。

    「Create control」窗格隨即開啟。

  3. 在「偏好設定」部分的「控制項名稱」欄位中，輸入新控制項的名稱。

  4. 選用步驟：如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。

  5. 選擇「替換控制項」做為控制項類型。

  6. 按一下「繼續」即可前往「觸發條件」部分。

  7. 選用：按一下「新增時間範圍」按鈕，新增一或多個可套用此控制項的時間範圍。

  8. 按一下「Continue」，前往「Actions」部分。

  9. 在「查詢字詞」欄位中，輸入要替換為取代字詞的查詢字詞 (例如 gShoe)。

  10. 在「替換字詞」欄位中，輸入要取代您指定查詢字詞的字詞。

    例如，您可以將查詢字詞 gShoe 替換為替換字詞 Google Shoe。

  11. 按一下「Continue」，前往「Serving configs」部分。

  12. 選取要套用控制項的供應設定。

  13. 提交控制項設定。

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

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

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 方法：

建立固定控制項

如要建立固定控制項，請按照下列步驟操作：

商品企劃主控台

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

    這會將你導向行銷控制台中的「控制項」頁面。

  2. 按一下「建立控制項」。

  3. 定義目標和必要的時間。請務必回答所有問題。點按「Next」。

  4. 選取控制項。輸入控制項名稱，選取「Search」產品，然後選擇「Pinning」控制項類型。

  5. 設定固定控制項：

    1. 在「觸發條件」下方，定義哪些目錄屬性會觸發此控制項，方法是為相關搜尋查詢提供條件，例如「包含」或「不在範圍內」。如果未設定目錄屬性，系統一律會套用這項控制項。

    2. 輸入日期範圍，定義適用時間範圍。如果符合任何指定的時間範圍，系統會在這段時間範圍內將目錄屬性與查詢相符。使用 「新增時間範圍」新增時間範圍。

    3. 定義要透過這個控制項觸發的固定動作。這些動作由 產品 ID 和圖釘位置定義，建議使用小於 120 的數字 (一般頁面大小)。你可以按一下「新增產品」，最多可新增 10 個產品。

  6. 按一下「提交」，將控制項要求提交給核准者。你可以在 Merchandising 主控台中查看提交要求的狀態。如果改變心意，可以刪除控制要求。

Cloud 控制台

  1. 前往「Search for Commerce」控制台的「Controls」頁面。

    前往「控制」頁面

  2. 在「Serving controls」(供應控制項) 分頁中，按一下 「Create control」(建立控制項)。

    「Create control」窗格隨即開啟。

  3. 在「偏好設定」部分的「控制項名稱」欄位中，輸入新控制項的名稱。

  4. 選用步驟：如要變更自動建立的控制項 ID，請按一下「編輯」，然後輸入新的控制項 ID。

  5. 在「產品選項」部分，選取「搜尋或瀏覽」。

  6. 選擇「固定控制項」做為控制項類型。按一下「繼續」。

  7. 在「觸發條件」部分中，選擇會觸發這項控制項的使用者行為：

    • 瀏覽類別：瀏覽要求必須填入 page_categories 欄位，且 search.request.query 不得為空白。

    • 搜尋：搜尋要求只需要填入 search.request.query。

      根據預設，所有瀏覽的類別和搜尋的查詢都會觸發這項控制項。

  8. 選用：設定條件，根據使用者瀏覽的特定類別或搜尋的查詢觸發規則：

    • 瀏覽類別：在「類別」欄位中輸入觸發控制項的類別。

    • 搜尋：如要新增要篩選的搜尋字詞 (例如 running shoes)，請按一下「新增搜尋」。針對每個字詞，選擇「部分比對」或「完全比對」。

  9. 選用：按一下「新增時間範圍」或「新增日期範圍」，新增一或多個可套用此控制項的時間範圍。

  10. 按一下「Continue」，前往「Actions」部分。針對「固定位置」，請使用滑桿指定要將產品固定在哪個位置。固定值滑桿不接受 0、負數或非整數的值。

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

  11. 按一下「Continue」，前往「Serving configs」部分。選取要套用控制項的供應設定，然後提交控制項設定。

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

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

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 方法：

最後，請進行搜尋要求來測試設定。為確保系統可順利為要求套用固定控制項，請使用與先前步驟中所建立控制項中提供的字詞/類別相符的查詢字詞 (在搜尋中) 或網頁類別 (在瀏覽中)。

Cloud 控制台

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

    前往「評估」頁面

  2. 前往「搜尋」分頁。

  3. 在搜尋查詢欄位中輸入測試查詢。

  4. 按一下「搜尋預覽」。

  5. 查看結果，確認你選擇的產品已固定。

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 必須是目錄中的產品。