Integrar o AEM Assets com o Adobe Commerce serve para que as imagens e outros ativos geridos no AEM apareçam automaticamente nos produtos e categorias da loja. A Adobe descreve a ligação como uma associação por SKU, ou por outros atributos-chave, com atualização e limpeza automáticas quando o ativo muda no AEM.
Para uma marca com milhares de referências, a vantagem é evitar o carregamento manual de imagens em dois sistemas. O DAM passa a ser a origem do ativo e a loja limita-se a mostrá-lo. A condição é ter licenças e versões compatíveis, metadados bem preenchidos e um SKU consistente, tema central da nossa área de integração de DAM com e-commerce.
Este guia resume o que a documentação oficial da Adobe indica a 31-10-2026: o que a integração faz, que requisitos tem, como se configura e que limitações a Adobe assinala. Termina com uma checklist de preparação.
O que faz a integração entre AEM Assets e Adobe Commerce?
A integração liga ativos do AEM Assets a produtos e categorias do Commerce com base no SKU ou noutros atributos-chave, e mantém as imagens atualizadas quando mudam no AEM. Também automatiza a atualização e a limpeza de ativos.
Os merchandisers podem escrever o texto alternativo de cada imagem por vista de loja, e a integração sincroniza esse texto com o campo Label, o campo normal de etiqueta da imagem no Commerce. A partir da versão 1.4.6 da extensão, são também mantidas as funções de imagem personalizadas definidas no AEM Assets, além das quatro funções padrão, e os administradores são avisados no Admin quando há novas versões.
Os metadados do Commerce ficam no AEM Assets, num espaço de nomes, num esquema de metadados e num separador Commerce que a integração acrescenta. A apresentação de imagens de produto numa loja em Edge Delivery Services é opcional e tem de ser ativada à parte.
Que requisitos tem a integração?
Os requisitos dependem do tipo de Adobe Commerce que a empresa usa. A tabela resume o que a Adobe indica.
| Modelo | Versão | Licenças | Configuração |
|---|---|---|---|
| Commerce on Cloud (PaaS) | 2.4.5 ou superior | Não indicadas | Admin do Commerce |
| Commerce as a Cloud Service | Não indicada | Commerce, AEM Assets, Dynamic Media | Admin do Commerce |
| Commerce Optimizer | Não indicada | Incluídas com a plataforma | Pedido ao suporte |
No modelo SaaS, o AEM tem de estar aprovisionado com AEM Assets as a Cloud Service. A Adobe indica que essas licenças acompanham o Adobe Commerce as a Cloud Service e o Commerce Optimizer. A integração é gratuita para comerciantes que cumpram os requisitos de licenciamento. Em todos os casos, o utilizador que configura a integração no Commerce precisa de acesso à organização IMS onde o projeto AEM Assets está aprovisionado.
Como se configura a integração?
A configuração tem cinco passos, segundo a documentação da Adobe, e o primeiro depende da versão do AEM.
- Configurar o projeto AEM Assets para suportar os metadados do Commerce: na versão 2026.5.26309 ou posterior usa-se a configuração self-service; em versões anteriores instala-se manualmente o pacote assets-commerce.
- Apenas no Commerce on Cloud (PaaS), instalar os pacotes do Adobe Commerce que acrescentam a extensão e geram as credenciais e ligações necessárias.
- Configurar as permissões IMS para que o Asset Selector e os campos de Program ID e Environment ID fiquem disponíveis.
- Configurar a integração no Admin do Commerce. No Commerce Optimizer, submete-se um pedido ao suporte com o tenant ID, o Program ID e o Environment ID do AEM, a regra de correspondência, a camada e o idioma.
- Opcionalmente, ativar a apresentação de imagens de produto numa loja em Edge Delivery Services.
No Commerce Optimizer não há interface de configuração no Admin: é o suporte da Adobe que configura a integração, a partir do pedido de onboarding.
Que limitações a Adobe assinala?
A Adobe assinala algumas limitações que convém conhecer desde o início:
- Texto alternativo: a localização do texto alternativo não altera a atribuição de imagens nem o mapeamento da galeria.
- Disponibilidade por vista de loja: é uma capacidade separada e não é coberta pelo fluxo do texto alternativo.
- Commerce Optimizer: tem limitações próprias referidas na documentação, sem detalhe na página consultada.
Estas limitações significam que a integração resolve a ligação entre ativo e produto, mas não resolve sozinha a gestão de imagens por mercado. Se vende em vários países com galerias diferentes, é preciso desenhar essa lógica à parte.
Como preparar SKUs e metadados para a correspondência?
A correspondência automática só funciona se o identificador for igual nos dois sistemas, e esse é o trabalho de preparação mais demorado. Em catálogos antigos é comum encontrar o mesmo produto com códigos diferentes no ERP, no DAM e na loja, ou ficheiros guardados com o nome do fornecedor em vez do SKU.
Antes de configurar a extensão, recomendamos exportar a lista de SKUs do Commerce e a lista de ativos do AEM e cruzá-las. O resultado costuma mostrar três grupos: produtos com ativo e correspondência clara, produtos sem ativo e ativos sem produto. Cada grupo tem uma ação diferente, e resolvê-los antes da ativação evita que a integração arranque com lacunas visíveis na loja.
Convém ainda decidir o que acontece às imagens antigas já carregadas no Commerce. Se a Adobe passa a ser a origem do ativo, as imagens carregadas à mão deixam de ter dono, e a equipa precisa de saber se as mantém, as substitui ou as remove.
Checklist Avafa antes de ativar a integração
Preparar os dados vale mais do que configurar a extensão. Estes são os passos que seguimos:
- Confirmar o tipo de Adobe Commerce em uso e a versão, no caso de PaaS.
- Confirmar as licenças de AEM Assets e de Dynamic Media junto da Adobe.
- Escolher o atributo de correspondência, normalmente o SKU, e verificar que é único e igual nos dois lados.
- Limpar nomes de ficheiros e metadados que contrariem a regra de correspondência.
- Definir as funções de imagem necessárias, além das quatro padrão.
- Planear o texto alternativo por vista de loja e quem o escreve.
- Testar com uma categoria completa, incluindo produtos sem imagem e com variantes.
- Definir quem monitoriza as falhas depois do arranque.
O quarto passo é o que mais atrasa projetos. Ficheiros com nomes inconsistentes, copiados de pastas antigas, quebram a correspondência automática.
Por fim, escolha um responsável para o DAM. Sem alguém que aprove novos ativos, defina regras de nomes e resolva conflitos, a integração automatiza a desorganização que já existia, em vez de a corrigir.
Como trabalhamos na Avafa
Na Avafa tratamos a integração de ativos como um problema de dados. Auditamos os SKUs, os nomes de ficheiro e os metadados antes de ligar sistemas, e registamos o que a Adobe confirma e o que precisa de validação com o fornecedor.
Se está a planear ligar um DAM à sua loja, conheça o nosso serviço de integração de DAM com e-commerce.
Guias relacionados
- Integrar o AEM com Salesforce Commerce Cloud
- Integrar o AEM com BigCommerce
- Integrar o AEM com SAP Commerce Cloud
- Integrar SAP S/4HANA com Adobe Commerce
- Integrar Odoo com Adobe Commerce
Perguntas frequentes
A integração tem custo?
A Adobe indica que a integração é gratuita para comerciantes que cumpram os requisitos de licenciamento. As licenças de Adobe Commerce, AEM Assets e Dynamic Media são independentes.
Que versão do Adobe Commerce é necessária?
No Adobe Commerce on Cloud (PaaS), a versão 2.4.5 ou superior. No modelo as a Cloud Service, a documentação refere licenças em vez de versão.
Como é feita a correspondência entre imagem e produto?
Por SKU ou por outros atributos-chave, segundo a Adobe. Por isso o identificador deve ser único e coerente entre o AEM e o Commerce.
Posso ter texto alternativo diferente por idioma?
Sim, por vista de loja. A integração sincroniza esse texto com o campo Label, mas a localização não altera a atribuição de imagens.
É preciso usar Edge Delivery Services?
Não. A apresentação de imagens de produto numa loja em Edge Delivery Services é um passo opcional que tem de ser ativado separadamente.