Como usar eventos de eCommerce

Os eventos recomendados de eCommerce usam um esquema compartilhado no nível do pedido, o que permite à Braze criar recursos confiáveis com base nos seus dados de eCommerce — incluindo perfis de usuário, segmentação, envio de mensagens, relatórios e recomendações com IA. As seções deste artigo abordam como usar cada recurso na Braze.

Consulte Esquemas de eventos para requisitos de propriedades e tipos de dados, e Validação de eventos e solução de problemas para saber o que acontece quando um evento falha na validação.

Como os eventos de eCommerce seguem um esquema previsível, a Braze pode criar recursos confiáveis com base neles, desde rastreamento de receita e modelos de Canvas pré-construídos até recomendações com IA. As seções a seguir oferecem uma visão geral rápida de cada recurso com links para a documentação completa.

Nota

Os eventos de eCommerce da Braze e suas propriedades de evento Segmentáveis não contam como pontos de dados.

Guia Comércio

A guia Comércio em cada perfil de usuário combina dois módulos: Atividade de pedidos (métricas calculadas de receita e pedidos) e Carrinho ativo (o carrinho mais recente dos eventos ecommerce.cart_updated).

Atividade de pedidos

O módulo Atividade de pedidos exibe três métricas calculadas que são atualizadas em tempo real conforme os eventos são processados. O modelo no nível do pedido desses cálculos separa claramente os preços dos produtos do valor total do pedido.

Nota

Os eventos recomendados de eCommerce não preenchem a seção Histórico de compras da guia Comércio. O histórico de compras é preenchido por eventos de compra legados. Use as métricas da tabela a seguir para receita e atividade de pedidos a partir de eventos recomendados.

Carrinho ativo

O módulo Carrinho ativo mostra o carrinho mais recente no perfil do usuário. Essa visualização é especialmente útil durante os testes. Você pode usá-la para confirmar o conteúdo do carrinho, validar jornadas baseadas em carrinho ou verificar se os eventos ecommerce.cart_updated estão atualizando o perfil conforme esperado.

O Carrinho ativo inclui o seguinte:

• ID do carrinho — Identificador do carrinho que recebeu o último evento ecommerce.cart_updated.
• Última atualização — Timestamp da atualização mais recente do carrinho.
• Valor total do carrinho — Valor total dos itens de linha no carrinho atual.
• Ver produtos — Um link para abrir a lista de produtos no carrinho (até 50 produtos).

Orquestração de eCommerce

Segmentação

A Braze oferece três maneiras de segmentar usuários com base em dados de eCommerce:

• Filtros de eCommerce: Use a categoria eCommerce no segmentador, que contém filtros alimentados por eventos recomendados de eCommerce (como Last Order Placed, Total Revenue e Average Order Value). Para ver a lista completa de filtros disponíveis, consulte Filtros de segmento.
• Filtros de eventos personalizados: Como os eventos de eCommerce se comportam como eventos personalizados, todos os filtros de eventos personalizados existentes funcionam imediatamente. Por exemplo, você pode filtrar por “Realizou evento personalizado ecommerce.order_placed mais de X vezes” ou “Realizou pela primeira vez o evento personalizado ecommerce.order_placed”.
• Extensões de segmento: Para segmentar com base em propriedades de evento aninhadas, incluindo o array de produtos aninhados ou as propriedades dos objetos de metadados, use extensões de segmento com filtragem de propriedades de evento aninhadas. Isso permite criar públicos como “usuários que compraram o produto SKU-123 nos últimos 90 dias” ou combinar critérios entre diferentes propriedades do mesmo pedido.

Se você precisa filtrar por propriedades personalizadas que não fazem parte do esquema de evento documentado, aninhe-as em metadata ao registrar o evento (por exemplo, metadata.color em vez de color). Propriedades personalizadas de nível superior que você envia pela API ou SDK não são válidas para filtros de propriedade de extensão — mesmo que essas propriedades apareçam nos seus dados de evento. Usar uma propriedade de nível superior fora da lista permitida impede que a extensão seja salva ou desarquivada.

Importante

As extensões de segmento para eventos recomendados de eCommerce são um recurso pago e estão em acesso antecipado. Se você tem interesse em participar do acesso antecipado, entre em contato com seu gerente de sucesso do cliente. Confirme se seu plano inclui acesso antes de recomendar a segmentação por propriedades aninhadas à sua equipe.

Disparo

Você pode usar disparos de evento personalizado realizado com eventos de eCommerce em toda a Braze, assim como com outros eventos personalizados. Para fluxos de carrinho abandonado, use o disparo Update Cart para capturar corretamente as atualizações do carrinho.

Além disso, a Braze oferece um disparo dedicado Place Order, que permite iniciar jornadas ou executar ações quando um usuário faz um pedido. Para saber mais, consulte Entrega baseada em ação.

Filtros de propriedade

Os disparos Place Order e Update Cart também podem filtrar pelas propriedades carregadas pelo evento, de modo que um disparo é acionado apenas para os pedidos ou carrinhos relevantes:

• Propriedades básicas correspondem a uma propriedade de nível superior no evento, como total_value ou currency.
• Propriedades aninhadas verificam dentro do array products. Como cada produto carrega suas próprias propriedades, products[].metadata.category corresponde quando qualquer produto no pedido ou carrinho satisfaz a condição.

Aninhe campos personalizados de produto em metadata (por exemplo, products[].metadata.brand). Uma propriedade de produto que não faz parte do esquema de evento falha na validação, então um filtro sobre ela nunca corresponde.

Por exemplo, combinar total_value é maior que 1000 com products[].metadata.category igual a shoes dispara apenas para pedidos de alto valor que contêm calçados. Antes dos filtros de propriedade, você podia disparar quando um pedido era feito, mas não com base no que o pedido continha.

Os filtros de propriedade estão disponíveis nas seguintes superfícies:

• Place Order: disparos de Campaign e Canvas, eventos de exceção, critérios de saída de Canvas, etapas de jornadas de ação, eventos de conversão e eventos de remoção de Content Cards. Propriedades básicas e aninhadas são suportadas. Em disparos de mensagem no app, Place Order suporta apenas propriedades básicas.
• Update Cart: disparos de Campaign e Canvas, eventos de exceção, critérios de saída de Canvas e etapas de jornadas de ação. Propriedades básicas e aninhadas são suportadas. Em eventos de conversão, eventos de remoção de Content Cards e disparos de mensagem no app, Update Cart é respaldado pelo evento personalizado ecommerce.cart_updated e suporta apenas propriedades básicas.

Nota

Em um filtro aninhado, não é igual corresponde quando nenhum item no array corresponde. Um carrinho filtrado com products[].metadata.category não é igual a shoes corresponde apenas quando todos os pares de sapatos foram removidos do carrinho, não quando o carrinho também contém outras categorias.

Os disparos de mensagem no app são avaliados no dispositivo, então Place Order não pode direcionar um produto específico ou filtrar por propriedades aninhadas nesse contexto. A opção Place order for specific product está desativada no criador. Para atuar em um produto específico, use uma Campaign em outro canal ou um Canvas.

Definir escopo de um pedido para um produto específico

Para disparar apenas quando um pedido contém um produto específico, adicione um filtro de propriedade aninhada no disparo Place Order. Isso não está disponível em disparos de mensagem no app.

Comportamentos salvos com escopo de produto

Se você configurou um comportamento Place Order antes dos filtros de propriedade estarem disponíveis, ele pode ainda usar Place order for specific product com um Product Identifier (nome do produto, product_id ou variant_id). Esses comportamentos salvos continuam funcionando e correspondem exatamente como antes, então Campaigns e Canvas existentes não são afetados.

Para converter um comportamento salvo em filtros de propriedade, selecione Place any order. Isso substitui os controles de escopo de produto por filtros de propriedade. Use a tabela a seguir para recriar o mesmo escopo:

Importante

Mover um comportamento para Place any order não pode ser desfeito. Se ainda precisar do escopo original, recrie-o como um filtro de propriedade aninhada.

Personalização com Liquid

Os eventos de eCommerce suportam personalização com Liquid da mesma forma que os eventos personalizados; você pode referenciar propriedades de evento diretamente nas suas mensagens. Para puxar imagens de produtos, preços ou outros dados de catálogo para suas mensagens, vincule seu catálogo ao evento usando product_id ou variant_id como identificador de ligação. A tag Liquid {% shopping_cart %} permite iterar sobre o conteúdo atual do carrinho de um usuário para lembretes de carrinho abandonado, incentivos de checkout ou confirmações de pedido. Para exemplos de código prontos para uso, consulte Casos de uso de eCommerce.

Para uma alternativa sem código, os blocos de produto de arrastar e soltar estão disponíveis no programa de acesso antecipado.

Modelos de Canvas para eCommerce

A Braze oferece modelos de Canvas prontos para uso, pré-configurados com eventos recomendados de eCommerce como critérios de entrada, saída e conversão, para que você possa lançar fluxos de ciclo de vida sem configuração personalizada. Cada modelo inclui designs de e-mail de arrastar e soltar e suporta blocos de produto de arrastar e soltar (atualmente em acesso antecipado). Para casos de uso detalhados e exemplos com Liquid, consulte Casos de uso de eCommerce.

Esses modelos cobrem os fluxos de ciclo de vida de eCommerce mais comuns. Use-os como ponto de partida e personalize o tempo, os canais e o conteúdo criativo para o seu público.

• navegação abandonada
• carrinho abandonado
• checkout abandonado
• confirmação de pedido e pesquisa

Reengaja usuários que visualizaram um produto, mas não o adicionaram ao carrinho.

Use este modelo quando quiser trazer navegadores de volta para considerar produtos que visualizaram recentemente, mas não tomaram nenhuma ação.

Configuração	Valor
Evento de entrada	ecommerce.product_viewed
Eventos de saída	ecommerce.product_viewed, ecommerce.cart_updated, ecommerce.checkout_started, Placed Order
Evento de conversão	Placed Order

Recupera usuários que adicionaram itens ao carrinho, mas não iniciaram o checkout.

Use este modelo quando quiser lembrar os usuários sobre itens no carrinho e incentivá-los a concluir a compra.

Configuração	Valor
Evento de entrada	ecommerce.cart_updated
Eventos de saída	ecommerce.cart_updated, ecommerce.checkout_started, Placed Order
Evento de conversão	Placed Order

Dica

O evento ecommerce.cart_updated suporta substituição completa do carrinho (cada evento pode descrever o carrinho inteiro) ou atualizações incrementais usando os valores add e remove para a propriedade opcional action. Escolha uma abordagem por carrinho e evite misturar atualizações de substituição e incrementais para o mesmo cart_id. O carrinho armazenado mantém o currency do evento de carrinho mais recente; uma atualização de carrinho em uma moeda diferente substitui o carrinho armazenado em vez de misturar valores de duas moedas. Use a tag Liquid {% shopping_cart %} na sua mensagem para exibir dinamicamente o conteúdo atual do carrinho no momento do envio.

Recupera usuários que iniciaram o checkout, mas não concluíram a compra.

Use este modelo quando quiser recuperar compras no estágio de maior intenção do funil.

Configuração	Valor
Evento de entrada	ecommerce.checkout_started
Evento de saída	Placed Order
Evento de conversão	Placed Order

Confirma uma compra bem-sucedida e faz o acompanhamento com uma pesquisa de feedback para impulsionar a coleta de avaliações e o engajamento pós-compra.

Use este modelo quando quiser otimizar a comunicação pós-compra e coletar feedback dos clientes em um único fluxo de trabalho.

Configuração	Valor
Evento de entrada	ecommerce.order_placed
Evento de conversão	Start Session ou ecommerce.product_viewed

Personalizar modelos

Esses modelos foram projetados como ponto de partida. As personalizações mais comuns incluem:

• Personalizar o e-mail: Cada modelo inclui um e-mail pré-configurado criado com o editor de arrastar e soltar, totalmente editável para combinar com sua marca e conteúdo.
• Adicionar canais: Combine e-mail com push, SMS ou mensagens no app para reforço entre canais.
• Adicionar postergações e divisões de decisão: Ramifique usuários por comportamento (por exemplo, carrinho de alto valor comparado a carrinho de baixo valor) ou períodos de espera entre mensagens.
• Trocar o conteúdo criativo: Substitua o modelo de e-mail incluído pelo estilo visual da sua marca.
• Usar blocos de produto: Use blocos de produto de arrastar e soltar (no programa de acesso antecipado) para renderizar dinamicamente o conteúdo do carrinho abandonado ou produtos visualizados sem escrever Liquid personalizado.

Para estratégias de ciclo de vida mais avançadas, incluindo exemplos de personalização com Liquid, consulte Casos de uso de eCommerce.

Relatórios de eCommerce

Os eventos recomendados de eCommerce alimentam as mesmas superfícies de receita que os clientes já utilizam hoje. Quando sua integração está enviando eventos de eCommerce, os relatórios a seguir incluem a receita de eCommerce automaticamente:

Para campos calculados não relacionados ao usuário (por exemplo, receita de Campaign ou Canvas), a receita é calculada da mesma forma em todos os relatórios: price multiplicado por quantity por produto no pedido, somado entre os produtos em cada evento order_placed.

Nota

Os cálculos de receita limitam as quantidades individuais de produtos a 1.000 unidades por pedido. Se o campo de quantidade estiver ausente para um produto, o padrão será uma unidade. O evento original ecommerce.order_placed retém a quantidade completa que você enviou — apenas o cálculo de receita aplica o limite.

Se você está migrando de eventos de compra legados para ecommerce.order_placed, coordene com a equipe da sua conta Braze antes de fazer qualquer alteração na integração. Durante o período de transição, envie tanto os eventos de compra legados quanto os eventos ecommerce.order_placed para confirmar que estão sendo disparados corretamente e para preparar suas Campaigns, Canvas e Segments ativos para a migração para o novo evento. Sua equipe de conta pode então ajudá-lo a planejar a transição para mudar os relatórios de receita dos eventos de compra legados para ecommerce.order_placed.

BrazeAI^TM

Eventos preditivos, Churn preditivo e recomendação de itens suportam eventos de eCommerce como eventos-alvo e sinais, e possuem uma opção dedicada “Order Placed”. O esquema padronizado torna esses modelos mais confiáveis porque os dados são consistentes em toda a sua base de usuários.

Exportar dados

A Braze oferece várias formas de exportar dados de eventos de eCommerce para uso no seu data warehouse, ferramentas de BI ou sistemas downstream. Os eventos recomendados de eCommerce são exportados pelos mesmos canais que os demais dados de eventos.

Como segmentar usuários por um produto específico?

O segmentador permite filtrar pelo número de vezes que um usuário realizou um evento de eCommerce. Para filtrar por propriedades específicas do produto (como product_id ou product_name), use extensões de segmento, que suportam filtragem de propriedades de evento aninhadas. Por exemplo, você pode encontrar todos os usuários que compraram o produto “SKU-123” nos últimos 90 dias.