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 formas de segmentar usuários com base em dados de eCommerce:

• Filtros de eCommerce: Use a categoria eCommerce no segmentador. Ela contém filtros alimentados pelos 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 evento personalizado: Como os eventos de eCommerce se comportam como eventos personalizados, todos os filtros de evento personalizado existentes funcionam imediatamente. Por exemplo, você pode filtrar por “Realizou o 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 aninhado de produtos ou as propriedades dos objetos de metadados, use extensões de segmento com filtragem por propriedades de evento aninhadas. Assim, você pode criar públicos como “usuários que compraram o produto SKU-123 nos últimos 90 dias” ou combinar critérios de diferentes propriedades do mesmo pedido.

Se você precisar filtrar por propriedades personalizadas que não fazem parte do esquema de evento documentado, aninhe essas propriedades em metadata ao registrar o evento (por exemplo, metadata.color em vez de color). Propriedades personalizadas de nível superior enviadas pela API ou pelo SDK não são válidas para filtros de propriedade de extensões, mesmo que 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ê tiver interesse em participar do acesso antecipado, entre em contato com seu gerente de sucesso do cliente. Confirme se o seu plano inclui esse acesso antes de recomendar a segmentação por propriedades aninhadas para sua equipe.

Disparo

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

Além disso, a Braze oferece um gatilho 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 gatilhos Place Order e Update Cart também podem filtrar pelas propriedades do evento, para que o gatilho dispare apenas para os pedidos ou carrinhos que importam para você:

• Propriedades básicas correspondem a uma propriedade de nível superior do evento, como total_value ou currency.
• Propriedades aninhadas verificam o conteúdo do array products. Como cada produto tem suas próprias propriedades, products[].metadata.category corresponde quando qualquer produto do pedido ou carrinho atende à 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 do evento falha na validação, então um filtro sobre ela nunca vai corresponder.

Por exemplo, combinar total_value maior que 1000 com products[].metadata.category igual a shoes dispara apenas para pedidos de alto valor que contenham calçados. Antes dos filtros de propriedade, era possível disparar quando um pedido era feito, mas não com base no conteúdo do pedido.

Os filtros de propriedade estão disponíveis nos seguintes contextos:

• Place Order: gatilhos de Campaign e Canvas, eventos de exceção, critérios de saída do Canvas, etapas de jornadas de ação, eventos de conversão e eventos de remoção de Content Card. Propriedades básicas e aninhadas são compatíveis. Em gatilhos de mensagem no app, Place Order é compatível apenas com propriedades básicas.
• Update Cart: gatilhos de Campaign e Canvas, eventos de exceção, critérios de saída do Canvas e etapas de jornadas de ação. Propriedades básicas e aninhadas são compatíveis. Em eventos de conversão, eventos de remoção de Content Card e gatilhos de mensagem no app, Update Cart usa o evento personalizado ecommerce.cart_updated e é compatível apenas com propriedades básicas.

Nota

Em um filtro aninhado, does not equal corresponde quando nenhum item do array corresponde. Um carrinho filtrado por products[].metadata.category does not equal shoes só corresponde depois que todos os pares de sapatos forem removidos do carrinho, e não quando o carrinho também contém outras categorias.

Os gatilhos de mensagem no app são avaliados no dispositivo, então Place Order não pode direcionar um produto específico nem filtrar por propriedades aninhadas nesse caso. A opção Place order for specific product fica desativada no criador. Para agir sobre um produto específico, use uma campanha em outro canal ou um Canvas.

Limitar um pedido a um produto específico

Para disparar apenas quando um pedido contiver um produto específico, adicione um filtro de propriedade aninhada no gatilho Place Order. Isso não está disponível em gatilhos de mensagem no app.

Comportamentos salvos com escopo de produto

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

Para mudar um comportamento salvo para 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

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

Personalização com Liquid

Os eventos de eCommerce são compatíveis com a personalização com Liquid da mesma forma que os eventos personalizados. Você pode referenciar as propriedades do evento diretamente nas suas mensagens. Para incluir imagens de produtos, preços ou outros dados de catálogo nas mensagens, associe seu catálogo ao evento usando product_id ou variant_id como identificador de vinculação. A Liquid tag {% shopping_cart %} permite percorrer o conteúdo atual do carrinho de um usuário para lembretes de carrinho abandonado, incentivos de checkout ou confirmações de pedido. Para ver exemplos de código prontos para uso, consulte Casos de uso de eCommerce.

Como 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. Assim, você pode lançar fluxos de ciclo de vida sem configuração personalizada. Cada modelo vem com designs de e-mail de arrastar e soltar e é compatível com blocos de produto de arrastar e soltar (atualmente em acesso antecipado). Para ver casos de uso detalhados e exemplos de 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, depois, personalize o tempo, os canais e os criativos 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 de volta quem navegou pelo site para reconsiderar produtos que visualizou recentemente, mas sem tomar 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 dos itens no carrinho e incentivá-los a voltar para concluir o checkout.

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 é compatível com a substituição completa do carrinho (cada evento pode descrever o carrinho inteiro) ou com atualizações incrementais usando os valores add e remove na 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 a currency do evento de carrinho mais recente. Uma atualização de carrinho em outra moeda substitui o carrinho armazenado, em vez de misturar valores de duas moedas. Use a Liquid tag {% 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 na etapa 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 envia em seguida uma pesquisa de feedback para incentivar avaliações e o engajamento pós-compra.

Use este modelo quando quiser simplificar 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

Personalizar modelos

Esses modelos foram criados para servir como ponto de partida. Personalizações comuns incluem:

• Personalizar o e-mail: Cada modelo inclui um e-mail pré-configurado, criado com o editor de arrastar e soltar, que é totalmente editável para combinar com sua marca e seu conteúdo.
• Adicionar canais: Combine o e-mail com push, SMS ou mensagens no app para um reforço entre canais.
• Adicionar postergações e divisões de decisão: Ramifique os usuários por comportamento (por exemplo, carrinho de alto valor em comparação com carrinho de baixo valor) ou defina períodos de espera entre as mensagens.
• Trocar os criativos: 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 os produtos navegados, 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á usam hoje. Quando sua integração envia eventos de eCommerce, os relatórios a seguir incluem automaticamente a receita de eCommerce:

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

Nota

Os cálculos de receita limitam a quantidade de cada produto a 1.000 unidades por pedido. Se o campo de quantidade estiver ausente para um produto, o padrão é uma unidade. O evento ecommerce.order_placed original mantém a quantidade completa que você enviou; o limite se aplica apenas ao cálculo de receita.

Se você estiver migrando de eventos de compra legados para ecommerce.order_placed, alinhe 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 migrar para o novo evento. Depois, a equipe da sua conta pode ajudar você a planejar a virada para que os relatórios de receita passem a usar ecommerce.order_placed em vez dos eventos de compra legados.

BrazeAI^TM

Eventos preditivos, Previsão de churn e recomendações de itens aceitam eventos de eCommerce como eventos-alvo e sinais, e têm uma opção dedicada “Order Placed”. O esquema padronizado torna esses modelos mais confiáveis, porque os dados ficam 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, em ferramentas de BI ou em sistemas downstream. Os eventos recomendados de eCommerce são exportados pelos mesmos canais que seus outros 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 permitem filtrar por propriedades de evento aninhadas. Por exemplo, você pode encontrar todos os usuários que compraram o produto “SKU-123” nos últimos 90 dias.