Composable Storefront 版本注意事項

這些版本注意事項包括 Progressive Web App (PWA) Kit 和 Managed Runtime 的更新。

最新的 PWA Kit 版本注意事項在此處發佈之前，會先發佈於 GitHub 的版本發行頁面。訂閱 GitHub 版本通知，隨時掌握 PWA Kit 版本相關的最新資訊。請參閱設定你的觀看設定。
  • 版本注意事項可能在相關 Github 套件更新前發佈。發行說明標識了功能可用的任何適用的包版本。
  • 如需 B2C Commerce 的一般版本注意事項，請參閱 Salesforce 説明。

PWA Kit 網店現在可以將互動事件發送到 Data Cloud，從而增強對即時、統一客戶數據的可見性。請參閱 將 PWA Kit 與 Data Cloud 集成。

使用基於表的分頁新格式，在運行時管理 UI 中的重定向效率更高，使您可以提前查看更多重定向資訊。請參閱 重定向。

現在，環境中的部署失敗提供了更詳細的資訊，使你能夠更清楚地瞭解要採取的糾正措施。請參閱包 推送錯誤疑難解答。

ap-south-2 區域 （海德拉巴） 現在支持環境。請參閱 支援的區域清單。

還解決了各種運行時管理錯誤：

  • 修復了通過 Runtime Admin 連續添加多個環境變數的問題
  • 修復了通過 Runtime Admin 刪除訪問控制標頭的問題
  • 修復了Base64URL的網店預覽解碼

在 B2C Commerce 版本 25.3 中，混合身份驗證 （auth） 取代了外掛程式 SLAS。混合式驗證將此功能直接整合至 B2C Commerce 平台，可以改善混合式網店的效能和穩定性。請參閱 使用混合身份驗證配置混合網店。

現在可以使用 Node 22 部署 PWA Kit 專案！更新您的 Node.js 版本，請依照升級 Node 版本的指示進行。

每年，多個 Node.js 版本會停止正式支援。為確保強大的安全性狀態和順暢的開發人員體驗，我們限制 Node 版本的專案部署到 Managed Runtime。Node 18 將於 2025 年 9 月 1 日終止服務。

我們強烈建議，在終止服務之前儘早將您的 Poduction 專案升級。根據您的 PWA Kit 版本，可以更新至 Node 20 或 22。

此功能自 Retail React App 6.0 版本開始，全面開放使用。改善購物者體驗並縮短實作時間。透過社群登入，購物者可以藉由使用他們的社群網站帳戶快速登入到你的網站和建立設定檔。請參閱實作社群登入。

此功能自 Retail React App 6.0 版本開始，全面開放使用。改善購物者體驗並縮短實作時間。透過重設密碼，如果購物者忘記密碼，他們可以使用驗證碼或電子郵件、簡訊中的連結來建立新密碼以重新取得其帳戶存取權。請參閱實作重設密碼。

此功能自 Retail React App 6.0 版本開始，全面開放使用。改善購物者體驗並縮短實作時間。透過無密碼登入，購物者可以安全地使用驗證碼或電子郵件、簡訊中的連結來登入您的網站而不是密碼。請參閱實作無密碼登入。

追蹤同意橫幅全面開放使用於 Retail React App 範本 6.0 或更高版本。保留購物者信任並降低實作成本。透過追蹤同意橫幅，購物者可以在您的網站上選擇加入或退出活動追蹤。請參閱使用追蹤同意橫幅保護隱私。

改善混合式網店的穩定性和效能，確保提供最佳的購物者體驗。請參閱 PWA Kit 3.8.0 版本的混合式網店穩定性升級或 PWA Kit 2.x 版本的混合式網店穩定性升級。

使用購物者情況進行個人化的功能，現已預先整合至 Retail React App 5.0.0 或更高版本。可支援個人化的購物體驗並降低實作成本。透過購物者情況，您可以使用客製化的促銷、定價和產品推薦等功能來提升轉換率和購物者忠誠度。請參閱使用購物者情況進行個人化。

更加全球化！若要藉由與 Hyperforce 地區中的後端執行個體位於同一處來最佳化效能，您現在可以將 Managed Runtime 環境部署到這些地區：

  • sa-east-1：南美洲 (聖保羅)
  • eu-central-2：歐盟 (蘇黎世)
  • eu-south-1：歐盟 (米蘭)
  • ap-southeast-3：亞太地區 (雅加達)
  • me-central-1：中東 (阿拉伯聯合大公國)
  • il-central-1：以色列 (台拉維夫)

之前，您僅能在 Log Center 中檢視與 primary instance group (PIG) 相關的 Production 環境記錄檔。現在，您可以檢視 secondary instance group (SIG) 和 on-demand sandbox (ODS) 執行個體的記錄檔了。這些新記錄檔的數量會計入記錄檔磁碟區限制。

此功能自 PWA Kit 3.7 版本開始，全面開放使用。使用 __server_timing 查詢參數，您可以監控 PWA Kit 網站的效能以支援您的最佳化做法。此參數提供對 Server-Timing HTTP 標頭和記錄檔的存取，這些標頭和記錄檔提供有關伺服器端轉譯程序部分的指標，例如相符的路由、載入元件和擷取策略。Log Center 現在也提供效能指標記錄檔。請參見 __server_timing。

Retail React App 4.0 使用新版的 Commerce SDK React 和 Commerce SDK Isomorphic。這些 SDK 現在滿足 Shopper Login and API Access Service (SLAS) 指南，會在擷取訪客存取權杖時，傳遞 channel_id 作為一個引數。請參閱 Guest Tokens (訪客權杖)。

商店位置搜尋功能現在全面開放使用於 Retail React App 4.0 或更高版本及 Commerce SDK React 2.0.1 或更高版本。透過我們的商店位置搜尋，您的購物者可以根據郵遞區號、城市等資訊找到附近的網店位置。在 Business Manager 中輕鬆延伸您的商店資訊，自訂在您網站上顯示的位置中繼資料。請參閱透過商店位置搜尋來提升店內銷售。

產品搭售方案現在全面開放使用於 Retail React App 4.0 或更高版本及 Commerce SDK React 2.0.1 或更高版本。為使購物者感覺便利和個人化，可以使用產品搭售方案將多樣相關產品組合成一個可訂購的產品。購物者可以直接在購物車內更新搭售方案的款式和數量。例如，線上運動服飾商店可以提供「Runner's Bundle」(跑者搭售方案)，讓購物者能夠直接在購物車中選擇鞋碼、服飾尺寸和健身追蹤器型號。產品搭售方案可以幫助您減少購物車廢棄率並改善庫存管理。請參閱產品搭售方案。

限制為僅有來自 eCDN 的流量才能存取 Managed Runtime 環境。在 eCDN 和環境中設定一個共用的存取控制標頭，以確保購物者、機器人程式、網路爬蟲不能直接存取您的環境。

請參閱已更新的推出您的網店指南和新的 upsertOriginHeaderModification API，瞭解如何設定 Managed Runtime 及 eCDN 來固鎖您環境的詳細資料。

記錄檔新增了命名空間作為前綴，因此在 Log Center 中搜尋時，可以快速找到由你的 PWA Kit 網站所產生的記錄檔。命名空間可精確定位程式碼庫中發生錯誤的特定位置，協助您專注於排解疑難問題。請參閱 Debug Using Log Center (使用 Log Center 偵錯)。

將對 Managed Runtime 環境的存取限制為來自第三方內容傳遞網路 (CDN) 的流量。在您的 CDN 和環境中設定共用存取控制標頭，以確保購物者、機器人程式、檢索器不會直接存取您的環境。

請參閱存取控制標頭和 projects_target_access_control_header_create API，瞭解如何鎖定您的環境。

透過我們在 PWA Kit Retail React App 中提供的大幅改善的產品磚，提高轉換率和購物者參與度，並降低實作成本。產品磚現有功能：

  • 促銷標註
  • 替原價畫上刪除線
  • 用於選擇款式的產品磚色塊
  • 產品徽章
  • 使用具有擴充功能的 productSearch API，與 productSearch 和 getProduct(s) API 的組合相比，其效能有所提升

在 Business Manager (BM) 中，為建立在 B2C Commerce 之上的無頭式或 PWA Kit 網店輕鬆建立網站地圖。網站地圖為搜尋檢索器提供了要索引的頁面和網站階層的指示，有助於提高 SEO 排名。請參閱 Improve SEO with a Sitemap (使用網站地圖改善 SEO)。

PWA Kit 現在支援收集使用中資料訂單指標。使用收集到的內容來瞭解客戶行為，並最佳化您的推銷和市場區隔策略。請參閱 Active Data (使用中資料)。

使用 Runtime Admin 來管理環境變數。此功能可作為使用 Managed Runtime API 管理環境變數的替代方法。環境變數可讓您將變數新增至在某個環境中執行的應用程式程序當中，而無需變更程式碼。請參閱 Environment Variables (環境變數)。

此功能現已正式發佈。

使用 Log Center 針對以 PWA Kit 建置的網站錯誤進行疑難排解：

  • 搜尋、篩選多個記錄檔。檢查歷史記錄檔。
  • 存取單一使用者介面來檢視 Managed Runtime (MRT) 和 B2C Commerce 執行個體的記錄檔。將 MRT 環境中發生的情況與 B2C Commerce 實例中發生的情況聯繫起來。
  • 無需使用 CLI 即可輕鬆查看 MRT 記錄檔。

請參閱 Debug Using Log Center (使用 Log Center 偵錯)。

此功能從 PWA Kit 3.5 版本開始，全面開放使用。查看 GitHub 上的發佈頁面 ，瞭解 PWA Kit 的最新可用版本。

在您的 PWA Kit 網站中啟用 Shopper Login and API Access Service (SLAS) 私人用戶端，以便支援這些功能並縮短實作時間：

  • 無密碼登入
  • 重設密碼
  • 更快的頁面載入速度

請參閱 Use a SLAS Private Client (使用 SLAS 私人用戶端)。

重新部署套件後，得以縮短頁面載入時間。這些內容傳遞網路 (CDN) 的改善可提升應用程式效能：

  • HTTP/3：我們自動對所有支援 HTTP/3 通訊協定的瀏覽器和用戶端使用該協定。HTTP/3 可提高效能，特別是對於使用網路受限裝置 (例如手機) 的購物者。
  • 跨區域 CDN 快取：我們自動在各地區使用快取的回應，以改善全球受眾型網站的快取命中率和效能。
  • 更多 CDN 區域：我們增加了更多區域至 CDN，如果您使用堆疊式 CDN 設定，則會帶來更快的回應時間、更短的網路跳接。

使用 Runtime Admin 來啟用伺服器端 Cookie。此功能可以作為使用 Managed Runtime API 啟用伺服器端 Cookie 的替代方法。使用伺服器端 Cookie 有助於增強隱私和安全性，並支援更量身打造的個人化和行銷。請參閱 Personalize with Cookies (使用 Cookie 進行個人化)。

使用 Runtime Admin 來啟用原始碼對應檔。此功能可以作為使用 Managed Runtime API 啟用原始碼對應檔的替代方法。原始碼對應檔旨在透過提升錯誤堆疊的可讀性，大幅改善開發、偵錯的體驗。請參閱 Debug Using Source Maps (使用原始碼對應檔來偵錯)。

將第三方內容管理系統 (CMS) 與 Storefront Preview 結合使用。舉例來說，若您擁有一個由 CMS 管理的年末檔期特價橫幅，便能使用 Storefront Preview 來查看橫幅將如何在指定期間顯示於您的網站上。請參閱 Storefront Preview (網店預覽)。

根據一或多個客戶群組 ID，預覽您的 Progressive Web App (PWA) Kit 網站外觀。舉例來說，預覽您的網站顯示給享有員工折扣的購物者的樣子。請參閱 Preview Your Storefront (預覽您的網店)。

專案現在可以使用 Node 20 部署！PWA Kit 專案需要升級到最新的 3.4.x 版本，並依照 Upgrade Node Version (升級 Node 版本) 中的指示進行操作。

日本的客戶除了現有的東京區域外，還可以在大阪區域執行其環境。可以透過環境設定變更您的區域。

原始碼對應檔現在可於 Managed Runtime 中使用。這個功能旨在透過提升錯誤堆疊的可讀性，大幅改善開發、偵錯的體驗。從 PWA Kit 3.4.x 開始，可以產生原始碼對應檔，並能切換 enable_source_maps 環境設定來啟用。請參閱 Debug Using Source Maps (使用原始碼對應檔來偵錯)。

在您的 PWA Kit 網站中使用「使用中資料」來觀察產品效能指標，並設定自動推銷規則。請參閱 Active Data (使用中資料)。

使用 Storefront Preview 功能，查看您的 PWA Kit 網站在不同情境下的顯示效果，例如指定來源代碼、客戶群組或特定日期和時間。舉例來說，在將網站變更部署到 Production 環境之前，可以先在 Staging 環境中預覽。請參閱 Storefront Preview (網店預覽)。

當您在 Runtime Admin 中建立環境時，現在可以選擇 Commerce Cloud 執行個體和網站來連接到該環境。這可讓您的 Managed Runtime 環境與 Commerce Cloud 平台之間進行更深入的整合。您還可以使用新的 Managed Runtime API 端點來管理及追蹤該環境與 Commerce Cloud 執行個體的連接。如需更多資訊，請參閱此文件：

若要查看 2023 年 10 月之前發佈的版本注意事項，請參閱：