DocumentaçãoCommerceGuia do Product Visuals

Configurar a integração

Last update: Wed Jun 18 2025 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.

Pré-requisitos

  • Instalar pacote do AEM Assets

  • [Somente PaaS]{class="badge informative" title="Aplicável a projetos do Adobe Commerce na nuvem somente (infraestrutura do PaaS gerenciada pela Adobe)."} Instale pacotes do Adobe Commerce para adicionar a extensão e gerar as credenciais e conexões necessárias para usar a extensão.

  • Siga as etapas descritas no tópico habilitar API aberta do Dynamic Media. Inclua as seguintes informações para a equipe de suporte:

    • AEM Program ID
    • Adobe Commerce URL
    • AEM Environment ID,
    • IMS Org ID para o ambiente de criação do AEM Assets que você deseja conectar ao Commerce.

Configurar a conexão

  1. Obtenha o Ambiente de Criação do AEM Assets e a ID do ambiente.

    1. Abra o AEM Cloud Manager e selecione Assets.

    2. Copie e salve as IDs de projeto e ambiente da URL:
      https://author-p[Program ID]-e[EnvironmentID].adobeaemcloud.com/

  2. 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"}

  3. Entre no ambiente AEM Assets Program ID e Environment ID.

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

  4. Insira o Asset Selector IMS Client ID.

    Para obter detalhes sobre o Seletor de ativos, consulte Selecionar ativos manualmente

  5. [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.

  6. Defina Integration 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.

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

  8. 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.

  9. 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.

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="600" 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

Gerenciar ativos do Commerce com visuais de produto

recommendation-more-help
347fde3c-0114-4526-b406-0983a1eaa066