Eventos de compra
Esta página aborda eventos e propriedades de compra, seu uso, segmentação, onde visualizar a análise de dados relevante e muito mais.
O evento de compra legado está entrando em modo de manutenção. Clientes existentes da Braze podem continuar usando eventos de compra legados. Eles continuarão funcionando como esperado, mas novas funcionalidades serão desenvolvidas com base nos eventos recomendados de eCommerce daqui em diante. A Braze fornecerá aviso prévio bem antes de qualquer data de fim de vida ser definida. Novos clientes da Braze devem usar os eventos recomendados de eCommerce, pois os eventos de compra legados não estarão disponíveis.
Eventos de compra são ações de compra realizadas pelos seus usuários. Eles são usados para registrar compras no app e estabelecer o valor do tempo de vida (LTV) de cada perfil de usuário. Esses eventos precisam ser configurados pela sua equipe. Ao registrar eventos de compra, você pode adicionar propriedades como quantidade e tipo, o que ajuda a direcionar ainda melhor seus usuários com base nessas propriedades.
Registrar eventos de compra
Você pode registrar compras passando um objeto de compra pelo endpoint /users/track ou usando uma das nossas bibliotecas SDK listadas na seção a seguir.
As propriedades de eventos de compra usam os mesmos tipos de dados que as propriedades de eventos personalizados.
A lista a seguir mostra os métodos usados em várias plataformas para registrar compras. Nessas páginas, você também encontra documentação sobre como adicionar propriedades e quantidades ao seu evento de compra. Depois, você pode direcionar seus usuários com base nessas propriedades.
Ver dados de compra
Depois de configurar e começar a registrar eventos de compra, você pode visualizar esses dados de compra no perfil de um usuário, na guia Visão geral.
Os valores de product_id dessas compras também aparecem na página Produtos, em Configurações de dados. Lá você pode pesquisar, pré-preencher, gerenciar propriedades, colocar na lista de bloqueio ou excluir produtos.
Usar dados de compra
Você pode usar dados de compra na Braze de várias maneiras:
- Segmentação: Use dados de compra para criar Segments de usuários com base no comportamento de compra.
- Personalização: Use dados de compra para personalizar mensagens para os usuários.
- Disparar mensagens: Configure mensagens para serem disparadas com base em eventos de compra.
- Análise de dados: Analise seus dados de compra para obter insights sobre o comportamento dos usuários e a eficácia das suas Campaigns de marketing.
Segmentação
Você pode disparar qualquer número ou tipo de Campaigns de acompanhamento com base nos eventos de compra registrados. Por exemplo, você pode criar um Segment de usuários que fizeram uma compra nos últimos 30 dias ou um Segment de usuários que gastaram acima de determinado valor.
Os seguintes filtros de segmentação estão disponíveis ao direcionar usuários:
- First Made Purchase
- First Purchase For App
- Last Purchased Product
- Money Spent
- Purchased Product
- Total Number of Purchases
- X Money Spent in Y Days
- X Product Purchased in Y Days
- X Purchase Property in Y Days
- X Purchases in Last Y Days
Para obter detalhes sobre cada filtro, consulte o glossário de Filtros de segmentação e filtre por “Purchase behavior”.
Para segmentar pelo número de vezes que uma compra específica ocorreu, registre essa compra individualmente como um atributo personalizado incremental.
Personalização
Assim como qualquer outro tipo de dado que você coleta dos seus usuários, os dados de compra podem ser usados para personalizar suas mensagens com Liquid. Por exemplo, você pode enviar um e-mail personalizado recomendando produtos semelhantes aos que o usuário acabou de comprar.
Imagine que você tenha uma propriedade de evento de compra chamada last_purchased_product, que armazena o nome do último produto comprado por um usuário. Você pode usar essa propriedade para personalizar uma mensagem de e-mail assim:
{% if ${last_purchased_product} == "Running Shoes" %}
We hope you're enjoying your new running shoes! Based on your recent purchase, you might also like these running shorts and water bottles.
{% elsif ${last_purchased_product} == "Yoga Mat" %}
We hope you're enjoying your new yoga mat! Based on your recent purchase, you might also like these yoga blocks and straps.
{% else %}
Thank you for your recent purchase! We hope you're enjoying your new item.
{% endif %}
Neste exemplo, a mensagem é personalizada com base na propriedade last_purchased_product. Se o último produto comprado pelo usuário foi “Running Shoes”, ele recebe uma mensagem recomendando shorts de corrida e garrafas de água. Se o último produto foi “Yoga Mat”, ele recebe uma mensagem recomendando blocos e faixas de yoga. Se last_purchased_product tiver qualquer outro valor, ele recebe uma mensagem genérica de agradecimento.
Disparar mensagens
Um caso de uso comum é enviar automaticamente uma mensagem, como um e-mail, quando um usuário faz uma compra. Por exemplo, você pode enviar uma mensagem de agradecimento ou um código de desconto para uma compra futura.
Para isso, crie uma Campaign ou um Canvas com entrega baseada em ação e defina a ação-gatilho como Fazer compra. Você também pode especificar condições adicionais para o gatilho, como o produto comprado ou o valor da compra.
Você também pode personalizar a mensagem disparada com Liquid. No exemplo a seguir, ${purchase_product_name} é um atributo personalizado que você deve substituir pelo nome real do atributo que armazena o nome do produto comprado na sua configuração da Braze.
Thank you for your purchase of ${purchase_product_name}! As a token of our appreciation, here's a discount code for your next purchase: SAVE10
Análise de dados
Além de rastrear métricas de compra para segmentação, a Braze também registra o número de compras de cada produto e a receita gerada ao longo do tempo. Isso pode ajudar a identificar os produtos mais populares ou medir o impacto de uma Campaign promocional nas vendas.
Você encontra esses dados na página Relatório de receita.
Cálculos de receita
| Métrica | Definição |
|---|---|
| Receita do tempo de vida |
Receita vitalícia é o valor total de preço de PurchaseEvents (em USD) recebido desde o início.
|
| Valor do tempo de vida por usuário | O valor do tempo de vida (LTV) por usuário é a receita vitalícia dividida pelo total de usuários (exibido na sua página inicial). |
| Receita média diária | A receita média diária é a média da soma da receita de Campaigns e Canvas em um determinado dia. |
| Compras diárias |
As compras diárias são a média do total de PurchaseEvents únicos durante o período.
|
| Receita diária por usuário | Receita diária por usuário é a receita média diária por usuário ativo diário. |
Conversão de moeda
Quando eventos de compra são registrados em uma moeda diferente de USD, a Braze converte o valor para USD usando as taxas de câmbio do Open Exchange Rates. Essas taxas são atualizadas uma vez a cada 24 horas (por volta das 4h ET). Como as taxas de câmbio ficam em cache, pode haver pequenas diferenças em relação à taxa de mercado em tempo real, principalmente para moedas com flutuação rápida.
Cálculo da receita do tempo de vida
A Braze usa eventos de compra para calcular a receita do tempo de vida (também chamada de valor do tempo de vida ou LTV) de um usuário. Essa métrica é uma previsão do lucro líquido atribuído a todo o relacionamento futuro com um cliente. Assim, você pode tomar decisões mais embasadas sobre estratégias de aquisição e retenção de clientes.
\[\text{Valor médio de compra} = \frac{\text{Gasto total em dólares}}{\text{Número total de eventos de compra}}\]Há dois lugares principais na Braze que você pode consultar para entender o LTV dos seus usuários:
- Para métricas gerais, como Receita do tempo de vida e Valor do tempo de vida por usuário de cada app e site, consulte seu Relatório de receita.
- Para entender a receita do tempo de vida de um usuário específico, consulte o perfil de usuário dele.
Impacto dos reembolsos na receita do tempo de vida
Ao usar eventos de compra para rastrear dados de compra, você deve registrar reembolsos como um evento de compra da Braze com uma propriedade price negativa. Essa abordagem mantém o total da receita do tempo de vida preciso.
No entanto, lembre-se de que o reembolso será contado como um evento de compra adicional. Veja o exemplo a seguir. Sam faz sua primeira compra de US$ 12, mas devolve parte dela e recebe um reembolso de US$ 5. O perfil de Sam registraria:
- 1 compra com preço de US$ 12
- 1 compra com preço de -US$ 5
- Receita do tempo de vida de US$ 7
Embora Sam tenha dois eventos de compra no perfil, na realidade fez apenas uma compra. Isso é importante se você tiver Segments ou casos de uso baseados no número de compras feitas por um usuário. Reembolsos frequentes vão inflar a contagem de compras no perfil do usuário.
Propriedades de eventos de compra
Com propriedades de eventos de compra, você pode definir propriedades nas compras que podem ser usadas para qualificar ainda mais condições de gatilho, aumentar a personalização nas mensagens e gerar análises de dados mais sofisticadas por meio da exportação de dados brutos. Os tipos de valor das propriedades (string, numérico, booleano, data) variam por plataforma e geralmente são atribuídos como pares chave-valor.
As seguintes chaves são reservadas e não podem ser usadas como nomes de propriedades de eventos de compra: time, product_id, quantity, event_name, price e currency. Usar uma chave reservada no objeto properties retornará o erro “Invalid ‘properties’ field”.
Por exemplo, se você tem um aplicativo de e-commerce e deseja enviar uma mensagem a um usuário após uma compra, pode melhorar ainda mais seu público-alvo e permitir maior personalização da campanha adicionando uma propriedade de evento de compra brand_name.
Exemplo de disparo baseado em propriedades de eventos de compra:
Consulte o objeto de propriedades de compra para mais informações.
Segmentação por propriedades de eventos
A segmentação por propriedades de eventos permite direcionar usuários com base não apenas nos eventos personalizados realizados, mas também nas propriedades associadas a esses eventos. Isso adiciona opções de filtragem adicionais ao segmentar compras e eventos personalizados.
Esses filtros de segmentação incluem:
- Realizou o evento personalizado com propriedade Y com valor V X vezes nos últimos Y dias
- Fez qualquer compra com propriedade Y com valor V X vezes nos últimos Y dias
- Adiciona segmentação de 1 a 30 dias em todas as compras, eventos e propriedades dentro de compras e eventos
Diferentemente das extensões de Segment, os segmentos usados são atualizados em tempo real, suportam uma quantidade ilimitada de segmentos, oferecem um histórico retroativo de no máximo 30 dias e consomem pontos de dados. Devido à cobrança adicional de pontos de dados, você deve entrar em contato com seu CSM da Braze para ativar as propriedades de eventos para seus eventos personalizados.
Quando aprovadas, propriedades adicionais podem ser adicionadas no dashboard em Configurações de dados > Eventos personalizados selecionando Manage Properties. Você pode então usar essas propriedades de eventos na etapa de direcionamento do construtor de Campaigns ou Canvas.
When you view segmentable purchase properties in Data Settings > Products, the list displays property keys (names such as “color” or “brand”), not the actual property values (such as “red” or “Nike”).
Propriedades de entrada do Canvas e propriedades de eventos
Você pode usar as propriedades de entrada do Canvas e as propriedades de evento nas jornadas de usuário do Canvas.
As propriedades de entrada do Canvas são as propriedades que você mapeia para Canvas que são baseados em ações ou disparados por API. Note que o objeto canvas_entry_properties tem um limite máximo de tamanho de 50 KB.
Para canais de mensagem no app especificamente, context só pode ser referenciado no Canvas.
Você pode referenciar context em qualquer etapa de Mensagem com este formato Liquid: context.${property_name}. Note que os eventos devem ser eventos personalizados ou eventos de compra para serem usados dessa forma.
Caso de uso
Digamos que uma loja de varejo, RetailApp, tenha a seguinte solicitação: "context" : {"product_name" : "shoes", "product_price" : 79.99}.
A RetailApp pode puxar o nome do produto (shoes) para uma mensagem com este Liquid: {{context.${product_name}}}.
A RetailApp também pode disparar o envio de mensagens específicas para diferentes propriedades de product_name em um Canvas que direciona os usuários depois que eles acionam um evento de compra. Por exemplo, eles podem enviar mensagens diferentes para os usuários que compraram sapatos e para os usuários que compraram outra coisa, adicionando o seguinte Liquid em uma etapa de Mensagem.
{% if {{context.${product_name}}} == "shoes" %}
Your order is set to ship soon. While you're waiting, why not step up your shoe care routine with a little upgrade? Check out our selection of shoelaces and premium shoe polish.
{% else %}
Your order will be on its way shortly. If you missed something, you have until the end of the week to add more items to your cart for the same discounts.
{% endif %}
Expandir para o editor original do Canvas
Não é mais possível criar ou duplicar Canvas usando o editor original. Esta seção está disponível apenas para referência. Para os Canvas construídos com o editor original, as propriedades de entrada do Canvas podem ser referenciadas apenas na primeira etapa completa de um Canvas.
As propriedades de evento referem-se às propriedades que você define para eventos personalizados e compras. Esses event_properties podem ser usados em Campaigns com entrega baseada em ação e Canvas.
Você não pode usar event_properties na primeira etapa de Mensagem do seu Canvas. Em vez disso, você deve usar context ou adicionar uma etapa de jornadas de ação com o evento correspondente antes da etapa de Mensagem que inclui event_properties.
No Canvas, propriedades de evento personalizado e de evento de compra podem ser usadas em Liquid em qualquer etapa de Mensagem que siga uma etapa de jornadas de ação. Certifique-se de usar {{event_properties.${property_name}}} se você estiver referenciando essas propriedades de evento. Esses eventos devem ser eventos personalizados ou eventos de compra para serem usados dessa forma no componente de Mensagem.
Na primeira etapa de Mensagem que segue uma etapa de jornadas de ação, você pode usar propriedades de evento relacionadas ao evento referenciado nessa etapa. No entanto, essas propriedades de evento só podem ser usadas se o usuário realmente realizou a ação (e não foi classificado no grupo Restante do público). Você pode ter outras etapas (que não sejam outra etapa de jornadas de ação ou de Mensagem) entre essa etapa de jornadas de ação e a etapa de Mensagem.
Expandir para o editor original do Canvas
Não é mais possível criar ou duplicar Canvas usando o editor original. Esta seção está disponível apenas para referência. Para o editor original do Canvas, propriedades de evento não podem ser usadas em etapas completas agendadas. No entanto, você pode usar propriedades de evento na primeira etapa completa de um Canvas baseado em ação, mesmo que a etapa completa esteja agendada.
Consulte Propriedades de entrada do Canvas e propriedades de evento para saber mais e ver exemplos.
Registrar compras no nível do pedido
Para registrar compras no nível do pedido em vez do nível do produto, use o nome do pedido ou a categoria do pedido como product_id. Consulte nossa especificação do objeto de compra para saber mais.
Convenções de nomenclatura de Product ID
Na Braze, oferecemos algumas convenções gerais de nomenclatura para o product_id do objeto de compra. Ao escolher o product_id, a Braze sugere usar nomes simples como o nome do produto ou a categoria do produto (em vez de SKUs) com a intenção de agrupar todos os itens registrados por esse product_id.
Isso torna os produtos fáceis de identificar para segmentação e disparo.
Eventos de compra da lista de bloqueio
Ocasionalmente, você pode identificar eventos de compra que registram pontos de dados em excesso, que não são mais úteis para sua estratégia de marketing ou que foram registrados por engano. Para impedir que esses dados sejam enviados para a Braze, você pode colocar o produto na lista de bloqueio enquanto sua equipe de engenharia trabalha para removê-lo do backend do seu app ou website.
No dashboard da Braze, gerencie produtos e a lista de bloqueio na página Produtos.