为Adobe Commerce Optimizer配置AEM Assets
仅[SaaS]{class="badge positive" title="仅适用于Adobe Commerce Optimizer项目。"}
适用于Adobe Commerce Optimizer的AEM Assets集成使商家能够将AEM Assets用作产品图像的集中数字资产管理解决方案。 本指南介绍特定于Commerce Optimizer的配置。
与Adobe Commerce (PaaS)或Adobe Commerce as a Cloud Service (ACCS)不同，Commerce Optimizer没有管理员配置UI。 要启用集成，请使用您的Adobe Commerce Optimizer和AEM Assets详细信息创建支持工单。 Adobe支持配置集成并在Assets集成服务中注册您的租户。
下图是Adobe Commerce Optimizer与AEM Assets集成之间的产品同步概述。
此集成有两个主要流程：
-
从AEM Assets：批准、拒绝或删除资源时，事件将通过Adobe管道传输到Assets集成服务。 该服务使用
match-by-SKU（元数据驱动）或自定义匹配器(App Builder)将资源与产品匹配，然后将product-asset映射发送到Commerce Optimizer，在产品中存储这些映射作为产品层。 -
从Adobe Commerce Optimizer：在Commerce Optimizer中更新产品时，事件将通过Adobe管道传输到Assets集成服务。 该服务将任何匹配的资产映射同步回Adobe Commerce Optimizer。
先决条件
在配置集成之前，请确保您具有：
- 具有产品可视化权利或具有Dynamic Media的任何AEM Assets许可证的有效Adobe Commerce Optimizer实例。
- 访问AEM Assets as a Cloud Service环境。
- 同一Adobe IMS组织中的Commerce Optimizer和AEM Assets。
- AEM Assets环境中启用了OpenAPI的Dynamic Media。
入门
要载入与Commerce Optimizer的AEM Assets集成，您必须创建支持票证。
Adobe支持使用您票证中的信息来向Assets集成服务注册您的租户，并配置集成。
在您的支持工单中包含以下信息：
- 在您的 Adobe Commerce OptimizerURL或Commerce Cloud Manager UI中找到 租户IDCommerce Optimizer （实例ID）。
- AEM项目ID。
- AEM环境ID。
- 匹配规则：按SKU或外部匹配器(App Builder)匹配。
- 层：要在其中注册租户的目录层名称。 根据需要指定自定义名称。 否则，将使用默认
AEM-Assets。 - 区域设置：向注册租户的目录源区域设置（例如，
en-US）。
Adobe支持处理您的票证后，配置集成，并且您的租户向Assets集成服务注册。
载入完成后：
-
向Assets集成服务注册：您的Commerce Optimizer租户已使用Adobe Commerce Optimizer租户ID、Assets项目ID、AEM环境ID和租户向AEM集成服务注册。
-
身份验证设置： IMS服务令牌身份验证在Commerce Optimizer和Assets集成服务之间配置，用于安全通信。
-
事件订阅： Assets集成服务订阅了：
- AEM Assets事件（已批准、更新和删除资产）
- Commerce Optimizer目录事件（产品已创建、已更新）
限制
Commerce Optimizer集成具有以下限制：
- 每个商户一个层 - AEM Assets集成支持每个商户一个AEM-Assets层（每个租户一个源）。 目前不支持为每个商家配置多个图层。
- 仅图像 — 集成不支持视频或其他媒体类型。
- 无类别映像 — 类别映像同步不可用。 不支持AEM Assets中用于Assets选择器（UI插入）的类别图像。
- 无多站点区别 — 集成不处理多站点；与产品关联的图像在所有渠道和策略上显示相同。
- 图像位置/排序 — 不支持图像位置和排序。
- 产品必须存在 — 如果Commerce Optimizer中不存在该产品，则不会为该产品 — 资产映射创建层。
- 图层字段覆盖 — 图层中的值覆盖基本目录。 如果在层有效负载中未发送字段，则该字段可能会被空值覆盖。 将专用层用于AEM Assets内容；将现有层重复用于其他目的可能会导致意外的数据丢失。
配置AEM Assets
Commerce Optimizer的AEM Assets安装和配置过程与Adobe Commerce as a Cloud Service相同。 有关完整步骤，请参阅配置AEM Assets项目以支持Commerce元数据。
确保您的AEM Assets环境已准备就绪：
-
AEM Assets配置：配置Commerce元数据配置文件。 请参阅配置元数据配置文件。
-
Dynamic Media启用：验证是否在AEM Assets环境中启用了具有OpenAPI功能的Dynamic Media。
配置AEM Assets
要启用product-asset同步，请配置AEM Assets环境。
步骤1：使用OpenAPI启用Dynamic Media
必须在您的AEM Assets环境中启用具有OpenAPI的Dynamic Media。 产品可视化图表和新的AEM Assets许可证允许您通过Cloud Manager以自助方式启用它。 旧版AEM Assets许可证需要Adobe支持才能启用。 有关启用步骤，请参阅配置AEM Assets项目。
步骤2：可选。 配置Commerce元数据配置文件
在AEM Assets中设置元数据配置文件以存储Commerce特定的元数据。
有关详细说明，请参阅配置元数据配置文件。
步骤3：将元数据应用于资源
将Commerce元数据添加到AEM Assets中的产品图像。
有关字段定义，请参阅AEM Commerce包内容；有关设置步骤，请参阅配置元数据配置文件。
资产必须处于 已批准 状态，数据同步才会触发。 仅保存元数据不会触发事件。
AEM-Assets图层分配给您的目录视图。 如果未指定图层，产品图像数据可能会意外被覆盖。同步
配置完毕后，集成将自动同步product-asset映射。
有关详细信息，请参阅自定义自动匹配。
按SKU匹配工作流示例
将现有资产添加到新产品时的典型流程：
-
在Commerce Optimizer中创建产品（通过API或数据摄取）。 产品最初可能没有图像。
-
在AEM Assets中，打开要映射到产品的资源。
-
将产品SKU添加到 commerce:skus 元数据并分配图像角色（例如，
thumbnail、image）。 -
审批要交付的资产。 这会触发Assets集成服务处理的事件。
-
Assets集成服务将产品映像映射发送到Commerce Optimizer。 Commerce Optimizer中的产品已使用资产中的图像更新。
-
验证图像是否可见。 留出时间让同步完成（通常在几分钟内），然后检查Commerce Optimizer UI中的产品（例如，数据同步或目录视图），或查询店面API(目录服务、实时搜索、店面GraphQL API)以确认图像已返回。
图像角色处理
当一个产品有多个资源使用相同的图像角色时（例如，两个资源具有thumbnail角色），集成确保只有一个资源保留该角色，以避免Commerce Optimizer层出现重复角色和意外的店面行为。
行为：从AEM Assets发送更新时，最近更新的资源将收到图像角色（例如，thumbnail），并且该角色将从具有它的上一个资源中删除。 这样可防止店面中出现重复的图像角色。