建立供應設定

本頁說明如何建立放送設定。供應設定是一個供應實體,可與模型或一組控制項建立關聯,用於產生搜尋或推薦結果。如要進一步瞭解供應設定,請參閱「關於供應設定」。

事前準備

推薦內容和搜尋供應設定有不同的需求和選項:

  • 推薦供應設定需要模型。如果您打算將現有模型附加至新的服務設定,請取得要使用的模型 ID (使用 ServingConfig.create 方法時必需)。

    如果您使用主控台建立提交設定,可以在建立程序中建立新模型,而非附加現有模型。

    只要是相同的模型類型,您日後可以變更模型。

  • 搜尋功能可以使用供應控制項,但並非必要。如果您打算將現有控制項附加至新的供應設定,請取得要使用的控制項 ID。

    如果您使用控制台建立提交設定,也可以在建立過程中建立新的控制項。

    您可以在建立供應設定後,切換或新增供應控管機制。

建立供應設定

您可以使用下列方式建立供應設定:

每個目錄最多可使用 100 個放送設定。

搜尋功能可搭配未設定的供應設定使用。任何 serving_config_id 都可以納入搜尋要求,而這個 default_search 會使用 Vertex AI Search for Commerce 的預設搜尋功能搜尋目錄。

如果您有現有的刊登位置,或建立新的刊登位置,系統會自動建立與每個刊登位置相關聯的放送設定。建立供應設定不會建立相應的刊登位置。刪除供應設定會刪除相應的顯示位置,而刪除顯示位置會刪除相應的供應設定。

在控制台中建立供應設定

在 Search for Commerce 主控台的「供應設定」頁面中新增供應設定。

如要建立新的供應設定,請按照下列步驟操作:

  1. 前往 Google 商務搜尋控制台的「供應設定」頁面。

    前往「Serving 設定」頁面

  2. 按一下「建立供應設定」

    建議做法

    1. 選取「Recommendation」做為供應設定的產品。

    2. 提供供應設定的名稱。

      名稱長度不得超過 1024 個字元,且只能包含英數字元、底線、連字號和空格。

    3. 選用:視需要更新 ID。

      系統會根據您提供的名稱產生 ID,且該 ID 在專案中不得重複。長度不得超過 50 個半形字元,且不得包含空格。

    4. 選擇或建立要讓這項供應設定提供建議的模型。

      進一步瞭解如何建立新模型。

    5. 選取價格重新排序對推薦結果的影響程度 (如果您選取的模型提供這項功能)。

      這項功能啟用之後,系統會將推薦機率相近的推薦產品按照價格由高至低排序。系統仍會使用相關性來排序項目,因此啟用價格重新排序功能與依價格排序不同。

    6. 選取要使用以規則為準或以資料為準的結果多樣化功能:

      • 以規則為基礎:以規則為基礎的結果多樣化功能會影響單一預測要求傳回的結果是否來自產品目錄中的不同類別。

      • 以資料為準:如果多樣化功能是以資料為準,就會運用機器學習技術,在預測結果的類別多元性與關聯性之間取得平衡。

      詳情請參閱「多元化結果」。

    7. 選取要多樣化的推薦結果。

    8. 如果您為這項供應設定選取了相似商品模型,請選取是否要啟用類別比對功能。

      啟用類別比對功能後,系統只會傳回與背景產品至少共用一個類別的產品結果。您可以將類別比對功能與其他篩選選項 (例如價格、供應情形和篩選標記) 搭配使用。

    1. 在「建立供應設定」頁面中,選擇「搜尋」做為供應設定的產品。
    2. 為放送設定提供名稱。

      名稱長度不得超過 1024 個半形字元,且只能包含英數字元、底線、連字號和空格。
    3. 選用:如有需要,請更新 ID。

      系統會根據您提供的名稱產生 ID,且該 ID 在專案中不得重複。長度不得超過 50 個半形字元,且不得包含空格。
    4. 點選「繼續」
    5. 選擇是否要為這項供應設定啟用動態切面。
    6. 選擇或建立供應控制項,以便最佳化搜尋。

      如要進一步瞭解控制項,請參閱「建立及管理控制項」。
  3. 按一下「建立」,即可建立新的設定。

    新的設定會顯示在「放送設定」頁面中。

    設定可能需要幾分鐘才能在搜尋要求中使用。這項功能會立即提供推薦功能使用。

  4. 選用:在「放送設定」頁面中,按一下放送設定名稱,然後前往「評估」分頁,即可預覽這個設定會傳回的產品。

    評估預覽功能可協助您確認設定的運作情況是否符合預期。

使用 ServingConfig.create 建立供應設定

您可以使用 ServingConfig.create API 方法建立服務設定。如需此方法的 API 參考說明文件,請參閱 ServingConfig.create

您要使用哪些欄位,取決於您是要建立建議或搜尋的供應設定。

如要進一步瞭解 ServingConfig 欄位,請參閱 ServingConfigs API 參考資料

建議做法

提出 ServingConfig.create 要求,其中包含服務設定 ID 和要求主體中包含的 ServingConfig 例項。

  • servingConfigId:必填。為 ServingConfig 建立 ID。這個值的長度應為 4 至 63 個字元。有效字元為 /[a-z][0-9]-_/
  • displayName:必填。在「搜尋商業服務」控制台中顯示的人類可讀 ServingConfig 名稱。
  • modelID:必填。在放送時間使用模型的 ID。
  • priceRerankingLevel:選用。設定價格重新排名對推薦結果的影響程度。允許的值為 no-price-reranking (未設定時的預設值)、low-price-rarankingmedium-price-rerankinghigh-price-reranking
  • diversityLevel:選用。設定推薦結果的多樣化程度。允許的值為 no-diversity (預設)、low-diversitymedium-diversityhigh-diversityauto-diversity。如果未設定 diversityLevel,系統會停用多樣化功能。
  • diversityType:選用。將其設為 RULE_BASED_DIVERSITY,即可根據產品類別提供多樣化的推薦結果。將其設為 DATA_DRIVEN_DIVERSITY,即可根據產品中繼資料的學習內容,提供多樣化的推薦內容,以平衡關聯性和類別多樣性。如果已設定 diversityLevel,但未設定 diversityType,則 diversityType 預設為以規則為準。詳情請參閱「結果多樣化」。
  • enableCategoryFilterLevel:選用。設定是否要在相似商品模型中新增其他類別篩選器。允許的值為 relaxed-category-match (如果未設定,則為預設值) 和 no-category-match
  • solutionTypes:必填。將推薦內容供應設定設為 SOLUTION_TYPE_RECOMMENDATION
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",
              "modelId": "MODEL_ID",
              "priceRerankingLevel": "PRICE_RERANKING_LEVEL",
              "diversityType": "DIVERSITY_TYPE",
              "diversityLevel": "DIVERSITY_LEVEL",
              "enableCategoryFilterLevel": "CATEGORY_FILTER_LEVEL",
              "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ]
            }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"
  

搜尋

提出 ServingConfig.create 要求,其中包含服務設定 ID 和要求主體中包含的 ServingConfig 例項。

  • servingConfigId:必填。為 ServingConfig 建立 ID。這個值的長度應為 4 至 63 個字元。有效字元為 /[a-z][0-9]-_/
  • displayName:必填。在「搜尋商業服務」控制台中顯示的人類可讀 ServingConfig 名稱。
  • facetControlIds:選用。僅設定 FacetSpec 的控制項 ID。
  • dynamicFacetSpec.mode:選用。DynamicFacet 功能的模式。允許的值為 DISABLED (如果未設定,則為預設值) 和 ENABLED
  • boostControlIds:選用。加強放送控制項的 ID。
  • filterControlIds:選用。篩選器放送控制項的 ID。
  • redirectControlIds:選用。重新導向服務控制項的 ID。
  • twowaySynonymsControlIds:選用。雙向同義詞放送控制項的 ID。
  • onewaySynonymsControlIds:選用。單向同義詞放送控制項的 ID。
  • doNotAssociateControlIds:選用。不關聯放送控制項的 ID。
  • replacementControlIds:選用。替換供應控制項的 ID。
  • ignoreControlIds:選用。忽略放送控制項的 ID。
  • solutionTypes:必填。將搜尋供應設定設為 SOLUTION_TYPE_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,
              "facetControlIds": [
                "FACET_CONTROL_ID_1",
                "FACET_CONTROL_ID_2"
              ],
              "dynamicFacetSpec": {
                "mode": "DYNAMIC_FACET_MODE"
              },
              "boostControlIds": [
                "BOOST_CONTROL_ID_1",
                "BOOST_CONTROL_ID_2"
              ],
              "filterControlIds": [
                "FILTER_CONTROL_ID_1",
                "FILTER_CONTROL_ID_2"
              ],
              "redirectControlIds": [
                "REDIRECT_CONTROL_ID_1",
                "REDIRECT_CONTROL_ID_2"
              ],
              "twowaySynonymsControlIds": [
                "TWO_WAY_SYNONYM_CONTROL_ID_1",
                "TWO_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "onewaySynonymsControlIds": [
                "ONE_WAY_SYNONYM_CONTROL_ID_1",
                "ONE_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "doNotAssociateControlIds": [
                "DO_NOT_ASSOCIATE_CONTROL_ID_1",
                "DO_NOT_ASSOCIATE_CONTROL_ID_2"
              ],
              "replacementControlIds": [
                "REPLACEMENT_CONTROL_ID_1",
                "REPLACEMENT_CONTROL_ID_2"
              ],
              "ignoreControlIds": [
                "IGNORE_CONTROL_ID_1",
                "IGNORE_CONTROL_ID_2"
              ],
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ]
    }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"
  

後續步驟