O que é o código _bundlex nos meus pedidos?

Se você abriu um pedido no painel de administração da Shopify e notou uma linha parecida com _bundlex: {"o":0,"d":"da2a9114-..."}, isso é o Bundlex em ação. Trata-se de uma tag interna de rastreamento, e este artigo explica exatamente o que ela faz e por que está presente.

A versão resumida

A propriedade de item de linha _bundlex é um código interno de rastreamento que o Bundlex adiciona aos itens de linha do pedido. Ela tem duas funções:

• Aplica o desconto correto no checkout, registrando qual oferta de pacote o cliente selecionou.
• Atribui a receita nas análises do Bundlex, registrando a qual desconto o item de linha pertence.

Não é um código de cupom, um código promocional nem algo que o cliente tenha digitado. É um metadado usado pelo Bundlex nos bastidores.

Onde a propriedade fica visível

A Shopify oculta as propriedades de itens de linha iniciadas por sublinhado no checkout, mas as mantém visíveis nos detalhes do pedido no painel de administração. A propriedade também continua disponível para o código do tema e as APIs do carrinho.

Para ocultá-la na vitrine, o tema precisa filtrar as propriedades privadas. Modelos personalizados de e-mail, romaneios e outras integrações também devem evitar exibir propriedades internas. Não presuma que um sublinhado oculte o valor em todas as superfícies. Consulte a documentação da Shopify sobre propriedades privadas.

O Bundlex não tem uma configuração para ocultar essa propriedade na visualização do pedido no painel de administração da Shopify. Se os clientes conseguirem vê-la na sua vitrine ou em um modelo personalizado, entre em contato com o suporte informando a página ou o modelo afetado.

Por que o Bundlex usa essa propriedade

A propriedade vincula a linha do carrinho à oferta e à função correspondente. O Bundlex usa essas informações para verificar a elegibilidade do desconto e gerar relatórios. Não a remova das solicitações do carrinho para ocultá-la visualmente. Em vez disso, filtre-a na saída exibida.

Como é o código

Normalmente, você verá uma tag por item de linha. A linha do produto principal geralmente contém uma referência à oferta, e qualquer linha adicional de brinde ou extra pago contém um marcador adicional:

_bundlex: {"o":0,"d":"da2a9114-8063-..."}        Main item
_bundlex: {"o":0,"e":0,"d":"da2a9114-8063-..."}  Gift or extra item

Os valores são identificadores internos: o é a posição da oferta, d é o ID do desconto usado para atribuição de receita, e e indica um brinde ou extra pago. Você não precisa fazer nada com eles nem interpretá-los.

Vejo a tag, mas nenhum desconto foi aplicado

Isso é normal e geralmente esperado. Se um pedido tiver um único item com a tag _bundlex, mas sem desconto, quase sempre a compra correspondeu a um nível configurado como None ou 0%, por exemplo, o nível "Compre 1" ou o nível de uma única unidade de uma oferta por volume.

Suponha que você ofereça uma promoção de vinhos com um nível "Compre 1" com 0% de desconto e níveis maiores com um desconto real. Um pedido de uma única garrafa ainda receberá a tag. O cliente comprou 1 unidade, que correspondeu ao primeiro nível, portanto nenhum desconto é aplicado e somente a tag de rastreamento fica presente. Isso significa que o app está funcionando corretamente.

Dica: se você preferir que o primeiro nível não tenha nenhum desconto, em vez de um 0% explícito, defina o tipo de desconto dessa oferta como None para uma configuração mais limpa. O comportamento será o mesmo e a tag continuará aparecendo.

Preciso fazer alguma coisa?

Não. Você pode ignorar com segurança o código _bundlex nos seus pedidos. Ele ajuda a verificar a elegibilidade do desconto e a atribuir a receita. Se aparecer em um modelo voltado para o cliente, verifique como esse modelo exibe as propriedades privadas. Se você encontrar um pedido em que esperava um desconto, mas nenhum foi aplicado, verifique a qual nível a quantidade comprada correspondeu antes de presumir que algo deu errado.