Integrar o Bynder com a BigCommerce é fazer com que as imagens e os vídeos aprovados no DAM cheguem às fichas de produto da loja sem upload manual, mantendo o Bynder como origem única dos ficheiros. Não é uma ligação de um clique: constrói-se com a API do Bynder e a API de catálogo da BigCommerce, ou com um conector de parceiro, e exige decisões sobre URLs, tamanhos e atualizações.
Para uma marca com catálogo grande, a diferença é prática. Se cada produto depende de alguém carregar ficheiros um a um, os erros multiplicam-se: a imagem errada na variante, o vídeo antigo, a foto sem direitos válidos. Na Avafa tratamos este tipo de ligação dentro da nossa área de integração de DAM com ecommerce, e este guia resume o que validar antes de arrancar.
Vamos ver as abordagens possíveis, os limites reais da API da BigCommerce, os passos de implementação, os problemas habituais e uma lista de verificação.
Existe um conector oficial entre o Bynder e a BigCommerce?
Nas páginas de ajuda e de marketplace da Bynder que consultámos, as integrações de comércio descritas em detalhe são a do Salesforce B2C Commerce, a do SAP Commerce Cloud e a do Adobe Commerce (Magento). Não encontrámos aí um conector da BigCommerce mantido pela própria Bynder, pelo que convém confirmar a situação atual no marketplace da Bynder e com o seu contacto comercial antes de orçamentar.
A ajuda da Bynder distingue integrações suportadas pela Bynder e integrações criadas e mantidas por parceiros. Se existir um conector de parceiro, confirme quem dá suporte, que versões cobre e o que acontece quando a API de uma das plataformas muda. Sem conector, a alternativa é uma integração à medida com as duas APIs.
Que abordagens existem para ligar o Bynder à BigCommerce?
Há três caminhos, que se distinguem pela forma como o ficheiro chega à loja e por quem escolhe o ativo.
| Abordagem | Quando faz sentido | Ponto de atenção |
|---|---|---|
| URL do Bynder na ficha | Catálogo grande, muitas atualizações | Limite de 255 caracteres no URL |
| Ficheiro enviado para a BigCommerce | Poucos produtos, controlo total | Duplicação de ficheiros |
| Seletor no front-end headless | Páginas de conteúdo e campanhas | Exige desenvolvimento |
Em qualquer dos casos, a Universal Compact View do Bynder é o componente pronto a usar que permite pesquisar e escolher ativos dentro de outro sistema. Segundo a ajuda da Bynder, quando o utilizador escolhe um ativo, a API devolve os URLs das derivações disponíveis, e é a integração que escolhe o URL a inserir no conteúdo. A derivação de imagem predefinida é a webimage, e a de vídeo é o mp4, com webm também disponível.
Que limites da API da BigCommerce condicionam o projeto?
Segundo a documentação da BigCommerce sobre a criação de imagens de produto, cada imagem, enviada como ficheiro ou referenciada por URL, pode ter até 8 MB. O campo image_url aceita no máximo 255 caracteres, e um produto pode ter até 1000 imagens. Só é possível criar uma imagem por pedido, e image_url e image_file não se usam em conjunto.
Os formatos aceites incluem BMP, GIF, JPEG, PNG, WBMP, XBM e WEBP. A API permite ainda marcar a imagem como miniatura com is_thumbnail e definir a ordem com sort_order, onde um valor mais alto significa menor prioridade de apresentação.
Duas consequências práticas. Primeiro, os URLs longos de CDN, com muitos parâmetros de transformação, podem ultrapassar os 255 caracteres, por isso teste o comprimento real antes de desenhar a regra de URLs. Segundo, a documentação consultada não esclarece se a BigCommerce guarda uma cópia da imagem referenciada por URL. Faça esse teste no seu ambiente, porque decide o que acontece quando o ativo muda no Bynder.
Como se implementa a integração passo a passo?
- Preparar o Bynder. Marque como públicos os ativos e as derivações a usar e crie as derivações para os tamanhos da loja. Segundo a ajuda da Bynder, o componente exige a CDN do Bynder e ativos públicos.
- Criar acesso à API. Crie um cliente OAuth no Bynder e use um utilizador de integração dedicado, ativo e com as permissões do caso de uso, segundo o guia técnico da Bynder.
- Definir a chave de ligação. Escolha o campo que une o ativo ao produto, normalmente o SKU numa metapropriedade do Bynder, e confirme que é único.
- Mapear funções das imagens. Decida qual ativo é miniatura, qual é a imagem principal e qual a ordem das restantes, usando is_thumbnail e sort_order.
- Criar as chamadas à BigCommerce. Envie uma imagem por pedido, respeite o limite de 8 MB e de 255 caracteres no URL e trate os erros de cada pedido.
- Reagir a alterações. Use os webhooks do Bynder para saber quando um ativo muda, em vez de repetir tudo por lotes sem critério.
- Testar com poucos produtos. Valide variantes, ordem das imagens, vídeos e o que acontece ao substituir um ativo no Bynder.
Que problemas surgem e como evitá-los?
- Ativo não público. Não aparece no seletor do Bynder. Verifique o estado do ativo e das derivações no Bynder.
- Tamanhos e formatos inadequados. Um ficheiro acima de 8 MB é rejeitado pela BigCommerce. Crie derivações próprias para a loja em vez de usar o original.
- Produto sem chave de ligação. Se o SKU não existir na metapropriedade, a integração não sabe a que produto associar o ativo. Limpe os dados antes de ligar.
- Ordem das imagens sem regra. Sem regra para sort_order, a imagem principal pode mudar de produto para produto.
- Ativos arquivados enquanto estão em uso. A Bynder indica que o Asset Usage API e o Asset Tracker mostram onde os ativos são usados e que há aviso antes de arquivar ou eliminar um ativo usado num canal externo. Registe a utilização para não deixar imagens partidas na loja.
- Falta de dono do processo. Defina quem corrige uma imagem em falta: a equipa do DAM ou a do catálogo.
Lista de verificação antes de arrancar o projeto
- Confirmar se existe conector oficial ou de parceiro e quem dá suporte
- Medir o comprimento real dos URLs de CDN face ao limite de 255 caracteres
- Testar se a BigCommerce guarda cópia das imagens referenciadas por URL
- Marcar como públicos os ativos e as derivações necessários
- Definir a chave de ligação entre ativo e produto, normalmente o SKU
- Fixar a regra de miniatura, imagem principal e ordem
- Definir o tratamento de variantes e de vídeos
- Testar um conjunto pequeno de produtos antes do catálogo completo
Como trabalhamos na Avafa
Começamos pelo catálogo, não pela ferramenta: que produtos têm ativos, que derivações cada página precisa e quem mantém os metadados. Depois escolhemos a abordagem, testamos o comportamento da API num ambiente separado e só então alargamos o volume. Para ligar DAM, PIM e ERP à sua loja, conheça a nossa agência especializada em integrações de catálogos.
Guias relacionados do mesmo cluster
- Integrar o Bynder com o Salesforce Commerce Cloud
- Integrar o Bynder com o SAP Commerce Cloud
- Integrar o Widen com a BigCommerce
- Integrar o Canto como repositório de assets na BigCommerce
- Integrar a CELUM com a BigCommerce
- Integrar o OpenText DAM com a BigCommerce
Perguntas frequentes
A BigCommerce guarda uma cópia das imagens enviadas por URL?
A documentação consultada não o esclarece. Teste no seu ambiente, porque determina se uma alteração no Bynder chega à loja sem novo pedido à API.
Qual é o tamanho máximo de uma imagem de produto?
Segundo a documentação da BigCommerce, 8 MB por imagem, quer seja enviada como ficheiro quer referenciada por URL.
Quantas imagens pode ter cada produto?
Até 1000 imagens por produto, criadas uma de cada vez, segundo a documentação da API.
Que derivação do Bynder devo usar?
Segundo a ajuda da Bynder, a derivação de imagem predefinida é a webimage. Para a loja, crie derivações com as dimensões e o formato que a ficha de produto exige.
Preciso de um programador para esta integração?
Sem conector pronto, sim. A ligação usa a API do Bynder e a API de catálogo da BigCommerce, e deve ser desenhada e testada com cuidado.