Pular para o conteúdo
Documentação API Reference FAQ Changelog Status
Marketing Magento 2 Adobe Commerce

Compartilhamento de Dados BNB (Click2Buy / Michelin)

PDF

Aprenda a configurar o envio automático mensal das vendas originadas pela Click2Buy/Michelin (programa BNB) em uma loja Magento 2.

O Otávio Augusto Moraes 24/06/2026 Atualizado 24/06/2026 9 min de leitura
  • Envia automaticamente, todo mês, um arquivo com as vendas que vieram da Click2Buy/Michelin (programa BNB — Direct Data Sharing).
  • Identifica sozinho quais pedidos chegaram pela Click2Buy e monta uma planilha (CSV) com uma linha por pneu vendido.
  • Protege a concorrência: marcas que não são suas são anonimizadas automaticamente no arquivo, mantendo apenas dados de medida, segmento, quantidade e valor.
  • Entrega o arquivo direto no servidor do parceiro (via SFTP), sem intervenção manual. Funciona em lojas Magento 2.

Passo a Passo por Escrito

1. Acesse as configurações do módulo no painel administrativo

No menu lateral do admin, acesse Stores → Configuration → Sales → Compartilhamento de Dados BNB (Click2Buy / Michelin).

A tela está dividida em quatro blocos: Geral, Atribuição BNB, Mapeamento de Produto / Campos e Envio por SFTP.

Resultado esperado: A tela de configuração é exibida com os quatro blocos disponíveis para preenchimento.


2. Ative o módulo

No bloco Geral:

  1. Em Ativar módulo, selecione Sim.
  2. Em Nome do varejista (prefixo do arquivo), informe o identificador da sua loja. Ele é usado no nome do arquivo enviado — por exemplo, minhaloja gera arquivos como minhaloja_bnb_traffic_transaction_id_202605.csv.
  3. Deixe Registro de depuração como Não no uso normal. Ative apenas quando o suporte pedir, para investigar um problema.

Enquanto **Ativar módulo** estiver em **Não**, nada é capturado nem enviado. Este é o interruptor geral do recurso.

Resultado esperado: O módulo está ligado e o nome do varejista definido para nomear os arquivos.


3. Configure a identificação do tráfego BNB

No bloco Atribuição BNB, você define como a loja reconhece que uma visita veio da Click2Buy:

  1. Valores de utm_source que identificam tráfego BNB: informe os valores que aparecem no link da Click2Buy. O padrão é click2buy.
  2. Domínios de origem que identificam tráfego BNB: usados como alternativa quando o link não traz o utm_source. O padrão cobre clic2buy.com,clic2drive.com,t.clic2buy.com.
  3. Janela de atribuição (dias): por quanto tempo a visita continua sendo creditada à Click2Buy até o cliente finalizar a compra. O padrão é 30 dias.

Os valores padrão já atendem ao cenário da Click2Buy. Só altere se o parceiro informar outros endereços ou parâmetros.

Resultado esperado: A loja passa a marcar como "vinda da BNB" toda visita que chega por um link Click2Buy e finaliza um pedido dentro da janela definida.


4. Configure o mapeamento dos dados do produto

No bloco Mapeamento de Produto / Campos, você indica de onde o módulo lê as informações de cada pneu. Os campos pedem códigos de atributo do seu catálogo:

  1. Origem do item_id: atributo usado como identificador do item. Use sku para o código do produto, ou o código de outro atributo (ex.: cod_ean).
  2. Medida do pneu (geobox): preencha os três atributos componentes — largura, altura/perfil e aro (ex.: pneu_largura, pneu_altura, pneu_aro). O módulo monta a medida no formato 195/55 R15.
  3. Medida + índice (dimbox): informe os atributos de índice de carga e índice de velocidade. O módulo combina a medida com a letra de velocidade (ex.: 195/55 R15 V).
  4. Código do atributo de marca: atributo que guarda a marca do pneu (ex.: brand).
  5. Marcas próprias (não anonimizadas): lista, separada por vírgula, das marcas que não devem ser anonimizadas (ex.: Michelin,BFGoodrich,Levorin,Tigar). Toda marca fora desta lista é anonimizada no arquivo.
  6. Mapa de Marca → Tier: uma marca por linha, no formato Marca=Tier (ex.: Michelin=Tier 1). Define o segmento de cada marca.
  7. Extrair geobox/dimbox do nome do produto quando o atributo estiver vazio: deixe em Sim para que o módulo leia a medida do nome do produto quando os atributos estiverem em branco.
  8. Formato de data: formato da data no arquivo. O padrão d/m/Y gera datas como 30/03/2026.

Os códigos de atributo precisam existir no seu catálogo e estar preenchidos nos produtos. Um pneu sem marca cadastrada e sem a marca no nome é anonimizado por segurança.

Resultado esperado: O módulo consegue montar, para cada pneu vendido, a medida, a marca, o segmento (tier) e o identificador corretos.


5. Configure o envio por SFTP

No bloco Envio por SFTP, informe os dados do servidor onde o arquivo será entregue. Essas credenciais são fornecidas pelo parceiro Click2Buy/Michelin.

  1. Em Enviar via SFTP, selecione Sim.
  2. Preencha Servidor, Porta (padrão 22), Usuário e Senha.
  3. Em Diretório remoto, informe a pasta de destino no servidor (ex.: /upload).

Sem as credenciais corretas de **Servidor**, **Usuário** e **Senha**, o arquivo é gerado mas não chega ao parceiro. Solicite esses dados ao contato Click2Buy/Michelin antes de ativar o envio.

Se você deixar **Enviar via SFTP** em **Não**, o arquivo é apenas gerado internamente na loja, sem ser enviado. Útil para testes.

Resultado esperado: Ao salvar, a mensagem "You saved the configuration." é exibida no topo da tela e o envio automático está configurado.


6. Aguarde o envio automático mensal

Depois de configurado, o módulo trabalha sozinho: todo início de mês ele reúne as vendas BNB do mês anterior, gera o arquivo e o envia ao parceiro. Você não precisa fazer nada manualmente a cada mês.

O envio mensal acontece automaticamente. Se precisar gerar um arquivo de um mês específico fora do calendário (por exemplo, para conferência), solicite ao nosso suporte.

Resultado esperado: No início de cada mês, o arquivo com as vendas BNB do mês anterior é gerado e entregue ao parceiro automaticamente.


Validação e Testes

Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.

Teste 1 — A configuração foi salva

Ação: preencha os campos dos passos 2 a 5 e clique em Save Config no topo da tela.

Resultado esperado: A mensagem "You saved the configuration." aparece no topo da tela e os valores permanecem preenchidos ao recarregar a página.


Teste 2 — Uma visita pela Click2Buy é reconhecida

Ação: abra a loja em uma janela anônima usando um link com os parâmetros da Click2Buy, por exemplo https://sualoja.com.br/?utm_source=click2buy&utm_term=michelin. Adicione um pneu ao carrinho e finalize um pedido de teste.

Resultado esperado: O pedido é registrado normalmente. Internamente, ele é marcado como originado pela BNB e entrará no próximo arquivo mensal.


Teste 3 — O arquivo chega ao parceiro

Ação: no início do mês seguinte (ou após uma geração manual solicitada ao suporte), confirme com o contato Click2Buy/Michelin se o arquivo do período foi recebido no servidor SFTP.

Resultado esperado: O parceiro confirma o recebimento do arquivo no formato `_bnb_traffic_transaction_id_.csv`, com uma linha por pneu vendido.


Se não funcionar, verifique:

  • O campo Ativar módulo está em Sim.
  • O link usado no teste tem realmente utm_source=click2buy (ou veio de um domínio configurado em Domínios de origem).
  • As credenciais de Servidor, Usuário, Senha e Diretório remoto do SFTP estão corretas e Enviar via SFTP está em Sim.
  • Os códigos de atributo informados no bloco Mapeamento existem e estão preenchidos nos produtos.

Pronto! Dessa forma realizamos a configuração do Compartilhamento de Dados BNB (Click2Buy / Michelin) em sua loja virtual Magento 2.


Observações Importantes

  • Anonimização automática de concorrentes: marcas que não estão na lista Marcas próprias têm o nome da marca, o nome do produto e o identificador substituídos por valores anônimos no arquivo. Medida, segmento (tier), quantidade e valor são mantidos. Isso atende às exigências de concorrência e privacidade do programa.
  • Escopo das configurações: os campos seguem o escopo padrão do Magento (global, por site ou por visão de loja). Ajuste no escopo correto se sua loja opera múltiplas visões.
  • Apenas vendas BNB entram no arquivo: pedidos que não vieram da Click2Buy não aparecem. Pedidos cancelados também ficam de fora.
  • Produtos sem marca cadastrada: um pneu sem marca no atributo e sem a marca reconhecível no nome é anonimizado por padrão. Manter o catálogo com marcas preenchidas garante que suas próprias marcas apareçam corretamente.
  • Produtos do tipo "par/kit" com duas medidas: o módulo considera apenas a primeira medida identificada.
  • Envio mensal: o arquivo cobre o mês anterior e é entregue no início do mês corrente.

Referências e Relacionados

  • Atributos de produto: este módulo lê medidas, marca e índices a partir de atributos do seu catálogo. Entender como criar e preencher atributos personalizados ajuda a garantir dados corretos no arquivo.
  • Configuração de cache da loja: após alterar as configurações do módulo, pode ser necessário limpar o cache para que as mudanças entrem em vigor.
  • Gerenciamento de pedidos: o módulo identifica e processa pedidos vindos da Click2Buy; esta doc cobre o fluxo geral de pedidos na loja.
  • Integrações de marketing: visão geral de como conectar a loja a plataformas e parceiros externos de marketing.

Caso tenha ficado alguma dúvida entre em contato com nosso time de suporte através do chat online dentro da sua loja virtual ou através do e-mail web@tryideas.com.br

Copiar para usar com IA

Este artigo foi útil?

Obrigado pelo seu feedback!