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.
Os eventos de eCommerce da Braze e suas propriedades de evento segmentáveis não contam como pontos de dados.
Guia Transações
A guia Transações em cada perfil de usuário oferece uma visualização em tempo real da atividade comercial do usuário, exibindo 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.
Os eventos recomendados de eCommerce não preenchem a seção Histórico de compras da guia Transações. 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.
| Métrica | Fórmula |
|---|---|
| Receita total | soma (order_placed.total_value) − soma (order_refunded.total_value) |
| Total de pedidos | contagem (distintos order_placed) − contagem (distintos order_cancelled) |
| Valor total de reembolsos | soma (order_refunded.total_value) |
Orquestração de eCommerce
Segmentação
Os eventos de eCommerce se comportam como eventos personalizados, então todos os filtros de eventos personalizados existentes funcionam imediatamente. Por exemplo, você pode filtrar por “Realizou o evento personalizado ecommerce.order_placed mais de X vezes.”
Para direcionamento baseado em dados aninhados de produtos (como IDs de produto específicos, nomes de variantes ou faixas de preço), 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 de diferentes propriedades do mesmo pedido.
Extensões de segmento são um recurso pago. Confirme se o seu plano inclui acesso antes de recomendar 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 com outros eventos personalizados. Para fluxos de carrinho abandonado, use o gatilho Perform Cart Updated Event para capturar corretamente as atualizações do carrinho.
Além disso, a Braze oferece um gatilho dedicado Places Order, que permite iniciar jornadas ou executar ações com base em qualquer pedido realizado, ou em pedidos que incluam um produto específico. Você pode filtrar esse gatilho por nome do produto, product_id ou variant_id para direcionar cenários de compra específicos. Para saber mais, consulte Entrega baseada em ação.
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 incluir imagens de produtos, preços ou outros dados do catálogo nas suas mensagens, vincule seu catálogo ao evento usando product_id ou variant_id como identificador de ligaçã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 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 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 personalize o timing, os canais e o criativo para o seu público.
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 sobre os quais não agiram.
| 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 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 |
O evento ecommerce.cart_updated usa um modelo de substituição. Cada evento enviado sobrescreve o estado do carrinho do usuário. 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 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 coletar avaliações e 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 ou ecommerce.product_viewed |
Personalizar modelos
Esses modelos foram projetados 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, 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 multicanal.
- 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 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 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 está enviando eventos de eCommerce, os seguintes relatórios incluem receita de eCommerce automaticamente:
| Relatório | O que mostra |
|---|---|
| Relatório de receitas | Receita total, receita média diária, compras diárias e receita por usuário ao longo do tempo em todas as fontes para o intervalo de datas e apps selecionados. |
| Dashboard de receita por último ponto de contato | Receita atribuída à última Campaign ou Canvas com a qual um usuário interagiu antes de realizar um pedido. Eventos de contato incluem cliques em e-mail, aberturas de push, cliques em cartões de conteúdo, cliques em mensagens no app e cliques em links curtos de SMS ou WhatsApp. |
| Analytics de Campaign e Canvas | Receita total atribuída a uma Campaign ou Canvas específico dentro da janela de conversão primária. |
| Relatório de conversões | Receita vinculada a eventos de conversão em Campaigns e Canvas. Nota: Para contabilizar a receita de ecommerce.order_placed, a Campaign ou Canvas deve usar o tipo de evento de conversão “Place Order” como seu evento de conversão. |
| Insights de segmento | Comparações de receita entre segmentos no dashboard de insights de segmento. |
| Criador de relatórios | Métricas de receita em relatórios personalizados criados no Criador de relatórios. |
| Criador de dashboard | Métricas de receita em dashboards personalizados criados no Criador de dashboard. |
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.
Para evitar contagem dupla de receita, não envie tanto compras legadas quanto eventos recomendados de eCommerce para os mesmos pedidos. Se você está planejando fazer a transição de compras legadas para eventos recomendados, coordene a mudança com a equipe de conta da Braze antes de fazer qualquer alteração na integração.
Os cálculos de receita limitam as quantidades individuais de produtos a 1.000 unidades por pedido. Se o campo quantity estiver ausente para um produto, o padrão é 1. O evento order_placed original mantém a quantidade completa que você enviou — apenas o cálculo de receita aplica o limite.
BrazeAITM
Predictive Events, Predictive Churn e recomendações 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 seus outros dados de eventos.
| Caminho de exportação | O que está incluído |
|---|---|
| Currents | Os eventos de eCommerce são transmitidos como eventos personalizados; pesquise o namespace ecommerce.* para encontrá-los. Os produtos de cada pedido estão disponíveis como compras. |
| Snowflake Data Sharing | Os eventos de eCommerce são compartilhados como eventos personalizados; pesquise o namespace ecommerce.* para encontrá-los. Os produtos de cada pedido estão disponíveis na tabela de compras. |
| Exportar dados de segmento para CSV | Exportação CSV de membros do segmento. Para incluir eventos de eCommerce, selecione-os pelo nome no dropdown de eventos personalizados. |
| Exportar perfil de usuário por Segment (API) | Dados de perfil de usuário para membros do segmento, retornados via API. Os eventos de eCommerce são incluídos como eventos personalizados. |
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.