安装和配置

最近更新： 2026年5月11日

创建对象：

{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

将Product Recommendations部署到店面和管理员需要安装模块并配置Commerce服务连接器。发布更新后，您可以轻松地将安装更新为最新版本。

安装
配置
更新
卸载

安装Product Recommendations install

由于Product Recommendations模块是独立的中继包，因此比Adobe Commerce更频繁地发布更新。为确保您及时了解最新的错误修复和功能，请参阅发行说明。

IMPORTANT

确保您拥有正确的权利以使用产品推荐。

使用编辑器安装magento/product-recommendations模块：

composer require magento/product-recommendations

添加页面生成器支持 pbsupport

页面生成器的Product Recommendations是一个可选模块，需要单独安装。要将Product Recommendations与页面生成器一起使用，请通过运行以下命令来安装模块：

composer require magento/module-page-builder-product-recommendations

通过在页面生成器中启用Product Recommendations，您可以将现有的活动推荐单元添加到在页面生成器中创建的任何内容，例如页面、块和动态块。

有关详细说明，请参阅将 Product Recommendations 与页面生成器内容一起使用。

添加视觉相似性推荐类型 vissimsupport

通过 视觉相似度 推荐类型，您可以将推荐单元部署到产品详细信息页面，该页面显示与正在查看的产品视觉上相似的产品。当产品的图像和视觉方面是购物体验的重要部分时，此推荐类型最有用。通过运行以下命令安装 视觉相似度 推荐类型：

composer require magento/module-visual-product-recommendations

配置Product Recommendations configure

安装magento/product-recommendations模块后，通过指定API密钥并选择SaaS数据空间来配置Commerce Services Connector。

通过配置此连接，可以实现Commerce实例、目录服务和其他支持服务之间的数据同步和通信。数据同步由SaaS Data Export扩展处理。
为确保目录导出可以正确运行，请确认cron作业和索引器正在运行，并且Product Feed索引器设置为Update by Schedule。

成功将Commerce应用程序链接到Commerce Services并指定SaaS数据空间后，将开始目录同步。然后，您可以验证行为数据是否已发送到店面。

监测数据同步并排除其故障

要验证数据同步是否正常工作，请确认已成功从Adobe Commerce导出数据，并且数据已成功传递到连接的Commerce服务。使用部署中的功能板检查这两个步骤。

从导出开始，然后确认投放。

在Commerce管理员中检查同步状态。

转到System > Data Transfer > Data Feed Sync Status。

{width="800" modal="regular"}

同步运行时，馈送数据显示已成功发送的记录。选择信息源以查看详细信息或解决同步问题。
确认数据已传送到“连接的Commerce服务”。

从Commerce管理员转到System > Data Transfer > Data Management Dashboard。

{width="700" modal="regular"}

验证是否显示预期的产品、价格和属性。

TIP

如果数据同步还有其他问题，请参阅查看日志和疑难解答。

NOTE

如果“数据馈送同步状态”页面在Commerce on Cloud或本地部署的Commerce Admin中不可用，请按照扩展安装说明启用它。

更新Product Recommendations安装 update

与所有Adobe Commerce一样，Product Recommendations使用Composer进行安装和更新。要更新magento/product-recommendations模块，请运行以下命令：

composer update magento/product-recommendations --with-dependencies

要更新到主要版本，例如从5.0到6.0，您必须编辑项目的根composer.json文件。（有关最新版本的信息，请参阅发行说明。）例如，让我们打开主composer.json文件并搜索magento/product-recommendations模块：

"require": {
    ...
    "magento/product-recommendations": "^5.0",
    ...
}

让我们将主要版本从5.0增大到6.0：

"require": {
    ...
    "magento/product-recommendations": "^6.0",
    ...
}

保存composer.json文件并运行：

composer update magento/product-recommendations --with-dependencies

或者，如果您已安装magento/module-visual-product-recommendations和magento/module-page-builder-product-recommendations模块：

composer update --with-dependencies magento/product-recommendations magento/module-visual-product-recommendations magento/module-page-builder-product-recommendations

NOTE

在3.x.x版的产品推荐中，您只需要一个API密钥。在版本4.x.x及更高版本中，您必须为沙盒和生产环境提供公共API密钥和私有API密钥。如果您未提供这两对API密钥，则无法在管理员中访问产品推荐功能。但是，数据收集会在您的店面中继续，并且现有推荐将继续向您的购物者显示。

防火墙

要允许产品推荐通过防火墙，请将commerce.adobe.io添加到允许列表。

卸载Product Recommendations uninstall

如有必要，您可以卸载产品推荐模块。

recommendation-more-help

commerce-help-product-recommendations