本頁面將介紹部分層面功能及使用方式。
與構面相關的定義
本節提供與構面相關的一些基本定義和說明:
商情項目:執行商情項目搜尋的商情項目規格。 使用者可以透過篩選結果找到所需內容。舉例來說,如果使用者搜尋「
shoes」,系統可能會傳回「price」、「attributes.department」、「attributes.colors」和「attributes.size」等層面。系統屬性:預先定義的系統屬性是現有的產品欄位,可提供產品的詳細資訊。包括一些預先定義的產品屬性,例如
brand、availability、color和size。自訂屬性:自訂屬性是使用 Product.attributes 欄位定義的額外屬性。舉例來說,這可能包括
style、color或department。Facet 鍵:這是 facet 的名稱。例如
attributes.department或sizes。分面鍵對應至屬性名稱。舉例來說,(產品) 系統屬性名稱sizes對應至商情項目鍵sizes。同樣地,(產品) 自訂屬性名稱department對應於商情項目鍵attributes.department(如果是自訂屬性,則會在自訂屬性名稱中加入前置字元attributes.,以取得商情項目鍵)。「字詞屬性名稱」、「分頁鍵」和「分頁名稱」可互換使用。商情項目值:如果是文字鍵,這是商情項目的其中一個文字值。舉例來說,文字側面的鍵
brands可能會有Asics和Nike等文字值。如果是數值鍵,刻面值就是間隔。舉例來說,數值層面鍵價格可能具有 [20, 30) 形式的間隔。屬性或構面類型:可以是文字或數值。
已釘選的構面:這是您在要求中使用
FacetSpec傳遞的構面,並搭配enableDynamicPosition=false選項。回應中的所有動態層面之前,應會顯示原始順序的層面。動態 facet:這些是搜尋結果側邊的 facet。這些選項會透過要求傳遞 (使用
enableDynamicPosition=true選項),或根據搜尋模型擷取。接著,這些結果會由同一組訓練模型排序,最相關的結果會顯示在最上方。可做為 facet、動態 facet 或圖塊處理: 如果屬性啟用動態 facet 處理, 搜尋功能就能根據過去的使用者行為 (例如點選和查看 facet) 自動將該屬性做為動態 facet。如要為屬性啟用動態切面,你必須同時為該屬性啟用索引。
篩選器:filter 語法包含運算式語言,可從要篩選產品的一或多個欄位建構述詞。舉例來說,如果使用者與分面鍵
attributes.brands的分面值Asics互動,篩選條件的一部分可能是(attributes.brands:ANY(\"Asics",\"Nike\"))。篩選運算式須區分大小寫。如要進一步瞭解篩選器,請參閱這份使用手冊。


動態 facet 和圖塊簡介
為放送設定啟用動態 facet 後,搜尋功能會根據過去的使用者行為 (例如點選和查看 facet),自動將屬性做為動態 facet 和圖塊,顯示在該設定的搜尋結果中。動態 facet 會透過選項 enableDynamicPosition=true 在要求中傳遞,或根據搜尋模型擷取。接著,這些結果會由相同模型排序,最相關的結果會顯示在最上方。
根據預設,大多數側滑片鍵都是可側滑片。在 API 中,您可以透過 Gemini Enterprise for Customer Experience 控制台的 AI Commerce Search,使用全網站屬性控制項,覆寫所選特定層面鍵的動態層面設定。換句話說,如要讓部分構面鍵無法做為構面,請在「Attribute
controls」分頁中,為每個構面鍵停用動態構面。詳情請參閱「管理整個網站屬性控制項」。
請注意,動態側邊和圖塊只能根據準確的產品目錄資料建立。不過,如要讓這項功能在網站上發揮最佳效果,構面模型需要從網站上的活動中學習。為此,您需要在搜尋事件上傳作業中,準確設定查詢、類別和篩選器欄位。
如果您的任何放送設定都未啟用動態構面和動態方塊,且您剛在放送設定中啟用動態構面和動態方塊,請等待三到四天,這些功能才會開始運作。
屬性設定對商情項目顯示方式的影響
如要有效控管購物者看到分類的時機和方式,請務必瞭解目錄的屬性設定與 AI Commerce Search 分類行為之間的關係。Facet 的外觀主要由兩個屬性設定控管:可建立索引和動態 facet 處理。
可建立索引的選項 (必要條件)
如要讓屬性顯示為 facet (無論是靜態或動態),必須先將屬性設定為「可建立索引」。
- 系統屬性:預先定義的系統屬性 (例如
brand、availability、color和size) 預設可供建立索引,且無法停用這項設定。 - 自訂屬性:自訂屬性 (例如
store_name或style) 預設可建立索引,但您可以選擇停用這項設定。
靜態或動態商情項目外觀
如果屬性可供建立索引,該屬性在搜尋結果中的顯示方式取決於屬性是靜態要求還是動態要求:
- 靜態構面:這些構面會顯示,是因為您在
SearchRequest中使用facetSpecs欄位明確要求。只要要求的屬性可建立索引,系統就會在搜尋結果中傳回商情項目。 - 動態層面:這些層面會根據使用者過去的行為 (例如點擊和瀏覽層面) 和與特定搜尋查詢的關聯性自動顯示。如要動態顯示屬性,必須為該屬性啟用「動態 facet 和圖塊處理」選項,且放送設定也必須啟用動態 facet。
文字和數值商情項目的行為
屬性的資料類型會大幅影響屬性顯示為構面的方式:
- 文字屬性:動態 facet 處理功能僅原生支援文字屬性 (例如
Color: Red)。 - 數值屬性:系統不支援數值屬性的動態切面。如要依數值屬性 (例如
Price) 建立篩選條件,請採取下列任一做法:- 將這些屬性當做靜態層面傳遞,並在搜尋要求中明確定義
intervals(buckets),例如$0-$50和$50-$100。 - 在資料管道中將數值屬性轉換為文字屬性 (例如將價格範圍儲存為字串),然後以自訂屬性形式擷取,即可使用動態切面。
- 將這些屬性當做靜態層面傳遞,並在搜尋要求中明確定義
屬性設定和構面限制
設計搜尋和切面體驗時,請注意下列系統限制和行為限制。
設定和目錄限制
- 屬性數量上限:在
AttributesConfig請求中,最多可設定 1,000 個目錄屬性。 - 生效時間 (屬性):變更屬性設定 (例如
Indexable或Searchable) 後,會在下次匯入目錄時立即生效,或在 API 中更新後 12 到 24 小時內生效。 - 生效時間 (動態 facet 處理):變更
Dynamic Faceting切換鈕,或首次在放送設定中新增動態 facet 處理,可能需要 2 到 4 天才會生效。
搜尋要求和回應限制
- 每個要求的切面數量上限:單一搜尋要求最多可包含 200 個
FacetSpec物件。 - 每個 facet 的最大值:單一 facet 最多可傳回 300 個值 (預設為 50 個)。
- 間隔上限:單一數值層面最多可定義 40 個間隔 (buckets)。
- 前置字元和包含:使用
prefixes或contains篩選分面值時,最多只能使用 10 個字串。 - 受限值:使用
restrictedValues限制傳回的 facet 時,最多可指定 20 個值。
資料量規定
如要讓動態商情項目功能發揮最佳效益,並顯示最相關的商情項目,至少要有 10% 的已擷取搜尋使用者事件包含支援的篩選條件陳述式。
facet 控制項
本節將說明如何建立不同類型的 facet 控制項,其中許多控制項也控管圖塊行為:
- 忽略 facet 和圖塊值控制項
- 取代 facet 和圖塊值控制項
- 合併 facet 控制項
- 設定數值間隔控制項
- 移除 facet 和圖塊控制項
- 強制傳回 facet 控制項
- 重新排定動態 facet 排名控制項
除非另有說明,否則 AI Commerce Search 會對所有這些層面控制項執行區分大小寫的相符程序。
如要控管特定側邊欄值和圖塊行為,請前往 Gemini Enterprise for Customer Experience 控制台的 AI Commerce Search,然後點選「側邊欄控制項」分頁標籤。
按一下「建立控制項」,即可修改搜尋傳回的 facet。「建立控制項」窗格隨即開啟。按一下「控制項類型」欄位,開啟下拉式選單,然後選取控制項類型。每個選項都會開啟對話方塊,提供控制構面的選項。所有切面控制項類型都至少需要屬性資訊,但每種表單需要的資訊略有不同。

建立「忽略 facet 和圖塊值」控制項
如要移除特定 facet 和圖塊鍵的某些多餘 facet 和圖塊值,請建立「忽略 facet 和圖塊值」控制項。
這項控制項可清除不需要的 facet 和圖塊值,例如 NA 和 Not_applicable。不過,如果您在 10 月,也可以用來清除季節性趨勢,例如 Easter。
如要建立會忽略 facet 和圖塊值的控制項,請按照下列步驟操作:
前往 Gemini Enterprise for Customer Experience 控制台的「AI Commerce Search」頁面。
在「Facet controls」(Facet 控制項) 分頁中,按一下 add_box「Create control」(建立控制項)。
「建立控制項」窗格隨即開啟。
選取「忽略 facet 和圖塊值」。
指定屬性名稱。
例如,系統屬性的
brands。如果是自訂屬性,名稱會以attributes.開頭,例如attributes.department和attributes.colors。選用:指定「開始時間」和/或「結束時間」。
將一或多個屬性值指定為「忽略值」。
例如
NA、Not_applicable和Easter。按一下「提交」。
建立「替換 facet 和圖塊值」控制項
如要將多個類似的 facet 和圖塊值合併為單一字詞,請建立「替換 facet 和圖塊值」控制項。
有時會將替換 facet 和圖塊值稱為「合併 facet 和圖塊值」。
為避免發生衝突和無用的對應,如果屬性值 facet_value_1 由另一個屬性值 facet_value_2 取代,則後者無法由其他屬性值取代。舉例來說,如果您將 ruby 替換為 dark red,之後就無法再將 dark red 替換為 red。
每個屬性名稱的屬性值在「取代值」欄位中,不得出現超過一次。
如要建立可取代 facet 和值的控制項,請按照下列步驟操作:
前往 Gemini Enterprise for Customer Experience 控制台的「AI Commerce Search」頁面。
在「Facet controls」(Facet 控制項) 分頁中,按一下 add_box「Create control」(建立控制項)。
「建立控制項」窗格隨即開啟。
選取「替換 facet 和圖塊值」。
指定屬性名稱。
這項功能僅適用於以
attributes前置字元開頭的自訂屬性,例如attributes.department和attributes.colors。將一或多個屬性值指定為「取代值」,例如
RED、Red、dark red、bright red、ruby和crimson。屬性值在「取代值」欄位中只能出現一次。
將單一屬性值指定為「取代字詞」,例如
red。按一下「提交」。
雖然取代的值可能會快速消失,但取代字詞最多可能需要四天才會顯示。
當「取代 facet 值」控制項生效時,如果回應中傳回 facet 鍵 (本例中為 attributes.colors),則取代的 facet 值 (例如 dark red 和 crimson) 不會顯示為 facet 值。並由替代字詞取代 (例如 red)。
建立合併構面控制項
建議你在產品擷取至搜尋資料庫前,正確設定產品自訂屬性名稱和值。不過,如果無法變更自訂屬性名稱,可以建立合併構面控制項。如要合併 (取代) facet,請建立合併 facet 控制項。舉例來說,您可能有多個顏色自訂刻面鍵,例如 attributes.colors_jeans、attributes.colors_clothes 和 attributes.colors_hue,並想以名為 attributes.colors 的現有自訂刻面鍵取代這些鍵。
最好是:
- 自訂屬性名稱具有永久效力,且不會變更類型。
- 許多已擷取產品的屬性名稱。
刪除合併的金鑰後,您會遺失參與度資料,而這些資料會用於訓練動態分面模型。
為每項產品建立索引時,系統會將鍵和合併鍵都納入屬性名稱,除非你超過每項產品允許的屬性數量上限。如果屬性數量超過每個產品的配額上限,搜尋會任意截斷合併的鍵,這些鍵會成為屬性名稱。
舉例來說,假設特定產品已達到自訂屬性名稱數量上限,且其中一個自訂屬性名稱為 colors_jeans,你使用合併構面控制項將 attributes.colors_jeans 合併至 attributes.colors,在這種情況下,系統不會將屬性名稱 colors 新增至這個特定產品,因為該產品的自訂鍵數量已達上限。系統不會從產品的 (自訂) 屬性名稱中刪除合併的鍵,但也不會將其做為動態層面鍵傳回。同樣地,如果合併多個相同鍵,導致合併鍵的屬性值數量超過允許的屬性值數量上限,搜尋會任意截斷屬性值。
如要建立將一個分面合併至另一個分面的控制項:
前往 Gemini Enterprise for Customer Experience 控制台的「AI Commerce Search」頁面。
在「Facet controls」(Facet 控制項) 分頁中,按一下 add_box「Create control」(建立控制項)。
「建立控制項」窗格隨即開啟。
選取「合併 facet」。
指定要併入另一個自訂構面鍵的有效自訂構面鍵。
這項功能僅適用於以
attributes為前置字元的自訂屬性,例如attributes.colors_clothes和attributes.colors_jeans。指定有效的自訂構面鍵做為合併鍵。
按一下「提交」。
這項設定通常會在 2 到 4 天內生效。
建立「設定數值間隔」控制項
您可以透過「設定數值間隔」控制項,為數值商情項目或圖塊決定間隔,不必接受系統計算的間隔。
舉例來說,搜尋可能會針對自訂數值商情項目鍵 attributes.monitor_size 計算間隔 [10,15)、[15,20)、[20,25)、[25,30)、[30,40)、[40,50) 和 [50,infinity)。但您可能偏好使用間隔 [0,14)、[14,17)、[17,21)、[21,24)、[24,27)、[27,32) 和 [32,infinity)。
關於計算間隔和設定間隔
對於所有數值自訂屬性以及數值系統屬性 price、rating 和 ratingCount,搜尋功能會根據每個屬性的所有 (數值) 屬性值分布情形,計算出一些具有四捨五入界限的間隔。您也可以在要求中指定間隔。最後,您可以使用下列設定數值間隔控制項,為每個數值層面鍵設定間隔。
系統會依下列優先順序決定要使用哪個間隔:
首先,如果數值層面鍵的要求中指定了某些間隔,這些間隔會保留。
否則,如果數值 facet 鍵是動態的,或是在沒有間隔的情況下傳遞至要求,則使用「設定數值間隔」控制項加入的間隔會新增至該數值 facet 鍵 (如果這些間隔不為空)。
否則,系統會加入先前提及的計算間隔和四捨五入的界限。
建立控制項
如要為數字層面和圖塊鍵指定自己的間隔,而非使用 AI Commerce Search 為您計算的間隔,請建立一組數值間隔控制項。
如要建立新增間歇的控制項,請按照下列步驟操作:
前往 Gemini Enterprise for Customer Experience 控制台的「AI Commerce Search」頁面。
在「Facet controls」(Facet 控制項) 分頁中,按一下 add_box「Create control」(建立控制項)。
「建立控制項」窗格隨即開啟。
選取「設定數值分面和圖塊間隔」。
指定數值屬性的名稱。
例如,系統屬性的
price。如果是自訂屬性,名稱會以attributes.開頭,例如attributes.number_of_pieces。請至少指定「最低」或「最高」。如果同時指定兩者,最小值不得大於最大值。您可以選擇將每個界限設為「包含」或「排除」。
如要新增更多間隔,請按一下「新增間隔」add_box。間隔數量上限為 40 個。
按一下「提交」。
建立用於移除 facet 和圖塊的控制項
移除 facet 控制項可讓您從動態 facet 移除特定 facet 和圖塊鍵。系統會根據某些指定的查詢字詞或網頁類別,移除 facet 和圖塊鍵。
這類商情項目控制項會控管屬性本身。如果套用這個 facet 控制項類型,搜尋結果中不會傳回與這個 facet 相關聯的任何 facet 或圖塊 (做為成員)。
如果您想移除某些查詢字詞或瀏覽的某些構面和圖塊鍵,這項控制項就相當實用。舉例來說,你可以使用這項控制項,移除查詢 attributes.shoe_size 的 facet 鍵 shoes。
你可以使用商品管理控制台或 Google Cloud 控制台移除構面或圖塊:
商品管理控制台
按一下管理員提供的網址。 (登入)。
系統會將你導向商品目錄控制台的「控制項」頁面。
按一下「建立控制項」add_box。
定義目標使用者和所需時間。所有問題都必須回答。點選「下一步」。
選取控制項。輸入控制選項的名稱,選取「搜尋」產品,然後選擇「移除層面」控制選項類型。
設定「移除 facet」控制項:
在「觸發條件」下方,為相關搜尋查詢提供條件 (例如「包含」或「不在範圍內」),定義觸發這項控制項的目錄屬性。如果未設定任何目錄屬性,這項控制項一律會套用。
輸入日期範圍,定義「適用時間範圍」。如果符合任何指定的日期範圍,目錄屬性就會在指定日期範圍內與查詢相符。使用「新增時間範圍」add_box 新增時間範圍。
在「移除構面動作」部分下方,為您不希望顯示在動態構面中的屬性定義「要忽略的屬性」,這些屬性會對應至先前「觸發條件」部分中指定的查詢字詞。
按一下「新增屬性」class="material-icons">add_box,即可新增更多屬性。
按一下「提交」,將控制權要求提交給核准者。你可以在 Merchandising Console 中查看已提交要求的狀態。如果改變心意,可以刪除控制權要求。
Cloud 控制台
前往 Gemini Enterprise for Customer Experience 控制台的「AI Commerce Search」頁面。
在「Facet controls」(層面控制項) 分頁中,按一下 add_box「Create control」(建立控制項)。「建立控制項」窗格隨即開啟。
選取「移除 facet 和圖塊」。
每個控制項適用於搜尋或瀏覽,但無法同時套用至兩者。執行下列任一操作:
如要搜尋查詢,請按一下「搜尋」,然後指定部分查詢字詞或完全相符的查詢字詞。詳情請參閱查詢條件和條款。無論是哪種情況,查詢字詞都必須是小寫。舉例來說,您可以指定部分查詢字詞
shirts、polo、jackets、t-shirt和fall coats,如果小寫查詢是其中一個查詢字詞,或包含任何這些查詢字詞做為單字,則接下來指定的層面鍵不會顯示為動態層面。如要瀏覽,請按一下「瀏覽類別」,然後指定一些頁面類別。你可以指定類別或部門清單 (最多 10 個項目)。格式應與使用者事件網頁類別相同。舉例來說,這可能是
page_categories:Sales > 2023 Black Friday Deals。如果後者與事件中傳遞的其中一個網頁類別 (適用於瀏覽) 完全比對 (區分大小寫),則接下來指定的層面鍵不會顯示為動態層面。
在「要忽略的屬性」中,至少指定一個有效的構面鍵。
按一下「提交」。
建立強制傳回 facet 控制項
如果已為 facet 供應設定啟用動態 facet,強制傳回 facet 控制項會影響特定查詢或瀏覽事件的動態 facet 鍵清單位置或順序。
如果您想針對某些查詢字詞或瀏覽項目,強制傳回動態 facet 中的特定 facet 鍵,強制傳回 facet 控制項就非常實用。舉例來說,您可以強制 facet 鍵 brands 出現在第 10 個位置,或查詢 handbags 的較小位置。如果動態構面 brands 已是這項查詢的前 10 大構面,則變動幅度應該不大。如果不在前 10 名或動態構面清單中,則應移至第 10 名左右。
你可以在 Merchandising 控制台或 Google Cloud 控制台中,建立強制傳回 facet 的控制項。
商品管理控制台
按一下管理員提供的網址。 (登入)。
系統會將你導向商品目錄控制台的「控制項」頁面。
按一下「建立控制項」add_box。
定義目標使用者和所需時間。所有問題都必須回答。點選「下一步」。
選取控制項。輸入控制選項名稱,選取「搜尋」或「瀏覽」產品,然後選擇「強制傳回構面」控制選項類型。
設定「強制傳回 facet」控制項:
在「觸發條件」下方,為相關搜尋查詢提供條件 (例如「包含」或「不在範圍內」),定義觸發這項控制項的目錄屬性。如果未設定任何目錄屬性,這項控制項一律會套用。
輸入日期範圍,定義「適用時間範圍」。如果符合任何指定的日期範圍,目錄屬性就會在指定日期範圍內與查詢相符。使用「新增時間範圍」add_box 新增時間範圍。
在「Force return facets actions」部分下方,定義「Attribute position adjustment」。在這裡,您可以選擇要納入動態側邊導覽或動態圖塊的屬性,這些屬性會用於您在先前的「觸發條件」部分中設定的查詢或網頁類別。舉例來說,如果選擇位置 5,代表該層面會顯示在網頁底部算起第五個位置或更高。
按一下「新增調整項」add_box,即可新增更多受這項控制項管理的屬性。
按一下「提交」,將控制權要求提交給核准者。你可以在 Merchandising Console 中查看已提交要求的狀態。如果改變心意,可以刪除控制權要求。
Cloud 控制台
前往 Gemini Enterprise for Customer Experience 控制台的「AI Commerce Search」頁面。
在「Facet controls」(構面控制項) 分頁中,按一下 add_box「Create control」(建立控制項)。
「建立控制項」窗格隨即開啟。
選取「強制傳回 facet」。
每個控制項適用於搜尋或瀏覽,但無法同時套用至兩者。執行下列任一操作:
如要搜尋查詢,請按一下「搜尋」,然後指定部分查詢字詞或完全相符的查詢字詞。詳情請參閱查詢條件和條款。無論是哪種情況,查詢字詞都必須是小寫。舉例來說,您可以指定部分查詢字詞
shirts、polo、jackets、t-shirt和fall coats,如果小寫查詢是其中一個查詢字詞,或包含任何這些查詢字詞做為單一字元,則接下來指定的側滑片索引鍵應會顯示在動態側滑片中各自的位置或更高。如要瀏覽,請按一下「瀏覽類別」,然後指定一些頁面類別。你可以指定類別或部門清單 (最多 10 個項目)。格式應與使用者事件網頁類別相同。舉例來說,這可能是
page_categories:Sales > 2023 Black Friday Deals。如果後者與事件中傳遞的其中一個網頁類別 (適用於瀏覽) 完全比對 (區分大小寫),則接下來指定的刻面鍵應會顯示在動態刻面中各自的位置或更高處。
指定有效的側邊欄鍵,以及介於 1 至 100 之間的整數位置 (含頭尾)。
如要指定多個層面鍵,請按一下「新增調整項」add_box,然後重複上一個步驟。
按一下「提交」。
建立重新排定動態 facet 排名控制項
動態 facet 排名取決於查詢 (搜尋) 或頁面類別 (瀏覽)。重新排序動態 facet 控制項也能讓排名取決於使用者參與的某些 facet 值。
舉例來說,如果使用者在搜尋或瀏覽後,與 facet 鍵 attributes.department 的 facet 值 watches 互動,排名也會取決於 facet 值 watches。你可以依商情項目索引鍵指定要重新排序的商情項目值,也可以只指定商情項目索引鍵,並重新排序所有商情項目值。
如要建立重新排序動態 facet 的控制項,請按照下列步驟操作:
前往 Gemini Enterprise for Customer Experience 控制台的「AI Commerce Search」頁面。
在「Facet controls」(Facet 控制項) 分頁中,按一下 add_box「Create control」(建立控制項)。
「建立控制項」窗格隨即開啟。
選取「重新排定動態 facet 排名」。
指定有效的自訂文字側邊欄鍵 (所有自訂鍵都有
attributes.前置字元)。您可以指定部分特定構面值,也可以套用至所有構面值。
如要根據所有層面值重新排序,請按一下「任何值變更」add_box。
如要根據特定 facet 值重新排序,請按一下「所選值變更」add_box。然後插入所有要重新排序的側欄值 (區分大小寫)。例如:
watches、luggages、bed。
按一下「提交」。
您需要在要求中傳遞使用者參與的所有構面鍵,原因如下:
- 假設使用者瀏覽特價商品,並看到第一份顯示的側邊欄鍵清單。
- 接著,使用者會先與構面鍵
attributes.age_group互動。 - 接著,他們會使用您設定的控制項,根據層面值
watches重新排序,並參與層面鍵attributes.department。
此時,搜尋會重新排序鍵。
因此,先前參與的構面鍵 attributes.age_group 可能不會在回應中傳回。如果您在要求中傳遞這個金鑰 (使用 Facetspec,並將 enableDynamicPosition 欄位設為 true),系統就會自動在回應中傳回這個金鑰。
不過,搜尋可能會在第 27 個位置傳回該鍵,而您可能只會向使用者顯示前 20 個鍵。因此,請確保使用者先前互動過的按鍵會顯示給使用者。如果不想向使用者顯示太多按鍵,您可能必須在回覆中篩除一些未參與的中間按鍵。