Integrar o Widen com o Magento é ligar o DAM, onde as marcas aprovam imagens e vídeos, ao catálogo da loja, onde cada ficheiro tem de ficar atribuído ao produto e à função certa. O Widen Collective chama-se hoje Acquia DAM, e o Magento aparece nas fontes da Adobe sob o nome Adobe Commerce.
Em marcas grandes, os problemas raramente estão na primeira carga. Estão nas dez mil alterações seguintes: ficheiros substituídos, produtos novos, imagens retiradas por questões de licença. Sem regras claras, a loja acumula versões antigas e o DAM deixa de ser a fonte de verdade. A nossa integração de DAM com ecommerce começa por desenhar essas regras.
Este guia reúne os desafios mais comuns, o que a documentação oficial confirma, uma matriz para escolher o desenho e uma lista de verificação.
Que desafios surgem em integrações de Widen com Magento em grande escala?
Cinco aparecem com frequência: volume, nomes de ficheiro, funções de imagem, substituições e permissões. A tabela resume a causa de cada um e a resposta que recomendamos.
| Desafio | Causa | Resposta |
|---|---|---|
| Volume | Muitos ativos e SKUs | Sincronização por lotes e paginada |
| Nomes de ficheiro | Regras livres em cada equipa | Convenção única no DAM |
| Funções de imagem | Todas as funções com a mesma imagem | Campo de função no DAM |
| Substituições | Ficheiro novo, loja desatualizada | Regra de substituição escrita |
| Permissões | Ativos licenciados na loja | Estado de aprovação obrigatório |
Os desafios são de processo antes de serem técnicos. A tecnologia só automatiza o que já está decidido, por isso convém decidir primeiro.
O que existe oficialmente para ligar o Widen ao Magento?
A Acquia lista um conector Adobe Commerce com Acquia DAM, desenvolvido pela The DAM Consultants e classificado como integração de parceiro. Segundo a página da Acquia, instala-se com o Composer, é compatível com as versões Cloud e Community do Adobe Commerce, sem números de versão, e mapeia o SKU, o texto alternativo e as funções de imagem para atributos do DAM.
O conector oferece sincronização única para cargas em massa ou para ativos recentes e uma interface própria para gerir ativos. Os ativos transferidos mantêm as definições de segurança originais, e podem ser servidos da CDN do DAM ou da biblioteca do Magento. Como a página não detalha a manutenção nem as versões, confirme a compatibilidade com a sua instalação antes de decidir.
Que limites tem a API do Widen em catálogos grandes?
A API REST v2 do Acquia DAM Classic autentica por OAuth2, exige uma conta de administrador e devolve, na pesquisa GET /search, no máximo 100 itens por página. Em termos práticos, um DAM com 50 000 ativos exige pelo menos 500 pedidos de pesquisa para ser percorrido por inteiro, número que ilustra o cálculo e não é um dado do Widen.
A consequência é desenhar a sincronização por alterações, e não por varrimento total: pede-se apenas o que mudou desde a última execução, filtrando por metadados. O token de acesso dura uma hora e renova-se com o token de renovação, pelo que uma carga longa tem de o renovar sem parar.
A documentação não indica limites de pedidos por minuto, por isso esse ponto deve ser confirmado com a Acquia antes de dimensionar o calendário da carga inicial. Os metadados XMP e EXIF são editáveis pela API, o que permite marcar cada ativo como já enviado.
Como as funções de imagem do Magento afetam o desenho?
As funções decidem onde cada imagem aparece. Segundo a Experience League da Adobe, a imagem base é a principal do produto e uma versão menor pode aparecer nas listagens ou como miniatura no carrinho.
Por defeito, a primeira imagem carregada fica atribuída às três funções, e a base tem de ser grande o suficiente para o zoom. O Commerce gera os tamanhos necessários a partir da maior imagem carregada, e o tamanho de apresentação define-se na folha de estilos do tema. A Adobe recomenda proporção consistente e uma convenção de nomes.
Para marcas grandes, isto traduz-se numa regra de entrada no DAM: ficheiro sem proporção e sem função não é aprovado para a loja. É mais barato recusar na origem do que corrigir milhares de produtos depois.
Que convenção de nomes e metadados evita problemas?
Uma convenção simples, igual para todas as equipas e verificada à entrada do DAM. A que propomos como ponto de partida junta o SKU, a função da imagem e a ordem, por exemplo SKU, base, 01. É uma proposta nossa, não uma exigência do Magento nem do Widen.
Os metadados acompanham o nome. Cada ativo leva o SKU, a função de imagem, o texto alternativo, o estado de aprovação e, se aplicável, o prazo de licença. Como o Widen permite aplicar modelos de metadados a pastas, os campos obrigatórios podem ser definidos uma vez por pasta de produto, em vez de dependerem da disciplina de cada pessoa.
O ganho aparece nas auditorias. Com SKU e função em metadados, uma pesquisa à API devolve de imediato os produtos sem imagem base ou com a mesma imagem em todas as funções, e a correção faz-se no DAM, que é o sítio certo.
Sincronização única ou contínua?
A escolha depende de quantas alterações a marca faz por semana. A matriz seguinte é o ponto de partida que usamos.
| Desenho | Quando serve | Limitação |
|---|---|---|
| Carga única mais correções | Catálogo estável | Alterações exigem trabalho manual |
| Sincronização agendada | Alterações semanais | Precisa de tabela de correspondência |
| Camada intermédia | Várias lojas, línguas e canais | Custo inicial mais alto |
O conector oficial cobre a carga única e a gestão assistida. Quando a marca precisa de sincronização contínua, estados de aprovação ou várias lojas, normalmente o desenho passa pela API e por uma camada própria. Nesse caso, o custo inicial é maior, mas desaparece o trabalho manual de cada lançamento, e a equipa de marca deixa de depender de quem sabe enviar ficheiros para a loja.
Lista de verificação antes de arrancar o projeto
- Está confirmada a versão do Magento ou Adobe Commerce e o tipo de instalação.
- Os ativos são servidos da CDN do DAM ou da biblioteca do Magento, e a decisão está escrita.
- Existe uma convenção de nomes de ficheiro e uma regra de proporção.
- O campo de função de imagem existe no Widen.
- Cada ativo tem SKU e texto alternativo em metadados.
- O estado de aprovação separa o que pode ir para a loja.
- A sincronização por alterações foi desenhada e as credenciais OAuth2 estão testadas.
- Há uma loja de ensaio com amostra de produtos de várias categorias.
Como trabalhamos na Avafa
Começamos pelas regras de nomes, funções e estados no DAM, porque são elas que decidem o sucesso da carga. Só depois definimos a sincronização e testamos numa loja de ensaio com produtos de várias categorias. Veja o enquadramento na página de integração de DAM com ecommerce e o trabalho de pesquisa orgânica em SEO para Magento.
Guias relacionados do mesmo cluster
Estes guias tratam o Magento com outras soluções de gestão de ativos:
- Brandfolder com Magento: guia de decisão
- Bynder como DAM com Magento
- Canto como solução de DAM para Magento
- CELUM com Magento: produtos e imagens
- OpenText DAM com Magento para catálogos complexos
Perguntas frequentes
O Widen e o Acquia DAM são o mesmo produto?
Sim. A Acquia refere o produto como Acquia DAM, anteriormente Widen Collective.
O conector oficial serve para marcas grandes?
Cobre sincronização única e gestão assistida de ativos. Para sincronização contínua e regras próprias, confirme com o parceiro o que o conector suporta.
Quantos ativos devolve uma pesquisa à API?
No máximo 100 itens por página, segundo a documentação da API. Por isso a sincronização deve paginar e pedir apenas o que mudou.
O Magento gera os tamanhos das imagens?
Sim. Segundo a Adobe, o Commerce gera os tamanhos necessários a partir da maior imagem carregada, pelo que a imagem base deve ter resolução suficiente.
Os ativos mantêm as permissões do DAM?
A página da Acquia indica que os ativos transferidos mantêm as definições de segurança originais. Mesmo assim, só se deve enviar o que está aprovado para a loja.