Como usar eventos recomendados de eCommerce
Esta página explica como e onde você pode usar eventos recomendados de eCommerce em toda a plataforma, incluindo como usar os modelos de Canvas para eCommerce da Braze.

Os eventos recomendados de eCommerce estão atualmente em acesso antecipado. Entre em contato com seu gerente de sucesso do cliente da Braze se tiver interesse em participar desse acesso antecipado.
Se você estiver usando o novo conector do Shopify, os eventos recomendados de eCommerce estarão disponíveis automaticamente por meio da integração.
Usando um modelo de Canvas
Para usar um modelo de Canvas:
- Acesse Envio de mensagens > Canvas.
- Selecione Criar Canvas > Usar um modelo de Canvas.
- Navegue pela guia Modelos da Braze para encontrar o modelo que deseja usar. Você pode pré-visualizar um modelo selecionando seu nome.
- Selecione Aplicar modelo para o modelo que deseja usar.

Modelos de Canvas para eCommerce
A Braze oferece quatro modelos de Canvas para eCommerce.
Navegação abandonada
Use o modelo de Navegação abandonada para engajar usuários que navegaram por produtos, mas não os adicionaram ao carrinho nem realizaram um pedido.

Configuração
Na página do Canvas, selecione Use a Canvas Template > Braze templates e aplique o modelo Navegação abandonada.
Configurações padrão
As seguintes configurações estão pré-configuradas no seu Canvas:
- Básico
- Nome do Canvas: Abandoned browse
- Evento de conversão:
ecommerce.order placed- Prazo de conversão: 3 dias
- Cronograma de entrada
- Baseado em ação quando um usuário realiza o evento
ecommerce.product_viewed - O horário de início é quando você cria o modelo de Canvas

- Baseado em ação quando um usuário realiza o evento
- Público-alvo
- Público de entrada
- E-mail não está em branco
- Você também pode modificar os critérios de público de entrada para atender às necessidades do seu negócio
- Controles de entrada
- Os usuários são elegíveis para reentrar neste Canvas após a duração total do Canvas ser concluída
- Critérios de saída
- Realiza
ecommerce.cart_updated,ecommerce.checkout_startedouecommerce.order_placed
- Realiza
- Público de entrada
- Configurações de envio
- Usuários inscritos ou que aceitaram receber mensagens
- Etapa de postergação
- 1 hora de postergação
- Etapa de mensagem
- Revise o modelo de e-mail e o bloco HTML com um exemplo de template Liquid para adicionar produtos à sua mensagem no modelo pré-construído. Se você usar seu próprio modelo de e-mail, também pode consultar as variáveis Liquid, conforme demonstrado na seção a seguir.
Personalização de produtos de navegação abandonada para e-mails
Aqui está um exemplo de como você adicionaria um bloco de produto HTML ao seu e-mail de navegação abandonada.
1
2
3
4
5
6
7
8
9
10
11
<table aria-label="Abandoned browse product personalization for emails" style="width:100%">
<tr>
<th><img src="{{context.${image_url}}}" width="200" height="200"><img></th>
<th align="left">
<ul style="list-style-type: none">
<li>Item: {{context.${product_name}}}</li>
<li>Price: ${{context.${price}}}</li>
</ul>
</th>
</tr>
</table>
URL do produto
1
{{context.${product_url}}}
Carrinho abandonado
Use o modelo Carrinho abandonado para recuperar vendas potencialmente perdidas de clientes que adicionaram produtos ao carrinho, mas não prosseguiram para o checkout nem realizaram um pedido.

Configuração
Na página do Canvas, selecione Use a Canvas Template > Braze templates e aplique o modelo Carrinho abandonado.
Configurações padrão
As seguintes configurações estão pré-configuradas no seu Canvas:
- Básico
- Nome do Canvas: Abandoned cart
- Evento de conversão:
ecommerce.order_placed- Prazo de conversão: 3 dias
- Cronograma de entrada
- Gatilho baseado em ação quando um usuário aciona o Perform Cart Updated Event (localizado no dropdown)
- O horário de início é quando você cria o modelo de Canvas

- Público-alvo
- Público de entrada
- Usou esses apps mais de 0 vezes
- E-mail não está em branco
- Controles de entrada
- Os usuários são imediatamente reelegíveis para entrada no Canvas
- Critérios de saída
- Realiza
ecommerce.cart_updated,ecommerce.checkout_startedouecommerce.order_placed
- Realiza
- Público de entrada
- Configurações de envio
- Usuários inscritos ou que aceitaram receber mensagens
- Etapa de postergação
- 4 horas de postergação
- Etapa de mensagem
- Revise o modelo de e-mail e o bloco HTML com um exemplo de template Liquid para adicionar produtos à sua mensagem no modelo pré-construído. Se você usar seu próprio modelo de e-mail, também pode consultar as variáveis Liquid, conforme demonstrado na seção a seguir.
Como funciona a lógica de reentrada do carrinho abandonado
Quando um usuário inicia o processo de checkout, seu carrinho é marcado como checkout_started. A partir desse ponto, quaisquer atualizações adicionais do carrinho com o mesmo ID de carrinho não qualificarão o usuário para reentrar na jornada de carrinho abandonado.
- Quando um usuário adiciona um item ao carrinho, ele entra no Canvas.
- Cada vez que adiciona ou atualiza itens, ele reentra no Canvas — isso mantém os dados do carrinho e o envio de mensagens atualizados.
- Quando o usuário inicia o processo de checkout, seu carrinho é marcado como
checkout_startede ele sai do Canvas. - Quaisquer atualizações futuras do carrinho usando o mesmo ID de carrinho não dispararão a reentrada, pois esse carrinho já avançou para a fase de checkout.
Quando os usuários avançam para a jornada de checkout, eles passam a ser direcionados pelo Canvas de checkout abandonado, que é projetado para usuários mais adiantados na jornada de compra.
Personalização de produtos de carrinho abandonado para e-mails
Jornadas de carrinho abandonado requerem uma Liquid tag especial shopping_cart para personalização de produtos.
Aqui está um exemplo de como você adicionaria um bloco HTML com sua Liquid tag shopping_cart para adicionar produtos ao seu e-mail.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
<table aria-label="Abandoned cart product personalization for emails #abandoned-cart-checkout" style="width:100%">
{% shopping_cart {{context.${cart_id}}} %}
{% for item in shopping_cart.products %}
{% catalog_items <add_your_catalog_name> {{item.variant_id}} %}
<tr>
<th><img src="{{ items[0].variant_image_url }}" width="200" height="200"><img></th>
<th align="left">
<ul style="list-style-type: none">
<li>Item: {{ item.product_name }}</li>
<li>Price: ${{ item.price }}</li>
<li>Quantity: ${{ item.quantity }}</li>
<li>Variant ID: {{ item.variant_id }}</li>
<li>Product URL:{{ item.product_url }}</li>
<li>SKU: {{ item.metadata.sku }}</li>
</ul>
</th>
</tr>
{% endfor %}
</table>

Se você usar Shopify, adicione o nome do seu catálogo para obter a URL da imagem da variante.
URL do carrinho HTML
Se você quiser direcionar os usuários de volta ao carrinho, pode adicionar uma propriedade de evento aninhada dentro do objeto de metadados, como:
1
{{context.${metadata}.cart_url}}
Se você usar Shopify, crie a URL do carrinho usando este modelo Liquid:
1
{{context.${source}}}/checkouts/cn/{{context.${cart_id}}}
Checkout abandonado
Use o modelo Checkout abandonado para direcionar clientes que iniciaram o processo de checkout, mas saíram antes de finalizar o pedido.

Configuração
Na página do Canvas, selecione Use a Canvas Template > Braze templates e aplique o modelo Checkout abandonado.
Configurações padrão
As seguintes configurações estão pré-configuradas no seu Canvas:
- Básico
- Nome do Canvas: Abandoned checkout
- Evento de conversão:
ecommerce.order_placed- Prazo de conversão: 3 dias
- Cronograma de entrada
- Gatilho baseado em ação quando um usuário realiza o evento
ecommerce.checkout_started - O horário de início é quando você cria o modelo de Canvas

- Gatilho baseado em ação quando um usuário realiza o evento
- Público-alvo
- Público de entrada
- Usou esses apps mais de 0 vezes
- E-mail não está em branco
- Controles de entrada
- Os usuários são imediatamente reelegíveis para entrada no Canvas
- Critérios de saída
- Realiza os eventos
ecommerce.order_placed
- Realiza os eventos
- Público de entrada
- Configurações de envio
- Usuários inscritos ou que aceitaram receber mensagens
- Etapa de postergação
- 4 horas de postergação
- Etapa de mensagem
- Revise o modelo de e-mail e o bloco HTML com um exemplo de template Liquid para adicionar produtos à sua mensagem no modelo pré-construído. Se você usar seu próprio modelo de e-mail, também pode consultar as variáveis Liquid, conforme demonstrado na seção a seguir.
Personalização de checkout abandonado para e-mails
Jornadas de checkout abandonado requerem uma Liquid tag especial shopping_cart para personalização de produtos.
Aqui está um exemplo de como você adicionaria um bloco HTML com sua Liquid tag shopping_cart para adicionar produtos ao seu e-mail.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
<table aria-label="Abandoned checkout personalization for emails" style="width:100%">
{% shopping_cart {{context.${cart_id}}} :abort_if_not_abandoned false %}
{% for item in shopping_cart.products %}
{% catalog_items <add_your_catalog_name> {{item.variant_id}} %}
<tr>
<th><img src="{{ items[0].variant_image_url }}" width="200" height="200"><img></th>
<th align="left">
<ul style="list-style-type: none">
<li>Item: {{ item.product_name }}</li>
<li>Price: ${{ item.price }}</li>
<li>Quantity: ${{ item.quantity }}</li>
<li>Variant ID: {{ item.variant_id }}</li>
<li>Product URL:{{ item.product_url }}</li>
<li>SKU: {{ item.metadata.sku }}</li>
</ul>
</th>
{% endfor %}
</table>
abort_if_not_abandoned
O parâmetro abort_if_not_abandoned é específico do caso de uso de checkout abandonado e é utilizado apenas com a Liquid tag shopping_cart em conjunto com o evento ecommerce.checkout_started.
| Valor | Comportamento |
|---|---|
true (padrão) |
A mensagem é cancelada se o carrinho não tiver sido abandonado — ou seja, se o usuário já tiver concluído o pedido. |
false |
A mensagem é enviada mesmo que o carrinho não esteja em estado de abandono, permitindo que o e-mail inclua os detalhes do carrinho independentemente do status atual do checkout. |
Defina abort_if_not_abandoned como false quando quiser enviar o lembrete de checkout independentemente de o carrinho ainda ser considerado abandonado no momento do envio. Se você omitir o parâmetro ou defini-lo como true, a Braze cancelará a mensagem para usuários que já concluíram a compra.
URL de checkout
1
{{context.${metadata}.checkout_url}}
Confirmação de pedido e pesquisa de feedback
Use o modelo Confirmação de pedido e pesquisa de feedback para confirmar pedidos bem-sucedidos e aumentar a satisfação do cliente.

Configuração
Na página do Canvas, selecione Use a Canvas Template > Braze templates e aplique o modelo Confirmação de pedido e pesquisa de feedback.
Configurações padrão
As seguintes configurações estão pré-configuradas no seu Canvas:
- Básico
- Nome do Canvas: Order confirmation with feedback survey
- Evento de conversão:
ecommerce.session_start- Prazo de conversão: 10 dias
- Cronograma de entrada
- Gatilho baseado em ação quando um usuário realiza o evento
ecommerce.cart_updated - O horário de início é quando você cria o modelo de Canvas

- Gatilho baseado em ação quando um usuário realiza o evento
- Público-alvo
- Público de entrada
- Usou esses apps mais de 0 vezes
- E-mail não está em branco
- Controles de entrada
- Os usuários são imediatamente reelegíveis para entrada no Canvas
- Critérios de saída
- Não se aplica

- Não se aplica
- Público de entrada
- Configurações de envio
- Usuários inscritos ou que aceitaram receber mensagens
- Etapa de mensagem
- Revise o modelo de e-mail e o bloco HTML com um exemplo de template Liquid para adicionar produtos à sua mensagem no modelo pré-construído. Se você usar seu próprio modelo de e-mail, também pode consultar as variáveis Liquid, conforme demonstrado na seção a seguir.
Personalização de confirmação de pedido para e-mails
Aqui está um exemplo de como você adicionaria um bloco de produto HTML à sua confirmação de pedido após um pedido ser realizado.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<table aria-label="Order confirmation personalization for emails" style="width:100%">
{% for item in {{context.${products}}} %}
{% catalog_items <add_your_catalog_name> {{item.variant_id}} %}
<tr>
<th><img src="{{ items[0].variant_image_url }}" width="200" height="200" /></th>
<th align="left">
<ul style="list-style-type: none">
<li>Item: {{item.product_name}}</li>
<li>Price: {{item.price}}</li>
<li>Quantity: {{item.quantity}}</li>
</ul>
</th>
</tr>
{% endfor %}
</table>
URL de status do pedido
1
{{context.${metadata}.order_status_url}}
Personalização de mensagens
O Liquid é uma linguagem de modelagem poderosa usada pela Braze que permite criar conteúdo dinâmico e personalizado para seus clientes. Ao usar Liquid tags, você pode personalizar mensagens com base em dados do cliente, informações de produtos e outras variáveis, aprimorando a experiência de compra e impulsionando o engajamento.
Principais recursos do Liquid
- Conteúdo dinâmico: insira informações específicas do cliente, como nomes, detalhes de pedidos e preferências, em suas mensagens.
- Lógica condicional: use instruções if/else para exibir conteúdos diferentes com base em condições específicas (como localização do cliente e histórico de compras).
- Loops: itere sobre coleções de produtos ou dados de clientes para exibir listas ou grades de itens.
Primeiros passos com o Liquid
Para começar a personalizar suas mensagens usando Liquid tags, consulte os seguintes recursos:
- Referência de dados do Shopify com Liquid tags pré-definidas
- Liquid
Segmentação
Use os segmentos da Braze para criar segmentos de clientes direcionados com base em atributos e comportamentos específicos, e entregue mensagens e campanhas personalizadas. Com esse recurso poderoso, você pode engajar seus clientes de forma eficaz, alcançando o público certo com a mensagem certa no momento certo.
Para saber mais sobre como começar com segmentos, confira Sobre os segmentos da Braze.
Eventos recomendados
Os eventos de eCommerce são baseados em eventos recomendados. Como os eventos recomendados são eventos personalizados mais específicos, você pode pesquisar os nomes dos eventos recomendados de eCommerce selecionando qualquer filtro de evento personalizado.
Filtros de eCommerce
Segmente seus usuários com filtros de eCommerce, como Ecommerce Source e Total Revenue, acessando a seção eCommerce dentro do segmentador.
Para ver uma lista de filtros de eCommerce e suas definições, consulte Filtros de segmento e selecione a categoria de pesquisa “eCommerce”.


O evento de compra legado entrará em estado de descontinuação (modo de manutenção). Os eventos de compra continuarão funcionando como esperado, mas nenhuma nova funcionalidade será desenvolvida sobre eles, em favor dos eventos recomendados de eCommerce. Quando isso acontecer, os filtros de segmento não serão mais preenchidos sob o comportamento de compra.
Se você está usando eventos de compra atualmente, receberá um aviso prévio sobre os planos de descontinuação. Por enquanto, você pode continuar usando eventos de compra até a data oficial de descontinuação. Para saber mais, consulte a visão geral de eventos recomendados.
Propriedades de eventos aninhados
Para segmentar por propriedades de eventos aninhados, você pode usar as Extensões de segmento. Por exemplo, você pode usar extensões de segmento para encontrar quem comprou o produto “SKU-123” nos últimos 90 dias.
Análise de dados
Relatório de eventos personalizados
Você pode acompanhar o volume de eventos recomendados de eCommerce no Relatório de eventos personalizados. Filtre por Realizar evento personalizado e especifique o nome do evento recomendado de eCommerce para visualizar sua performance ao longo do tempo.

Dashboards
Dashboard de conversões
Depois de lançar uma campanha ou Canvas usando o evento de conversão “Places Order”, você pode criar um relatório de conversão correspondente para acompanhar a performance.

Dashboard de receita de eCommerce
Para obter insights sobre a receita atribuída à última campanha ou Canvas com que um usuário interagiu antes de fazer um pedido, use o dashboard de receita de eCommerce e selecione uma janela de conversão.
Relatório de receitas
Para analisar dados desses novos eventos, acesse o Criador de dashboard e visualize o dashboard eCommerce Revenue - Last Touch Attribution.