Integrar Bynder com Salesforce Commerce Cloud: guia prático

Integrar o Bynder com o Salesforce Commerce Cloud (SFCC) é ligar a biblioteca onde a marca aprova imagens e vídeos ao catálogo e às páginas da loja, para que cada produto mostre o ficheiro certo sem copiar ficheiros à mão. Segundo a ajuda da Bynder, a ligação faz-se através de uma cartridge que permite usar ativos do DAM em páginas e catálogos sem sair do Salesforce.

Para a empresa, o ganho está na consistência. Quando uma imagem é substituída no DAM, a loja deve refletir a mudança sem retrabalho. Quando isso falha, aparecem fotografias antigas nas fichas de produto, versões diferentes por canal e equipas a pedir ficheiros por email. Na Avafa tratamos esta ligação dentro da nossa área de integração de DAM com ecommerce, e este guia resume o que decidir antes de arrancar.

Vamos ver o que a integração faz, que perfis a usam, como se configura, quando escolher a cartridge ou uma arquitetura headless, que problemas esperar e que pontos validar antes de começar.

O que faz a integração entre o Bynder e o Salesforce B2C Commerce?

Liga o DAM ao catálogo e às páginas da loja. Os merchandisers associam ativos a produtos e categorias, e os responsáveis de marketing inserem imagens e vídeos nas páginas através do Page Designer. Na listagem do Bynder Marketplace, esta integração aparece como desenvolvida e suportada pela própria Bynder, e sincroniza URLs de referência e metapropriedades do Bynder para o catálogo de produtos do Salesforce.

Há um limite que convém conhecer desde o início. Segundo a documentação da Bynder, a sincronização é feita num só sentido, do Bynder para o Salesforce. Nada é carregado do Salesforce de volta para o Bynder, pelo que o DAM tem de ser sempre a origem dos ficheiros. A Bynder indica ainda que a integração não recolhe dados de clientes nem acompanha a atividade na plataforma Salesforce.

Que perfis e interfaces fazem parte da cartridge?

A cartridge reparte o trabalho por três perfis e duas interfaces, o menu Bynder no Business Manager e o Page Designer.

Quanto a requisitos, a ajuda da Bynder refere a API Version 25.3 do Salesforce Commerce Cloud com Compatibility Mode 22.7, e indica que a cartridge foi testada com o SFRA 7.0.1. Se a sua loja está noutra versão ou usa um storefront muito personalizado, valide tudo num ambiente de testes antes de prometer datas.

Como se configura a integração passo a passo?

Os passos abaixo seguem a ajuda da Bynder. A instalação da cartridge em si não vem detalhada nessa página, por isso deve ser combinada com a Bynder ou com o parceiro de implementação.

1. Preparar o portal Bynder. Marque como públicos os ativos e as derivações que a loja vai usar. Segundo a ajuda da Bynder sobre a Universal Compact View, o ficheiro original só fica disponível se o ativo for público, e o seletor só mostra derivações públicas.
2. Ativar a integração. Nas preferências do site Bynder, em Administration e Site Development, ligue a integração ao nível do site.
3. Escolher as páginas. Defina onde o Bynder fica ativo, por exemplo na página inicial, nas listagens de produtos e nas fichas de produto.
4. Configurar a sincronização. Crie o job agendado que mantém as atribuições de ativos alinhadas entre o Salesforce e o Bynder.
5. Testar a atribuição a produtos. O merchandiser procura o produto por ID no menu Bynder, escolhe o ativo na Universal Compact View e clica em Assign. As ligações ficam guardadas nos atributos personalizados do produto.
6. Testar o Page Designer. Arraste um componente de imagem ou vídeo para a página e escolha o ativo no seletor do Bynder.

Cartridge ou integração headless: qual escolher?

Depende do storefront. Se a loja usa o SFRA e o Business Manager, a cartridge cobre o fluxo de merchandisers e marketers. Se o front-end é headless, a Bynder tem um guia próprio que combina a Salesforce Commerce API com a API REST do Bynder.

No modelo headless, segundo o guia da Bynder, cria-se um cliente OAuth no Bynder e usa-se um utilizador de integração dedicado, porque as chamadas à API ficam atribuídas ao utilizador indicado no cabeçalho de autorização. Esse utilizador tem de estar ativo e ter as permissões necessárias. Os webhooks do Bynder enviam atualizações em tempo real, e a CDN do Bynder serve as derivações com invalidação automática de cache, para que os URLs de referência se mantenham atuais.

O mesmo guia explica que, depois de os ativos estarem ligados aos produtos, a API de produtos do Commerce devolve os dados do produto com o URL da CDN do Bynder. Para guardar os identificadores dos ativos, criam-se campos no Business Manager.

Que problemas surgem e como evitá-los?

• Ativos ou derivações não públicos. Não aparecem no seletor. Verifique no Bynder antes de culpar a cartridge.
• Expectativa de sincronização nos dois sentidos. A documentação descreve apenas Bynder para Salesforce. Se alguém carregar ficheiros diretamente no Salesforce, o DAM não os recebe.
• Derivações por definir. Sem derivações para os tamanhos usados na loja, a equipa acaba a escolher o original ou um tamanho ao acaso. Defina-as antes de atribuir ativos.
• Utilizador de integração inativo ou sem permissões. No modelo headless, as chamadas à API falham se o utilizador do cabeçalho OAuth não estiver ativo ou não tiver as permissões do caso de uso.
• Ativos arquivados enquanto estão em uso. A Bynder indica que avisa antes de arquivar ou eliminar um ativo usado num canal externo, através do Asset Usage API e do Asset Tracker. Vale a pena ativar este controlo.

Lista de verificação antes de arrancar o projeto

• Confirmar a versão da API do Salesforce, o modo de compatibilidade e o tipo de storefront
• Decidir se a loja usa a cartridge ou uma integração headless
• Marcar como públicos os ativos e as derivações necessários
• Definir as derivações por tipo de página: listagem, ficha de produto, banner
• Atribuir a quem mantém o catálogo a responsabilidade de associar ativos a produtos
• Escolher um conjunto pequeno de produtos para o primeiro teste
• Definir quem recebe o aviso quando um ativo em uso for arquivado
• Testar num ambiente separado antes de ligar à loja em produção

Como trabalhamos na Avafa

Começamos por mapear o catálogo: que produtos têm que ativos, que derivações cada página precisa e quem mantém os metadados. Depois definimos o modelo, cartridge ou headless, testamos num ambiente separado com poucos produtos e só então alargamos ao catálogo completo. Se precisa de ligar DAM, PIM e ERP à loja, conheça a nossa agência especializada em integrações de catálogos.

Guias relacionados do mesmo cluster

• Integrar o Bynder com a BigCommerce
• Integrar o Bynder com o SAP Commerce Cloud
• Integrar a CELUM com o Salesforce Commerce Cloud
• Integrar o OpenText DAM com o Salesforce Commerce Cloud
• Integrar o Widen com o Salesforce Commerce Cloud
• Integrar o Canto com o Salesforce Commerce Cloud

Perguntas frequentes

A integração do Bynder com o Salesforce sincroniza nos dois sentidos?

Não. Segundo a ajuda da Bynder, a sincronização é feita só do Bynder para o Salesforce, e nada é carregado do Salesforce para o Bynder.

A integração é suportada pela Bynder ou por um parceiro?

A listagem do Bynder Marketplace indica que foi desenvolvida pela Bynder e que o nível de suporte é da Bynder, ao contrário das integrações suportadas por parceiros.

Que versão do Salesforce Commerce Cloud é necessária?

A Bynder refere a API Version 25.3 com Compatibility Mode 22.7 e testes com o SFRA 7.0.1. Para outras versões ou storefronts personalizados, confirme com a Bynder.

Funciona com uma loja headless?

A Bynder tem um guia específico para B2C Commerce headless, baseado na Salesforce Commerce API e na API REST do Bynder, com OAuth, webhooks e CDN. Exige desenvolvimento, ao contrário da cartridge.

Os ativos têm de ser públicos?

Para aparecerem no seletor sim: o original só está disponível se o ativo for público, e só as derivações públicas são listadas.