文档CommerceAdobe Commerce Optimizer Connector集成指南

[仅限PaaS]{class="badge informative" title="仅适用于云项目（Adobe管理的PaaS基础架构）和内部部署项目上的Adobe Commerce 。"}

快速入门

Last update: Thu Mar 19 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 用户

安装并配置Commerce Optimizer Connector以将您的Adobe Commerce目录数据与Adobe Commerce Optimizer同步，然后监视数据同步状态以确保您的店面为最新状态。

使用该集成的要求

配置集成的Adobe Commerce用户必须具有：

recommendation-more-help

先决条件

如果已安装以下任何扩展，请在安装Commerce Optimizer Connector之前卸载它们：

  • Adobe Commerce Live Search (magento/live-search)
  • Adobe Commerce产品推荐(magento/product-recommendations)
  • Adobe Commerce目录服务(magento/catalog-service， magento/catalog-service-installer)
  • 数据管理仪表板(magento-catalog-sync-admin)

与这些扩展关联的数据仍会在Commerce数据库中可用。 但是，在启用连接器时，它不会导出到Adobe Commerce Optimizer。 要在启用连接器后实施这些扩展提供的搜索和促销功能，请从Adobe Commerce Optimizer 管理员UI配置它们。

style
shade-box

配置步骤

按照以下步骤启用连接器并开始将数据从Commerce同步到Adobe Commerce Optimizer实例。

  1. 使用编辑器安装Commerce Optimizer连接器包​以将您的Commerce实例连接到Adobe Commerce Optimizer。

  2. 从管理员查看和自定义数据导出配置。

  3. 获取在Commerce和Commerce Optimizer之间建立连接所需的API凭据。

  4. 启用 Adobe Commerce Optimizer 集成。

  5. 验证数据同步是否正常工作。

安装Commerce Optimizer连接器软件包

Adobe Commerce Optimizer Connector是作为编辑器中继提供的，适用于具有Adobe Commerce Optimizer的有效许可证的所有Commerce商家。

安装步骤

  1. 使用编辑器添加adobe-commerce/commerce-data-export-aco-adapter模块：

    code language-shell 
    composer require adobe-commerce/commerce-data-export-aco-adapter

  2. 将更改部署到Adobe Commerce暂存环境。

部署完成后，Commerce Optimizer选项可从Commerce的“管理员”菜单使用。 单击​ Commerce Optimizer ​以直接从Commerce管理员中打开您的Commerce Optimizer实例。

NOTE
有关详细的扩展安装说明，请参阅以下指南：
在云基础架构上的Adobe Commerce上安装扩展
在Adobe Commerce内部部署上安装扩展

获取所需的连接详细信息

从Adobe Developer Console中，创建一个为Adobe Commerce Optimizer摄取服务启用的开发人员项目，并生成OAuth服务器到服务器凭据。 有关详细说明，请参阅促销开发人员指南中的​获取IMS凭据。

TIP
如果您在与您的Commerce Optimizer实例相同的IMS组织中已经使用数据摄取API配置了开发人员项目，则可以重用现有的OAuth服务器到服务器凭据。

从“身份证明”页中保存以下值：

  • 组织ID (org_id)
  • 客户端ID (client_id)
  • 客户端密码 (client_secret)

获取Adobe Commerce Optimizer实例详细信息

从您的Adobe Commerce Optimizer实例中保存实例ID（也称为租户ID）。 您可以在用于访问实例的URL中找到它。 例如，在https://experience.adobe.com/#/@<project-id>/in:TToyu73daQRn66KAYaq8YZ/commerce-optimizer-studio/home中，实例ID为TToyu73daQRn66KAYaq8YZ。

自定义Commerce数据导出配置

默认情况下，所有Commerce作用域（网站和商店视图）的目录数据同步处于启用状态。 您可以自定义导出设置，以便根据业务需求仅同步特定范围的数据。 例如，如果您有多个存储视图，但只想导出其中一个存储视图的数据，则可以为其他存储视图禁用导出程序。

IMPORTANT
更改导出设置会触发完全重新建立索引，此过程可能需要大量时间，具体取决于您的目录大小。 在低流量期间计划这些更改，以最大程度地降低对性能的影响。

按范围导出数据

下表描述了在每个作用域级别导出的数据：

范围
数据已导出
注释
网站
价格和价格手册
使用命名约定将每组价格导出为价格手册website::customergroupcode。 包括该网站的所有客户组。
商店视图
产品和产品属性
每个存储视图在Adobe Commerce Optimizer中创建一个单独的目录源。

启用和禁用行为

操作
结果
禁用商店视图
目录源仍保留在Adobe Commerce Optimizer中，但已删除所有数据。
禁用并重新启用商店视图
使用完全数据重新同步重新填充同一目录源。

更新导出配置

安装连接器软件包后，管理员中的商店网格现在会显示Commerce Optimizer的导出配置设置。

具有Commerce Optimizer同步设置的商店网格 {width="600" modal="regular"}

要更改网站或商店视图的设置：

  1. 在Commerce管理员中，导航到​Stores > Settings > All Stores。

  2. 选择要配置的网站或商店视图。

  3. 在​ Adobe Commerce Optimizer导出程序设置 ​中，根据需要使用该复选框启用或禁用数据同步。

    更新数据同步配置 {width="500" modal="regular"}

  4. 保存更改。

启用Adobe Commerce Optimizer集成

IMPORTANT
运行配置命令后，数据同步处理便会立即启动。 默认情况下，所有Commerce作用域（网站和商店视图）的目录数据同步处于启用状态。 根据目录的大小，数据同步过程可能需要几分钟到几小时。

使用您在上一步中收集的API凭据和实例详细信息，您现在可以配置Commerce与Adobe Commerce Optimizer实例之间的集成。

  1. 从Commerce Admin中，选择​ Adobe Commerce Optimizer ​以显示包含说明的配置页面。

    Adobe Commerce Optimizer配置页面 {width="500" modal="regular"}

  2. 从命令行中，使用SSH连接到Commerce暂存环境。

  3. 运行以下Commerce CLI命令配置集成，将占位符值替换为Commerce Optimizer项目的值：

bin/magento aco:config:init --org_id=your-org --tenant_id=your-tenant --client_id=your-client-id --client_secret=your-secret

  1. 通过返回Commerce管理员并选择Adobe Commerce Optimizer选项来验证连接。

    单击该选项后，它将在新选项卡中打开Adobe Commerce Optimizer UI。

验证数据同步是否正常工作

启用集成后，数据同步将自动开始。 根据目录大小，初始同步可能需要几分钟到几小时。

  1. 在Commerce管理员中检查同步状态：

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

    带有馈送项状态报告的数据馈送同步状态页面 {width="500" modal="regular"}

    同步运行时，馈送数据显示已成功发送的记录。 选择信息源以查看详细信息或解决同步问题。

  2. 确认数据已送达Commerce Optimizer：

    从Adobe Commerce Optimizer菜单中选择​Data Sync。

    数据同步 {width="500" modal="regular"}

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

TIP
如果您遇到数据同步问题，请参阅SaaS数据导出文档中的​ 疑难解答 ​部分。

后续步骤

  1. 配置 Adobe Commerce Optimizer 目录视图和策略

    在Adobe Commerce Optimizer指南中创建目录视图和策略。 请注意，价格手册是自动从Adobe Commerce客户组创建的。

  2. 在Edge Delivery Services上设置Commerce店面

    按照Storefront设置文档将您的店面连接到Adobe Commerce Optimizer实例，并开始提供个性化的商务体验。

cf27535d-4512-41b7-913a-eb3d6bdca96b