文档CommerceAEM Assets集成指南

配置集成

Last update: Wed Aug 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 用户

通过将Commerce连接到AEM Assets实例并选择资源同步的匹配策略来配置集成。

识别AEM Assets项目后，选择用于在Adobe Commerce和AEM Assets之间同步资产的匹配规则。

  • Match by product SKU — 将资源元数据中的SKU与Commerce产品SKU匹配的默认规则，以确保资源与正确的产品关联。

  • Custom match — 匹配规则，用于需要自定义匹配逻辑的更复杂方案或特定业务要求。 实施自定义匹配需要在Adobe Developer App Builder中开发自定义代码以定义资源与产品的匹配方式。 更多详细信息即将推出……

对于初始设置，使用默认的​ 按产品SKU匹配 ​规则。

先决条件

  • 配置AEM Assets项目

  • [仅限PaaS]{class="badge informative" title="仅适用于云项目上的Adobe Commerce(Adobe管理的PaaS基础架构)。"} 安装Adobe Commerce包以添加扩展并生成使用该扩展所需的凭据和连接。

  • 按照启用Dynamic Media Open API主题中描述的步骤操作。 请向支持团队提供以下信息：

    • AEM Program ID
    • Adobe Commerce URL
    • AEM Environment ID，
    • 要连接到Commerce的AEM Assets创作环境的​ IMS Org ID。

配置连接

  1. 获取AEM Assets创作环境项目和环境ID。

    1. 打开AEM Cloud Manager并选择​ Assets。

    2. 从URL
      https://author-p[Program ID]-e[EnvironmentID].adobeaemcloud.com/复制并保存项目和环境ID

  2. 从Commerce管理员中，打开AEM Assets集成配置。

    1. 转到​ Store >配置> ADOBE SERVICES > AEM Assets Integration。

      AEM Assets集成启用该集成 {width="600" modal="regular"}

  3. 进入AEM Assets环境​ Program ID ​和​ Environment ID。

    通过从​ Use system value ​中删除所选内容来编辑配置值。

  4. 输入​ Asset Selector IMS Client ID。

    有关资产选择器的详细信息，请参阅手动选择资产

  5. [仅限PaaS]{class="badge informative" title="仅适用于云项目上的Adobe Commerce(Adobe管理的PaaS基础架构)。"}选择Commerce integration以在Commerce和资源匹配服务之间验证请求。

  6. 将​ Commerce integration ​设置为assets-integration以选择要与AEM Assets一起使用的Commerce集成。

  7. 将​ Synchronization enabled ​设置为Yes以允许Commerce接受来自AEM Assets的传入更新。

    启用集成后，可以使用其他配置选项来指定资源匹配条件。

  8. 从​ Asset matching rule ​下拉列表中选择一个资源匹配规则以进行资源同步。

  9. 将为AEM Assets产品SKU定义的Commerce元数据字段名称添加到​ Match by product SKU attribute name ​字段commerce:skus中（默认情况下）。

  10. 选择​ Save Config ​以应用更新并启动资产同步。

    配置更新会触发初始同步过程，从而允许Commerce接受来自AEM Assets的传入更新。 同步所需的时间取决于资产量和特定配置。 该集成利用自动化流程来最大限度地减少同步所需的时间。

同步SLA

该集成保证了以下同步性能级别：

  • < 5 minutes for 99% of updates

  • < 30 minutes for 99.9% of updates

这可确保产品页面始终显示最新的图像，从而保持店面内容的准确且美观。

配置可视化图表所有者

可视化所有者 ​设置确定在集成中提供产品图像的系统：

  • Adobe Commerce — 使用在Commerce中托管的图像。
  • AEM Assets — 使用从AEM同步的图像。

管理员显示该所有者的可用图像，而其余图像则呈灰显状态，并带有​ hidden ​标签。

有关图像显示行为的详细信息，请参阅设置图像详细信息主题。

TIP
从Commerce迁移到AEM Assets期间，请将​ 可视化所有者 ​设置为Commerce以避免图像链接损坏。 成功与AEM Assets同步所有产品后，切换到AEM Assets所有者以完成过渡。 这可以确保映像在整个过程中持续可用。

  1. 导航到​ Store >配置> ADOBE SERVICES > AEM Assets Integration。

    AEM Assets集成可视化所有者功能 {width="400" modal="regular"}

  2. 选择​ 可视化所有者 ​源以显示图像。

  3. 单击​ Save Config ​以应用更新并启动资产同步。

可选。 配置自定义域URL

如果已为AEM Assets as a Cloud Service项目配置了自定义域名，则必须将该域名添加到Commerce存储配置，以便Commerce的AEM Assets集成可以使用该域名。

  1. 导航到​ Store >配置> ADOBE SERVICES > AEM Assets Integration。

    AEM Assets集成启用该集成 {width="700" modal="regular"}

  2. 将​ 自定义域URL ​添加到​ Asset Custom Domain ​字段。

  3. 单击​ Save Config ​以应用更新并启动资产同步。

下一步

管理Commerce资源

recommendation-more-help
7606306b-826c-4603-82d4-2a2c203d5927