區域元件

區域 (zone) 的定義為一個推薦預留空間。您可自由選擇是否要使用區域來放置推薦,不過區域確實能提供額外的彈性。舉例來說,您的產品詳細資料頁面可以有兩個區域:一個用於「您可能也喜歡」建議工具,另一個則用於「完成組合」建議工具。只要善用區域,就可以輕鬆切換 Einstein Configurator 中的建議工具。

不同於網頁動態內容,使用 Einstein Recommendations API 實作推薦時,需要編寫一些程式碼,才能在建議工具之間切換。

變更區域的建議工具時,請將該變更限制為同一建議工具類型中的其他建議工具。這個動作能讓您不必變更推薦定位點。

API 設定有無區域的比較

有區域無區域
變更區域的建議工具在 Einstein Configurator 中,變更連結至區域的建議工具。變更程式碼,來更新新建議工具的 API 呼叫。
API 端點取得區域推薦取得推薦
推薦端點回應{recs: [], recoUUID: '', recommenderName: '', displayMessage: ''}{recs: [], recoUUID: ''}

Activities

無論您是否使用區域,活動的端點永遠相同。viewRecoclickReco 活動永遠需要 recommenderName 參數。使用區域時,viewRecoclickReco 活動中的 recommenderName 參數必須來自對 Zone Recommendations API 的要求的回應。

Einstein Configurator 中啟用對 API 的存取後,網站管理員使用者的「網站建議」索引標籤會變成選單。使用此選單,即可檢視並設定建議工具或區域。

網站管理員可以允許其他使用者存取區域,方法是從「使用者管理」索引標籤中找到並選擇使用者,然後從選單中選擇 [編輯動作]

您可以在「建議工具」索引標籤中設定、編輯、刪除建議工具,這與在未配置 API 存取權限的情況下使用「網站建議」頁面相同。「區域」索引標籤則用於設定、編輯、刪除區域。

若要建立區域:

  1. 從「網站建議」選單中,選擇 [區域]
  2. 按一下 [+ 新區域]
  3. 指定區域名稱,並選擇性提供區域的描述。
    • 區域名稱儲存後即無法變更。
  4. 使用選單,選擇要在區域中使用的可用建議工具。
    • 如果您沒有設定任何建議工具,或者尚未決定要將哪個建議工具用於區域,則可以稍後再進行這個步驟。想瞭解如何建立建議工具,請參閱 Commerce Cloud Einstein Product Recommendations
  5. 按一下 [儲存]

您可以建立多個區域來透過 Einstein API 使用。

在 Einstein Configurator 中設定區域後,開發人員要使用設定好的區域名稱,作為區域 API 要求中的 zoneName 路徑參數 (請參閱 API Specification - Endpoints - Zone Recommendations)。

回應包含一個 recommenderName,用於識別目前為該區域設定的建議工具名稱。在後續的 viewRecoclickReco 活動要求中,請將此值作為 recommenderName 本文參數傳遞。