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

为B2B Commerce设置连接器

最近更新： 2026年10月1日

创建对象：

中级
管理员
开发人员

使用Adobe Commerce B2B共享目录的商家可以使用Adobe Commerce Optimizer Connector for B2B将自定义共享目录数据和配置同步到Adobe Commerce Optimizer。

IMPORTANT

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

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

已安装并启用Adobe Commerce B2B版本1.5.3+的Commerce 2.4.8+。
具有已设置的沙盒实例的Commerce Optimizer许可证。
身份验证密钥以使用编辑器下载连接器元包。
管理员访问Commerce Optimizer 沙盒实例。

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

Commerce管理员的管理员访问权限。
对 Adobe Commerce 应用程序服务器的命令行访问权限。
开发人员对配置了Commerce Optimizer项目的IMS组织的访问权限。

应用程序要求

Commerce cron和索引器运行正常。
为导出标识的所需网站和存储视图。
在Adobe Commerce中配置或准备配置的共享目录、公司分配、分类和B2B定价。

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

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

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。要在启用连接器后实施这些扩展提供的Adobe Commerce搜索和促销功能，请从Commerce Optimizer 管理员UI配置它们。

IMPORTANT

在启用连接器之前无法删除这些扩展会导致配置屏幕损坏、Commerce Optimizer中的数据重复，以及401或403身份验证错误。

style

shade-box

配置步骤 configuration-steps

要启用Adobe Commerce Optimizer Connector for B2B并开始将自定义共享目录配置从Adobe Commerce同步到Commerce Optimizer实例，请执行以下步骤。

使用编辑器安装 Adobe Commerce Optimizer Connector for B2B 包以将您的Adobe Commerce实例连接到Commerce Optimizer。
从管理员自定义Commerce范围导出配置。
启用 Commerce Optimizer 集成。
验证数据同步是否正常工作。

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

Adobe Commerce Optimizer Connector for B2B作为可用于所有Commerce商家（具有Commerce Optimizer的有效许可证）的Composer元包进行交付。

安装步骤

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

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

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

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

NOTE

有关详细的扩展安装说明，请参阅以下指南：

在云基础架构上的 Adobe Commerce 上安装扩展

在 Adobe Commerce 内部部署上安装扩展

数据导出和范围映射

选择要同步的网站和存储视图，然后验证初始馈送。对于B2B，连接器在将共享目录数据项目到Commerce Optimizer时使用启用的范围。

→目录源存储视图和本地化的产品内容
网站和客户组→网站和客户组定价的价格手册
共享目录→受保护的专用目录视图和强制的策略

共享目录定义产品分类，每个启用的商店视图都提供本地化的目录源。网站和客户组确定适用的价格手册。连接器会为每个启用的存储视图投影每个自定义共享目录，因此您不需要B2B投影的单独范围设置。

自定义共享目录可以生成多个受保护的专用目录视图，每个视图对应一个启用的存储视图。默认的公共共享目录未投影为B2B专用目录视图。有关详细的对象映射和运行时授权流程，请参阅B2B共享目录投影。

IMPORTANT

更改导出设置会触发完全重新索引，此过程可能需要花费大量时间，具体取决于您的目录大小。在启用集成并启动初始数据同步之前配置Commerce范围。

要更改作用域导出设置

在Commerce管理员中，转到Stores > Settings > All Stores。
选择要配置的网站或商店视图。
在 Commerce Optimizer导出程序设置 中，根据需要使用该复选框启用或禁用数据同步。

{width="500" modal="regular"}
保存更改。

启用和禁用行为

操作

结果

禁用商店视图

禁用同步将从B2B店面中删除目录数据。 目录源仍保留在Adobe Commerce Optimizer中，但在下次cron运行时所有同步的数据都将被删除。

禁用并重新启用商店视图

使用完全数据重新同步重新填充同一目录源。

监视B2B共享目录更改

连接器会监视对共享目录和公司分配的更改。当您在Commerce管理员中删除共享目录时，连接器会在可配置的宽限期之后删除对其专用目录视图的访问权限。

NOTE

删除宽限期默认为七天。您可以通过更新目录视图同步设置配置来更改它。请参阅目录视图同步状态配置。

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

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

使用作为命令行参数提供的凭据获取IMS访问令牌。
在https://ccm.api.commerce.adobe.com/api/v1/tenants/{tenantId}/owner/{orgId}处调用Commerce Cloud Manager (CCM)服务以验证租户并提取引入URL和Commerce Optimizer Studio URL。
将所有配置（已加密的客户端密钥）保存到core_config_data。
通过使所有Commerce Optimizer馈送索引器失效来计划初始完全同步。

IMPORTANT

完成配置后，数据同步处理会立即在后台启动。根据目录的大小，数据同步过程可能需要几分钟到几小时。

获取所需的连接详细信息

从Adobe Developer Console，创建一个启用Commerce Optimizer引入服务的新项目并生成OAuth服务器到服务器凭据。有关详细说明，请参阅 Adobe Commerce Optimizer促销开发人员指南 中的获取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>/commerce-optimizer-studio/home中。

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

{width="500" modal="regular"}
从命令行中，使用SSH连接到Adobe Commerce暂存环境。

要配置集成，请运行以下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`

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

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

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

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

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

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

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

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

从Commerce Optimizer菜单中选择Data Sync。

Adobe Commerce Optimizer中的 {width="700" modal="regular"}

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