Integrar o CELUM com o Magento é ligar o sistema onde vivem as imagens, os vídeos e os documentos da marca à loja que os mostra, para que a equipa deixe de carregar ficheiros à mão em cada produto. A página do CELUM sobre esta ligação descreve um seletor de ativos: o utilizador pesquisa no CELUM Cloud e coloca o ficheiro diretamente na loja Adobe Commerce (Magento).
Para uma marca com catálogo grande, a diferença vê-se no trabalho diário: imagens duplicadas, versões antigas que continuam online, fotografias sem os direitos de utilização em ordem. Na Avafa tratamos estes projetos na nossa área de integração de DAM com ecommerce, e este guia resume as opções, os riscos e o que decidir antes de começar.
Vamos ver o que significa a integração, que caminhos técnicos existem, como o Magento recebe as imagens, que dados ficam em cada sistema e uma lista de verificação para validar o projeto.
O que significa integrar o CELUM com o Magento?
Significa que o CELUM passa a ser a origem das imagens e dos vídeos, e o Magento passa a ser o destino que os publica nas fichas de produto e nas categorias. Segundo o site do CELUM, a plataforma tem uma abordagem API-first, com uma API REST, uma UI API e um Widget Toolkit para componentes de interface.
Segundo a página de integração do CELUM, a solução para Adobe Commerce suporta imagens e vídeos de produto, pesquisa rápida de imagens de categoria e ligação de ativos às caraterísticas do produto. A mesma página indica que foi desenvolvida pelo parceiro eCentral e não especifica as versões suportadas do Magento nem o método de autenticação. Confirme por isso, com o CELUM e com o parceiro, se a sua versão está coberta, incluindo o Magento Open Source.
Se a loja é pequena e tem poucas imagens, a integração pode ser demasiado. Compensa quando há muitas referências, várias pessoas a tratar imagens e necessidade de controlar direitos e versões.
Que caminhos existem para ligar os dois sistemas?
Há três caminhos: o seletor de ativos, a importação por API e a ligação desenvolvida à medida. A escolha depende do volume de produtos e de quem trata as imagens.
| Caminho | Como funciona | Quando serve |
|---|---|---|
| Seletor de ativos | Escolhe-se o ficheiro no CELUM, dentro do Magento | Equipas que tratam produto a produto |
| Importação por API | Um processo lê o CELUM e escreve no Magento | Catálogos grandes, atualização em lote |
| Ligação à medida | Projeto sobre as duas APIs | Regras próprias de nomes e direitos |
O seletor é o caminho mais simples, mas depende de alguém escolher cada imagem. A importação por API automatiza o trabalho, mas exige regras claras de correspondência entre o ativo e o SKU.
Como é que o Magento recebe as imagens?
O Magento recebe as imagens pela API REST de produtos, através da lista media_gallery_entries, onde cada ficheiro segue codificado em base64. Segundo a documentação da Adobe para programadores, uma imagem nova enviada para o endpoint de media do produto fica visível em todas as vistas de loja.
A mesma documentação explica o que acontece em cada operação:
- omitir media_gallery_entries, ou enviar null, deixa as imagens existentes como estão;
- enviar uma lista vazia remove todas as entradas da galeria;
- um PUT numa entrada altera a imagem na vista de loja predefinida, e as restantes mantêm o valor por defeito;
- um DELETE remove a imagem de todas as vistas de loja.
O ponto mais perigoso é a lista vazia. Uma sincronização mal desenhada que envie uma lista vazia apaga a galeria inteira de um produto. Teste sempre num ambiente de ensaio e crie uma regra simples: se o CELUM não devolver ativos para um SKU, o processo não envia nada.
Que dados devem ficar no CELUM e quais no Magento?
O CELUM deve mandar em tudo o que é ficheiro, versão e direitos; o Magento deve mandar em tudo o que é comercial. Esta divisão evita que duas equipas corrijam o mesmo dado em sítios diferentes.
| Dado | Sistema mestre | Nota |
|---|---|---|
| Ficheiro aprovado | CELUM | Só a versão final |
| Direitos de utilização | CELUM | Datas e territórios |
| Texto alternativo | CELUM | Revisto por uma pessoa |
| Ordem das imagens | CELUM | Enviada como posição |
| SKU e preço | ERP ou Magento | Nunca no CELUM |
| Visibilidade na loja | Magento | Por vista de loja |
Que riscos tem esta integração e como se evitam?
Os riscos são previsíveis e quase todos se resolvem com regras definidas antes de escrever código:
- Galeria apagada por engano: bloquear o envio de listas vazias e testar em ambiente de ensaio.
- Ativos sem direitos: publicar apenas o que o CELUM marca como aprovado para o canal de loja online.
- Imagens demasiado pesadas: definir antes o formato e o tamanho que a loja deve receber, para não prejudicar o tempo de carregamento.
- SKU sem correspondência: usar uma chave única entre o ativo e o produto; sem ela, a imagem pode ir para o produto errado.
- Duplicados entre sistemas: decidir se o ficheiro vive só no CELUM ou também no Magento, e não manter as duas cópias à mão.
Que passos seguir para planear o projeto?
- Listar os tipos de ativo a publicar: imagem principal, galeria, vídeo, ficha técnica.
- Definir a chave de correspondência entre ativo e SKU.
- Escolher o caminho: seletor, importação por API ou ligação à medida.
- Decidir o que acontece quando um ativo é substituído ou retirado no CELUM.
- Testar num ambiente de ensaio com uma amostra de produtos.
- Lançar por categorias e acompanhar as primeiras semanas.
Lista de verificação antes de arrancar
Esta é a lista que usamos para validar um projeto antes de qualquer desenvolvimento:
- A versão do Magento está confirmada com o CELUM e com o parceiro.
- Existe uma chave única entre ativo e SKU.
- Está definido quem aprova um ativo para a loja.
- O processo nunca envia uma lista de imagens vazia.
- Há regra para ativos retirados ou com direitos expirados.
- O texto alternativo é revisto por uma pessoa.
- O formato e o tamanho das imagens estão acordados com quem gere a loja.
- Há um plano para voltar atrás se a sincronização falhar.
Como trabalhamos na Avafa
Começamos por mapear os ativos, os SKUs e as regras de aprovação, e só depois escolhemos o caminho técnico. Se o catálogo precisa também de otimização para pesquisa, ligamos o projeto à nossa agência de SEO para Magento. Para ver como organizamos projetos de dados de produto em geral, consulte a página sobre integrações de catálogos.
Guias relacionados do mesmo cluster
Se a plataforma ainda não está decidida, ou se está a comparar DAMs, estes guias ajudam:
- CELUM com Adobe Commerce para catálogos multi-país
- Brandfolder com Magento para gestão de marca
- Widen com Magento para marcas grandes
- Canto com Magento no ecommerce
- CELUM com SAP Commerce Cloud no PIM e ERP
Perguntas frequentes
O CELUM tem ligação nativa ao Magento?
Segundo a página de integração do CELUM, existe uma solução para Adobe Commerce desenvolvida pelo parceiro eCentral, descrita como um projeto adaptável. Não é um módulo que se instala sem configuração, por isso deve confirmar o âmbito com o CELUM.
As imagens ficam guardadas no CELUM ou no Magento?
Depende do caminho escolhido. A página do CELUM refere que os ativos podem ficar guardados de forma central no sistema da loja, com gestão de direitos. Decida cedo se mantém uma cópia na loja ou apenas a referência.
Posso enviar vídeos além de imagens?
A página do CELUM indica suporte para imagens e vídeos de produto. Confirme os formatos e os limites de tamanho na sua instalação antes de planear a migração.
O que acontece se alterar uma imagem no CELUM?
Depende de ter sido definido um processo de atualização. Com o seletor, a alteração só chega à loja se alguém voltar a escolher o ficheiro; com uma importação por API, o processo pode substituir a imagem do SKU automaticamente.
Quanto tempo demora um projeto destes?
Não há um prazo fixo. Depende do número de tipos de ativo, das lojas e idiomas, e de quantas regras de aprovação existem. Um piloto com uma categoria costuma mostrar rapidamente onde estão os problemas.