Composable Storefront 版本说明

这些发行说明包括对 Progressive Web App (PWA) Kit 和 Managed Runtime 的更新。

PWA Kit 网店现在可以将互动事件发送到 Data Cloud，从而增强对实时、统一客户数据的可见性。请参阅 将 PWA Kit 与 Data Cloud 集成。

使用基于表的分页新格式，在运行时管理 UI 中的重定向效率更高，使您可以提前查看更多重定向信息。请参阅 重定向。

现在，环境中的部署失败提供了更详细的信息，使你能够更清楚地了解要采取的纠正措施。请参阅包 推送错误疑难解答。

ap-south-2 区域 （海得拉巴） 现在支持环境。请参阅 支持的区域列表。

还解决了各种运行时管理错误：

• 修复了通过 Runtime Admin 连续添加多个环境变量的问题
• 修复了通过 Runtime Admin 删除访问控制标头的问题
• 修复了 Base64URL 的网店预览解码

在 B2C Commerce 版本 25.3 中，混合身份验证 （auth） 取代了插件 SLAS。Hybrid Auth 通过将功能直接移入 B2C Commerce 平台，提高了混合网店的性能和稳定性。请参阅 使用混合身份验证配置混合网店。

您现在可以使用 Node 22! 部署 PWA Kit 项目。要更新 Node.js 版本，请按照升级 Node 版本中的说明操作。

每年，Node.js 版本都会停止正式支持。为了确保强大的安全状态和流畅的开发人员体验，我们限制部署到 Managed Runtime 的项目 Node 版本。Node 18 的终止日期为 2025 年 9 月 1 日。

我们强烈建议您在终止日期之前升级生产环境 (Production) 项目。根据您的 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 查看与主实例组 (PIG) 实例关联的生产环境 (Production) 的日志。现在，您可以查看次要实例组 (SIG) 和按需沙盒 (ODS) 实例的日志。这些新日志计入日志量限制。

该功能从 PWA Kit 3.7 版开始基本可用。使用 __server_timing 查询参数，您可以监控 PWA Kit（PWA 套件）站点的性能，以支持您的优化工作。该参数提供对 Server-Timing HTTP 标头和日志的访问，这些标头和日志提供有关服务器端渲染过程的各个部分的指标，例如路由匹配、组件加载和获取策略。绩效度量日志也可以在 Log Center 查看。请参见 __server_timing。

Retail React App 4.0 版使用新版本的 Commerce SDK React 和 Commerce SDK Isomorphic。这些 SDK 现在满足购物者登录和 API 访问 (SLAS) 指导，以便在检索访客访问令牌时将 channel_id 作为参数传递。请参阅访客令牌。

实体店地址搜索通常适用于 Retail React App 4.0 版或更高版本以及 Commerce SDK React 2.0.1 版或更高版本。使用我们的实体店地址搜索，您的购物者可以根据他们的邮政编码、城市等找到附近的店面位置。轻松扩展 Business Manager 中的商店信息，以自定义您网站上显示的位置元数据。请参阅使用实体店地址搜索提高店内销售量。

产品套装通常适用于 Retail React App 4.0 版或更高版本以及 Commerce SDK React 2.0.1 版或更高版本。使用产品套装将多个相关产品组合为一个可订购产品，以方便购物者并实现个性化。购物者可以直接在购物车中更新套装变体和数量。例如，在线运动服装店可以提供“跑步者套装”，以便购物者可以直接在购物车中选择鞋子尺码、服装尺码和健身追踪器型号。产品套装可以帮助您减少购物车放弃率并改善库存管理。请参阅产品套装。

将对 Managed Runtime 环境的访问限制为来自 eCDN 的流量。在 eCDN 和环境中设置共享访问控制标头，以确保购物者、机器人和爬虫不会直接访问您的环境。

有关如何配置 Managed Runtime 和 eCDN 以锁定环境的详细信息，请参阅更新的启动您的网店指南和新的 upsertOriginHeaderModification API。

通过在 Log Center 搜索作为日志前缀添加的名称空间，快速查找由您的 PWA Kit 站点生成的日志。名称空间可以精确定位发生错误的代码库的特定部分，帮助您集中精力进行故障排除。请参阅使用 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 排名。请参阅使用站点地图改进 SEO。

PWA Kit 现在支持收集动态数据 (Active Data) 订单指标。使用此集合来了解客户行为并优化您的商品推销和细分策略。请参阅动态数据 (Active Data)。

使用 Runtime Admin 管理环境变量。此功能可作为使用 Managed Runtime API 管理环境变量的替代方案。环境变量能让您将变量添加到在环境中运行的应用程序进程中，而无需更改代码。参阅环境变量。

此功能现已正式发布。

使用 Log Center 排查使用 PWA Kit 构建的网站中的错误：

• 搜索并筛选多个日志。检查历史日志。
• 访问单个用户界面以查看来自 Managed Runtime 和 B2C Commerce 实例的日志。将 MRT 环境中发生的情况与 B2C Commerce 实例中发生的情况联系起来。
• 无需使用 CLI 即可轻松查看 MRT 日志。

请参阅使用 Log Center 排除故障。

该功能从 PWA Kit 3.5 版开始基本可用。查看 GitHub 上的发布页面，了解 PWA Kit 的最新可用版本。

在您的 PWA Kit 网站中启用 Shopper Login and API Access Service (SLAS) 私人客户端，这样您就可以在缩短实施时间的情况下支持这些功能：

• 无密码登录
• 密码重置
• 更快的页面加载时间

请参阅使用 SLAS 私人客户端。

重新部署软件包后，可缩短页面加载时间。这些内容分发网络 (CDN) 增强功能可提高应用性能：

• HTTP/3 — 我们会自动为所有支持 HTTP/3 协议的浏览器和客户端使用该协议。HTTP/3 可提高性能，尤其是对于使用网络受限设备（如移动设备）的购物者而言。
• 跨区域 CDN 缓存 — 我们会自动跨区域使用缓存响应，以提高全球受众站点的缓存命中率和性能。
• 更多 CDN 区域 — 我们向 CDN 添加了更多区域，如果您使用堆叠 CDN 设置，则可以缩短响应时间并缩短网络跳数。

使用 Runtime Admin 启用服务器端 Cookies。此功能可作为使用 Managed Runtime API 启用服务器端 Cookies 的替代方法。使用服务器端 Cookie 可以帮助您增强隐私和安全，并支持更加有针对性的个性化和营销。请参阅使用 Cookies 进行个性化设置。

使用 Runtime Admin 启用源映射。此功能可作为使用 Managed Runtime API 启用源映射的替代方法。源映射旨在通过增强错误堆栈的可读性来大大改善开发和调试体验。请参阅使用源映射排除故障。

将第三方内容管理系统 (CMS) 与 Storefront Preview 整合使用。例如，如果您有一个由 CMS 管理的假日促销横幅，请使用网店预览查看横幅在指定时间段内如何显示在您的网站上。请参阅网店预览。

根据一个或多个客户组 ID 预览您的 Progressive Web App (PWA) Kit 站点的外观。例如，预览获得员工折扣的购物者会看到的站点。查看预览您的网店。

项目现在可以使用 Node 20! 进行部署 PWA Kit 项目需要升级到最新的 3.4.x 版本并按照升级 Node 版本 中的说明进行操作。

除了现有的东京地区之外，日本客户现在可以在大阪地区运行他们的环境。您的地区可以通过环境设置进行更改。

源映射现在可在 Managed Runtime 中使用。此功能旨在通过增强错误堆栈的可读性来大大改善开发和调试体验。从 PWA Kit 3.4.x 开始可以生成源映射，并且可以通过切换 enable_source_maps 环境设置来启用。请参阅使用源映射排除故障。

使用 PWA Kit 站点中的动态数据 (Active Data) 观察产品性能指标并设置自动销售规则。请参阅动态数据 (Active Data)。

使用 Storefront Preview 功能查看 PWA Kit 站点在不同环境下（例如指定源代码、客户组或特定日期或时间）的外观。例如，在将站点更改部署到生产环境 (production) 之前，先在准备环境 (Staging) 中预览。请参阅网店预览。

在 Runtime Admin 中创建环境时，您现在可以选择 Commerce Cloud 实例和要连接到该环境的站点。这允许 Managed Runtime 环境与 Commerce Cloud 平台之间进行更深入的集成。您还可以使用新的 Managed Runtime API 端点来管理和跟踪环境与 Commerce Cloud 实例的连接。有关更多信息，请参阅此文档：

• 创建环境
• Managed Runtime API 教程
• cc_b2c_organization_info_retrieve（2023 年 11 月 8 日之前可能已过期或不可用）
• cc_b2c_target_info_retrieve（2023 年 11 月 8 日之前可能已过期或不可用）
• cc_b2c_target_info_partial_update（2023 年 11 月 8 日之前可能已过期或不可用）

有关 2023 年 10 月之前发布的版本说明，请参阅：

• PWA Kit 版本说明
• Managed Runtime 版本说明

j

入门指南

组合型网店简介

在混合实施中使用可组合网店

PWA Kit 框架

成功的技巧

Ask the Community

设置

构建站点

启用您的商家团队

测试、启动和监视

维护

升级 Node 版本

升级到 v3

升级至 v2.3

升级至 v2

版本说明

中文

日本語

中文

繁體中文

Français

Deutsch

Italiano

한국어

Português

Español (México)