文档CommerceOptimizer Connector

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

快速入门

最近更新： 2026年6月1日

创建对象：

  • {"id":"b5a62a22-46f7-4f0d-b151-3fc640bef588"}
  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

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

IMPORTANT
始终将沙盒Optimizer实例连接到非生产环境，将生产实例连接到生产环境。 不匹配的环境会导致目录数据、搜索结果和推荐不一致。

使用该集成的要求 requirements-to-use-the-integration

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

删除冲突的扩展 remove-conflicting-extensions

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

  • Adobe Commerce Live Search (magento/live-search)
  • Adobe Commerce Product Recommendations (magento/product-recommendations)
  • Adobe Commerce Catalog Service (magento/catalog-service, magento/catalog-service-installer)
  • Data Management Dashboard (magento-catalog-sync-admin)

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

IMPORTANT
如果在启用连接器之前未删除这些扩展，则您可能会看到配置屏幕损坏、Commerce Optimizer中数据重复（因为从连接器和现有扩展中导出相同数据）以及日志中的401或403错误（由于扩展和连接器对连接的服务进行身份验证的方式存在冲突）。
style
shade-box

配置步骤 configuration-steps

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

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

  2. 从管理员​自定义Commerce范围导出配置。

  3. 启用 Commerce Optimizer 集成。

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

安装Adobe Commerce Optimizer Connector包 install-the-adobe-commerce-optimizer-connector-package

Adobe Commerce Optimizer Connector作为编辑器中继资料传递，适用于具有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 内部部署上安装扩展

自定义Commerce范围导出配置 customize-the-commerce-scopes-export-configuration

默认情况下，所有Commerce作用域（网站、客户组和商店视图）均启用目录数据同步。 您可以自定义导出设置，以便根据业务需求仅同步特定范围的数据。 例如，如果您有多个共享相同语言的商店视图，则可以选择仅导出一个商店视图的数据，并将其用作Commerce Optimizer中多个目录视图的目录源。

IMPORTANT
更改导出设置会触发完全重新建立索引，此过程可能需要大量时间，具体取决于您的目录大小。 Adobe建议先将Commerce范围配置为同步到Commerce Optimizer，然后再启用集成并启动初始数据同步。

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

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

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

要更改作用域导出设置

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

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

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

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

  4. 保存更改。

启用和禁用行为

操作
结果
禁用商店视图
禁用同步将从店面中删除目录数据。 目录源仍保留在Commerce Optimizer中，但在下次cron运行时所有同步的数据都将被删除。
禁用并重新启用商店视图
使用完全数据重新同步重新填充同一目录源。

启用Commerce Optimizer集成 enable-the-adobe-commerce-optimizer-integration

通过运行aco:config:init CLI命令启用集成并启动数据同步。 此命令完成以下步骤：

  1. 使用作为命令行参数提供的凭据获取IMS访问令牌。
  2. 在https://ccm.api.commerce.adobe.com/api/v1/tenants/{tenantId}/owner/{orgId}处调用Commerce Cloud Manager (CCM)服务以验证租户并提取引入URL和Commerce Optimizer Studio URL。
  3. 将所有配置（已加密的客户端密钥）保存到core_config_data。
  4. 通过使所有Commerce Optimizer馈送索引器失效来计划初始完全同步。
IMPORTANT
完成配置后，数据同步处理会立即在后台启动。 根据目录的大小，数据同步过程可能需要几分钟到几小时。

获取所需的连接详细信息

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

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

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

从Adobe Developer Console项目页面获取凭据详细信息{width="500" modal="regular"}

获取Commerce Optimizer实例详细信息

从Commerce Optimizer实例Instance details 页面上的​ Instance Id ​字段或用于访问实例的URL获取_​租户ID _。 例如，在https://experience.adobe.com/#/@<your organization>/in:<tenant ID>/commerce-optimizer-studio/home中。

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

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

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

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

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

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

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

验证数据同步是否正常工作 verify-that-the-data-sync-is-working

确认数据已从Commerce管理员成功导出，并且数据已成功提交到Commerce Optimizer。 从Commerce管理员中的导出开始，然后在Commerce Optimizer中确认交付。

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

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

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

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

  2. 确认数据已传送到Commerce Optimizer：

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

    Adobe Commerce Optimizer中的 数据同步页面显示同步的目录数据 {width="700" modal="regular"}

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

当同步按预期工作时：

  • Data Feed Sync Status​显示连接器馈送的成功发送的记录，没有未解析的项目级错误。
  • Commerce Optimizer中的​ Data Sync ​列出了预期的目录源、产品、价格和属性。
TIP
如果数据同步有任何问题，请参阅疑难解答指南。

后续步骤

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

    在Commerce Optimizer用户界面中创建目录视图和策略。 请注意，价格手册是从Adobe Commerce客户组自动创建的。 有关说明，请参阅​ Commerce Optimizer用户指南 ​中的目录视图和策略文档。

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

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

recommendation-more-help
commerce-help-aco-connector