DocumentaçãoCommerceGuia de integração do AEM Assets

Configurar a integração

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

Criado para:

  • Usuário

Configure a integração conectando o Commerce à instância do AEM Assets e selecionando a estratégia correspondente para a sincronização de ativos.

Depois de identificar o projeto do AEM Assets, selecione a regra de correspondência para sincronizar ativos entre o Adobe Commerce e o AEM Assets.

  • Match by product SKU — Regra padrão que corresponde ao SKU nos metadados do ativo com o SKU do produto Commerce para garantir que os ativos estejam associados aos produtos corretos.

  • Custom match — Regra de correspondência para cenários mais complexos ou requisitos de negócios específicos que exigem lógica de correspondência personalizada. A implementação da correspondência personalizada requer o desenvolvimento de código personalizado no Adobe Developer App Builder para definir como os ativos são correspondidos aos produtos. Mais detalhes em breve…

Para a configuração inicial, use a regra padrão Corresponder por SKU de produto.

Requisitos

Antes de configurar a Integração do AEM Assets, verifique se você concluiu as seguintes etapas:

IMS e permissões do usuário

Para usar o Seletor de ativos e fornecer uma configuração mais suave no Commerce, as seguintes permissões são necessárias:

ACCS

[Somente SaaS]{class="badge positive" title="Aplicável somente a projetos do Adobe Commerce as a Cloud Service e do Adobe Commerce Optimizer (infraestrutura SaaS gerenciada pela Adobe)."}

A autenticação IMS é habilitada por padrão. Adicione o usuário ao perfil de produto Usuários do AEM Assets DM OpenAPI - entrega no Adobe Admin Console para conceder acesso à camada de entrega do AEM Assets.

Perfil de produto do Admin Console para entrega do AEM Assets {width="600" modal="regular"}

PaaS

[Somente PaaS]{class="badge informative" title="Aplicável a projetos do Adobe Commerce na nuvem somente (infraestrutura do PaaS gerenciada pela Adobe)."}

  1. Habilite o Adobe IMS para Commerce seguindo as instruções do Guia de Administração do Commerce.

  2. Abra um tíquete de suporte para solicitar uma ID de cliente IMS personalizada para o Seletor de ativos.

  3. Adicione o usuário ao perfil de produto Usuários do AEM Assets DM OpenAPI - entrega no Adobe Admin Console para conceder acesso à camada de entrega do AEM Assets.

Configurar a conexão

  1. No Administrador do Commerce, abra a configuração da Integração do AEM Assets.

    1. Vá para Store > Configuração > ADOBE SERVICES > AEM Assets Integration.

      A Integração do AEM Assets habilita a integração {width="600" modal="regular"}

INFO
A integração do AEM Assets só oferece suporte à configuração no escopo global (padrão). Não há suporte para a configuração no nível do site. Ao tentar configurar a integração no nível do site, o sistema ignora as configurações no nível do site e usa os valores de configuração global.

  1. [Somente PaaS]{class="badge informative" title="Aplicável a projetos do Adobe Commerce na nuvem somente (infraestrutura do PaaS gerenciada pela Adobe)."} Insira o Asset Selector IMS Client ID.

    Essa ID é necessária para habilitar o Seletor de ativos e preencher automaticamente os campos ID do programa e ID do ambiente. Consulte IMS e permissões de usuário para obter essa ID. Para obter detalhes sobre o Seletor de ativos, consulte Selecionar ativos manualmente.

  2. Selecione o ambiente AEM Assets Program ID e Environment ID nos menus suspensos.

    Os menus suspensos são preenchidos automaticamente com base na sessão IMS do usuário. Para usar este recurso, verifique se você tem o IMS e as permissões de usuário corretos.

    Se os menus suspensos não estiverem disponíveis, você poderá inserir as IDs manualmente na URL do AEM Cloud Manager: https://author-p[Program ID]-e[EnvironmentID].adobeaemcloud.com/

    Edite os valores de configuração removendo a seleção de Use system value.

  3. [Somente PaaS]{class="badge informative" title="Aplicável a projetos do Adobe Commerce na nuvem somente (infraestrutura do PaaS gerenciada pela Adobe)."} Selecione o Commerce integration para solicitações de autenticação entre o Commerce e o serviço de correspondência de ativos.

  4. Defina Synchronization enabled como Yes para permitir que o Commerce aceite atualizações de entrada do AEM Assets.

    Depois de habilitar a integração, opções de configuração adicionais estão disponíveis para especificar os critérios de correspondência de ativos.

  5. Selecione uma das regras de correspondência de ativos para sincronização de ativos na lista suspensa Asset matching rule.

  6. Adicione o nome do campo de metadados do AEM Assets definido para SKUs de produtos Commerce no campo Match by product SKU attribute name, commerce:skus por padrão.

  7. Selecione Save Config para aplicar atualizações e iniciar a sincronização de ativos.

    A atualização de configuração aciona o processo de sincronização inicial, permitindo que o Commerce aceite atualizações recebidas do AEM Assets. O tempo necessário para a sincronização depende do volume de ativos e de configurações específicas. A integração utiliza processos automatizados para minimizar o tempo necessário para a sincronização.

SLA de sincronização

A integração garante os seguintes níveis de desempenho de sincronização:

  • < 5 minutes for 99% of updates

  • < 30 minutes for 99.9% of updates

Isso garante que as páginas de produtos sempre exibam as imagens mais atualizadas, mantendo o conteúdo da vitrine eletrônica preciso e visualmente atraente.

Configurar o proprietário da visualização

A configuração Proprietário da visualização determina qual sistema fornece imagens de produto na integração:

  • Adobe Commerce - Usa imagens hospedadas no Commerce.

  • AEM Assets - Usa imagens sincronizadas do AEM.

O Administrador exibe as imagens disponíveis para esse proprietário, enquanto o restante das imagens é esmaecido e exibido com um rótulo oculto.

Consulte o tópico definir detalhes da imagem para obter detalhes sobre o comportamento de exibição da imagem.

TIP
Durante a migração do Commerce para o AEM Assets, defina o Proprietário da visualização como Commerce para evitar links de imagens quebradas. Depois que todos os produtos forem sincronizados com o AEM Assets, alterne para o proprietário do AEM Assets para concluir a transição. Isso garante a disponibilidade contínua da imagem em todo o processo.

  1. Navegue até Store > Configuração > ADOBE SERVICES > AEM Assets Integration.

    Recurso do proprietário da visualização de Integração do AEM Assets {width="400" modal="regular"}

  2. Selecione a origem Proprietário da Visualização para exibir as imagens.

  3. Clique em Save Config para aplicar atualizações e iniciar a sincronização de ativos.

Opcional. Configurar o URL do domínio personalizado

Se o projeto AEM Assets as a Cloud Service tiver sido configurado com um Nome de domínio personalizado, adicione o nome de domínio à configuração de armazenamento do Commerce para que a integração do AEM Assets para Commerce possa usá-lo.

  1. Navegue até Store > Configuração > ADOBE SERVICES > AEM Assets Integration.

    A Integração do AEM Assets habilita a integração {width="700" modal="regular"}

  2. Adicione a URL de Domínio Personalizado ao campo Asset Custom Domain.

  3. Clique em Save Config para aplicar atualizações e iniciar a sincronização de ativos.

Próxima etapa

recommendation-more-help
ca3e43e7-8fc7-412c-9d52-80a723c40cea